# Benutzerdefinierte Metriken
Mit AWS IoT Device Defender benutzerdefinierten Metriken können Sie Kennzahlen definieren und überwachen, die für Ihre Flotte oder Ihren Anwendungsfall spezifisch sind, z. B. die Anzahl der mit Wi-Fi-Gateways verbundenen Geräte, den Ladezustand von Akkus oder die Anzahl der Netzzyklen für intelligente Steckverbinder. Benutzerdefiniertes metrisches Verhalten wird in Sicherheitsprofilen definiert, die das erwartete Verhalten für eine Gruppe von Geräten (eine Objektgruppe) oder für alle Geräte spezifizieren. Sie können das Verhalten überwachen, indem Sie Alarme einrichten, anhand derer Sie gerätespezifische Probleme erkennen und darauf reagieren können.
**Topics**
+ [
## So konfigurieren Sie benutzerdefinierte -Metriken auf der Konsole
](#dd-detect-custom-metrics-how-to-console)
+ [
## So verwenden Sie benutzerdefinierte Metriken von der CLI
](#dd-detect-custom-metrics-how-to-cli)
+ [
## CLI-Befehle für benutzerdefinierte Metriken
](#dd-detect-custom-metrics-cli-commands)
+ [
## Benutzerdefinierte Metriken-APIs
](#dd-detect-custom-metrics-apis)
## So konfigurieren Sie benutzerdefinierte -Metriken auf der Konsole
**Topics**
+ [
### AWS IoT Device Defender Agent SDK (Python)
](#dd-detect-custom-metrics-device-agent)
+ [
### Erstellen Sie eine benutzerdefinierte Metrik, und fügen Sie sie einem Sicherheitsprofil hinzu.
](#dd-detect-console-create)
+ [
### Anzeigen der Details von benutzerdefinierten Metriken
](#dd-detect-console-read)
+ [
### Aktualisieren einer benutzerdefinierten Metrik
](#dd-detect-console-edit)
+ [
### Löschen einer benutzerdefinierten Metrik
](#dd-detect-console-delete)
### AWS IoT Device Defender Agent SDK (Python)
Laden Sie zunächst den Beispielagenten des AWS IoT Device Defender Agenten SDK (Python) herunter. Der Agent erfasst die Metriken und veröffentlicht Berichte. Sobald Ihre geräteseitigen Metriken veröffentlicht wurden, können Sie sich die erfassten Messwerte ansehen und Schwellenwerte für die Einrichtung von Alarmen festlegen. Anweisungen zur Einrichtung des Device Agents finden Sie in der [Readme-Datei des AWS IoT Device Defender Agent SDK (Python)](https://github.com/aws-samples/aws-iot-device-defender-agent-sdk-python/blob/master/README.rst). Weitere Informationen finden Sie unter [AWS IoT Device Defender Agent SDK (Python)](https://github.com/aws-samples/aws-iot-device-defender-agent-sdk-python).
### Erstellen Sie eine benutzerdefinierte Metrik, und fügen Sie sie einem Sicherheitsprofil hinzu.
Das folgende Verfahren zeigt Ihnen, wie Sie eine benutzerdefinierte Metrik auf der Konsole erstellen können.
1. Erweitern Sie **Verteidigen** im Navigationsbereich der [AWS IoTKonsole](https://console.aws.amazon.com/iot), und wählen Sie dann **Detect**, **Metriken**.
1. Wählen Sie auf der Seite **Benutzerdefinierte Metriken** die Option **Erstellen**.
1. Führen Sie auf der Seite **Benutzerdefinierte Metrik erstellen** die folgenden Schritte aus:
1. Geben Sie unter **Name** einen Namen für Ihre benutzerdefinierte Metrik ein. Sie können diesen Namen nicht mehr ändern, nachdem Sie die benutzerdefinierte Metrik erstellt haben.
1. Unter **Anzeigename (optional)** können Sie einen Anzeigenamen für Ihre benutzerdefinierte Metrik eingeben. Er muss nicht eindeutig sein und kann nach der Erstellung geändert werden.
1. Wählen Sie unter **Typ** den Typ der Metrik, die Sie überwachen möchten. Zu den Metriktypen gehören **string-list**, **ip-address-list**, **number-list** und **number**. Der Typ kann nach der Erstellung nicht geändert werden.
**Anmerkung**
ML Detect erlaubt nur den Typ **number**.
1. Unter **Tags** können Sie Tags auswählen, die der Ressource zugeordnet werden sollen.
Wählen Sie abschließend **Bestätigen**.
1. Nachdem Sie Ihre benutzerdefinierte Metrik erstellt haben, wird die Seite **Benutzerdefinierte Metrik** angezeigt, auf der Sie Ihre neu erstellte benutzerdefinierte Metrik sehen können.
1. Als Nächstes müssen Sie Ihre benutzerdefinierte Metrik einem Sicherheitsprofil hinzufügen. Erweitern Sie auf der [AWS IoT-Konsole](https://console.aws.amazon.com/iot) im Navigationsbereich die Option **Verteidigen**, und wählen Sie dann **Erkennen**, **Sicherheitsprofile**.
1. Wählen Sie das Sicherheitsprofil, zu dem Sie Ihre benutzerdefinierte Metrik hinzufügen möchten.
1. Wählen Sie **Aktionen** und **Bearbeiten**.
1. Wählen Sie **Zusätzliche Metriken zum Beibehalten**, und wählen Sie dann Ihre benutzerdefinierte Metrik. Wählen Sie auf den folgenden Bildschirmen **Weiter**, bis Sie zur Seite **Bestätigen** gelangen. Wählen Sie **Speichern** und **Fortfahren**. Nachdem Ihre benutzerdefinierte Metrik erfolgreich hinzugefügt wurde, wird die Sicherheitsprofil-Detailseite angezeigt.
**Anmerkung**
Perzentil-Statistiken für Metriken sind nicht verfügbar, wenn es Metrik-Werte gibt, die negative Zahlen enthalten.
### Anzeigen der Details von benutzerdefinierten Metriken
Das folgende Verfahren zeigt Ihnen, wie Sie eine benutzerdefinierte Metrik auf der Konsole anzeigen können.
1. Erweitern Sie **Verteidigen** im Navigationsbereich der [AWS IoTKonsole](https://console.aws.amazon.com/iot), und wählen Sie dann **Detect**, **Metriken**.
1. Wählen Sie den **Metriknamen** der benutzerdefinierten Metrik, deren Details Sie anzeigen möchten.
### Aktualisieren einer benutzerdefinierten Metrik
Das folgende Verfahren zeigt Ihnen, wie Sie eine benutzerdefinierte Metrik auf der Konsole aktualisieren können.
1. Erweitern Sie **Verteidigen** im Navigationsbereich der [AWS IoTKonsole](https://console.aws.amazon.com/iot), und wählen Sie dann **Detect**, **Metriken**.
1. Wählen Sie das Optionsfeld neben der benutzerdefinierten Metrik, die Sie aktualisieren möchten. Wählen Sie dann unter **Aktionen** die Option **Bearbeiten**.
1. Auf der Seite **Benutzerdefinierte Metrik aktualisieren** können Sie den Anzeigenamen bearbeiten und Tags entfernen oder hinzufügen.
1. Klicken Sie abschließend auf **Aktualisieren**. Die Seite **Benutzerdefinierte Metriken**.
### Löschen einer benutzerdefinierten Metrik
Das folgende Verfahren zeigt Ihnen, wie Sie eine benutzerdefinierte Metrik von der Konsole löschen können.
1. Entfernen Sie zunächst Ihre benutzerdefinierte Metrik aus allen Sicherheitsprofilen, die darauf verweisen. Sie können auf der Detailseite Ihrer benutzerdefinierten Metrik sehen, welche Sicherheitsprofile Ihre benutzerdefinierte Metrik enthalten. Erweitern Sie **Verteidigen** im Navigationsbereich der [AWS IoTKonsole](https://console.aws.amazon.com/iot), und wählen Sie dann **Detect**, **Metriken**.
1. Wählen Sie die benutzerdefinierte Metrik, die Sie entfernen möchten. Entfernen Sie die benutzerdefinierte Metrik aus allen Sicherheitsprofilen, die auf der Detailseite der benutzerdefinierten Metrik unter **Sicherheitsprofile** aufgeführt sind.
1. Erweitern Sie **Verteidigen** im Navigationsbereich der [AWS IoTKonsole](https://console.aws.amazon.com/iot), und wählen Sie dann **Detect**, **Metriken**.
1. Wählen Sie das Optionsfeld neben der benutzerdefinierten Metrik, die Sie löschen möchten. Wählen Sie dann unter **Aktionen** die Option **Löschen**.
1. Wählen Sie in der Nachricht **Soll die benutzerdefinierte Metrik wirklich gelöscht werden?** die Option **Benutzerdefinierte Metrik löschen**.
**Warnung**
Nachdem Sie eine benutzerdefinierte Metrik gelöscht haben, verlieren Sie alle mit der Metrik verknüpften Daten. Diese Aktion kann nicht mehr rückgängig gemacht werden.
## So verwenden Sie benutzerdefinierte Metriken von der CLI
**Topics**
+ [
### AWS IoT Device Defender Agent SDK (Python)
](#dd-detec-custom-metrics-cli-sdk)
+ [
### Erstellen Sie eine benutzerdefinierte Metrik, und fügen Sie sie einem Sicherheitsprofil hinzu.
](#dd-detect-custom-cli-create)
+ [
### Anzeigen der Details von benutzerdefinierten Metriken
](#dd-detect-custom-cli-read)
+ [
### Aktualisieren einer benutzerdefinierten Metrik
](#dd-detect-custom-cli-edit)
+ [
### Löschen einer benutzerdefinierten Metrik
](#dd-detect-custom-cli-delete)
### AWS IoT Device Defender Agent SDK (Python)
Laden Sie zunächst den Beispielagenten des AWS IoT Device Defender Agenten SDK (Python) herunter. Der Agent erfasst die Metriken und veröffentlicht Berichte. Sobald Ihre geräteseitigen Metriken veröffentlicht wurden, können Sie sich die erfassten Metriken ansehen und Schwellenwerte für die Einrichtung von Alarmen festlegen. Anweisungen zur Einrichtung des Device Agents finden Sie in der [Readme-Datei des AWS IoT Device Defender Agent SDK (Python)](https://github.com/aws-samples/aws-iot-device-defender-agent-sdk-python/blob/master/README.rst). Weitere Informationen finden Sie unter [AWS IoT Device Defender Agent SDK (Python)](https://github.com/aws-samples/aws-iot-device-defender-agent-sdk-python).
### Erstellen Sie eine benutzerdefinierte Metrik, und fügen Sie sie einem Sicherheitsprofil hinzu.
Das folgende Verfahren zeigt Ihnen, wie Sie eine benutzerdefinierte Metrik erstellen und sie über die CLI zu einem Sicherheitsprofil hinzufügen können.
1. Verwenden Sie den Befehl `[create-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/create-custom-metric.html)`, um Ihre benutzerdefinierte Metrik zu erstellen. Im folgenden Beispiel wird eine benutzerdefinierte Metrik erstellt, die den Akkuladestand misst.
```
aws iot create-custom-metric \
--metric-name "batteryPercentage" \
--metric-type "number" \
--display-name "Remaining battery percentage." \
--region us-east-1
--client-request-token "02ccb92b-33e8-4dfa-a0c1-35b181ed26b0" \
```
Ausgabe:
```
{
"metricName": "batteryPercentage",
"metricArn": "arn:aws:iot:us-east-1:1234564789012:custommetric/batteryPercentage"
}
```
1. Nachdem Sie Ihre benutzerdefinierte Metrik erstellt haben, können Sie die benutzerdefinierte Metrik entweder mit `[update-security-profile](https://docs.aws.amazon.com/cli/latest/reference/iot/update-security-profile.html)` zu einem vorhandenen Profil hinzufügen oder mit `[create-security-profile](https://docs.aws.amazon.com/cli/latest/reference/iot/create-security-profile.html)` ein neues Sicherheitsprofil erstellen, um die benutzerdefinierte Metrik hinzuzufügen. Hier erstellen wir ein neues Sicherheitsprofil namens *BatteryUsage*, zu dem wir unsere neue benutzerdefinierte *BatteryPercentage*-Metrik hinzufügen können. Wir fügen ferner eine Rules Detect-Metrik namens *CellularBandwidth* hinzu.
```
aws iot create-security-profile \
--security-profile-name batteryUsage \
--security-profile-description "Shows how much battery is left in percentile." \
--behaviors "[{\"name\":\"great-than-75\",\"metric\":\"batteryPercentage\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"number\":75},\"consecutiveDatapointsToAlarm\":5,\"consecutiveDatapointsToClear\":1}},{\"name\":\"cellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"less-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]" \
--region us-east-1
```
Ausgabe:
```
{
"securityProfileArn": "arn:aws:iot:us-east-1:1234564789012:securityprofile/batteryUsage",
"securityProfileName": "batteryUsage"
}
```
**Anmerkung**
Perzentil-Statistiken für Metriken sind nicht verfügbar, wenn es Metrik-Werte gibt, die negative Zahlen enthalten.
### Anzeigen der Details von benutzerdefinierten Metriken
Das folgende Verfahren zeigt Ihnen, wie Sie die Details einer benutzerdefinierten Metrik in der CLI anzeigen können.
+ Verwenden Sie den Befehl `[list-custom-metrics](https://docs.aws.amazon.com/cli/latest/reference/iot/list-custom-metrics.html)`, um alle Ihre benutzerdefinierten Metriken anzuzeigen.
```
aws iot list-custom-metrics \
--region us-east-1
```
Die Ausgabe dieses Befehls sieht wie folgt aus:
```
{
"metricNames": [
"batteryPercentage"
]
}
```
### Aktualisieren einer benutzerdefinierten Metrik
Das folgende Verfahren zeigt Ihnen, wie Sie eine benutzerdefinierte Metrik in der CLI aktualisieren können.
+ Verwenden Sie den Befehl `[update-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/update-custom-metric.html)`, um eine benutzerdefinierte Metrik zu aktualisieren. Im folgenden Beispiel wird der `display-name` aktualisiert.
```
aws iot update-custom-metric \
--metric-name batteryPercentage \
--display-name 'remaining battery percentage on device' \
--region us-east-1
```
Die Ausgabe dieses Befehls sieht wie folgt aus:
```
{
"metricName": "batteryPercentage",
"metricArn": "arn:aws:iot:us-east-1:1234564789012:custommetric/batteryPercentage",
"metricType": "number",
"displayName": "remaining battery percentage on device",
"creationDate": "2020-11-17T23:01:35.110000-08:00",
"lastModifiedDate": "2020-11-17T23:02:12.879000-08:00"
}
```
### Löschen einer benutzerdefinierten Metrik
Das folgende Verfahren zeigt Ihnen, wie Sie eine benutzerdefinierte Metrik aus der CLI löschen können.
1. Um eine benutzerdefinierte Metrik zu löschen, entfernen Sie sie zunächst aus allen Sicherheitsprofilen, denen sie angefügt ist. Mit dem Befehl `[list-security-profiles](https://docs.aws.amazon.com/cli/latest/reference/iot/list-security-profiles.html)` können Sie Sicherheitsprofile mit einer bestimmten Dimension anzeigen.
1. Mit dem Befehl `[update-security-profiles](https://docs.aws.amazon.com/cli/latest/reference/iot/update-security-profiles.html)` können Sie eine Dimension aus einem Sicherheitsprofil entfernen. Geben Sie alle Informationen ein, die Sie behalten möchten, jedoch nicht die Dimension.
```
aws iot update-security-profile \
--security-profile-name batteryUsage \
--behaviors "[{\"name\":\"cellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"less-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]"
```
Die Ausgabe dieses Befehls sieht wie folgt aus:
```
{
"behaviors": [{\"name\":\"cellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"less-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}],
"securityProfileName": "batteryUsage",
"lastModifiedDate": 2020-11-17T23:02:12.879000-09:00,
"securityProfileDescription": "Shows how much battery is left in percentile.",
"version": 2,
"securityProfileArn": "arn:aws:iot:us-east-1:1234564789012:securityprofile/batteryUsage",
"creationDate": 2020-11-17T23:02:12.879000-09:00
}
```
1. Nachdem die benutzerdefinierte Metrik getrennt wurde, verwenden Sie den Befehl `[delete-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/delete-custom-metric.html)`, um die benutzerdefinierte Metrik zu löschen.
```
aws iot delete-custom-metric \
--metric-name batteryPercentage \
--region us-east-1
```
Die Ausgabe dieses Befehls sieht wie folgt aus:
```
HTTP 200
```
## CLI-Befehle für benutzerdefinierte Metriken
Mit den folgenden CLI-Befehlen können Sie benutzerdefinierte Metriken erstellen und verwalten.
+ [delete-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/create-custom-metric.html)
+ [describe-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/describe-custom-metric.html)
+ [list-custom-metrics](https://docs.aws.amazon.com/cli/latest/reference/iot/list-custom-metrics.html)
+ [delete-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/update-custom-metric.html)
+ [delete-custom-metric](https://docs.aws.amazon.com/cli/latest/reference/iot/delete-custom-metric.html)
+ [list-security-profiles](https://docs.aws.amazon.com/cli/latest/reference/iot/list-security-profiles.html)
## Benutzerdefinierte Metriken-APIs
Die folgenden APIs können verwendet werden, um benutzerdefinierte Metriken zu erstellen und zu verwalten.
+ [CreateCustomMetric](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateCustomMetric.html)
+ [DescribeCustomMetric](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeCustomMetric.html)
+ [ListCustomMetrics](https://docs.aws.amazon.com/iot/latest/apireference/API_ListCustomMetrics.html)
+ [UpdateCustomMetric](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateCustomMetric.html)
+ [DeleteCustomMetric](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteCustomMetric.html)
+ [ListSecurityProfiles](https://docs.aws.amazon.com/iot/latest/apireference/API_ListSecurityProfiles.html)