

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Verwalten von Flottenmetriken
<a name="managing-fleet-metrics"></a>

In diesem Thema erfahren Sie, wie Sie die AWS IoT Konsole verwenden und AWS CLI Ihre Flottenkennzahlen verwalten.

**Topics**
+ [Verwalten von Flottenmetriken (Konsole)](#managing-fleet-metrics-console)
+ [Verwalten von Flottenmetriken (CLI)](#managing-fleet-metrics-cli)
+ [Autorisieren des Taggings von IoT-Ressourcen](#managing-fleet-metrics-policy)

## Verwalten von Flottenmetriken (Konsole)
<a name="managing-fleet-metrics-console"></a>

In den folgenden Abschnitten wird gezeigt, wie Sie die AWS IoT Konsole zur Verwaltung Ihrer Flottenkennzahlen verwenden. Stellen Sie sicher, dass Sie die Flottenindizierung mit den zugehörigen Datenquellen und Konfigurationen aktiviert haben, bevor Sie Flottenmetriken erstellen.

### Aktivieren der Flottenindizierung
<a name="setup-steps-console"></a>

Wenn Sie die Flottenindizierung bereits aktiviert haben, überspringen Sie diesen Abschnitt.

Wenn Sie die Flottenindizierung nicht aktiviert haben, folgen Sie diesen Anweisungen.

1. Öffnen Sie Ihre AWS IoT Konsole unter [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/).

1. Wählen Sie im AWS IoT Menü **Einstellungen**. 

1. Um die detaillierten Einstellungen einzusehen, scrollen Sie auf der Seite **Einstellungen** nach unten zum Abschnitt **Flottenindizierung**.

1. Um Ihre Einstellungen für die Flottenindizierung zu aktualisieren, wählen Sie rechts neben dem Abschnitt **Flottenindizierung** die Option **Indizierung verwalten** aus. 

1. Aktualisieren Sie auf der Seite **Einstellungen für die Flottenindizierung verwalten** Ihre Einstellungen für die Flottenindizierung nach Ihren Anforderungen. 
   + **Konfiguration**

     Um die Objektindizierung zu aktivieren, aktivieren Sie die **Objektindizierung** und wählen Sie dann die Datenquellen aus, für die Sie die Indizierung durchführen möchten. 

     Um die Indizierung von Objektgruppen zu aktivieren, aktivieren Sie die **Indexierung von Thing-Gruppen**.
   + **Benutzerdefinierte Felder für die Aggregation – *optional***

     Benutzerdefinierte Felder sind eine Liste von Paaren aus Feldnamen und Feldtypen. 

     Um ein benutzerdefiniertes Feldpaar hinzuzufügen, wählen Sie **Neues Feld hinzufügen**. Geben Sie einen benutzerdefinierten Feldnamen ein, wie z. B. `attributes.temperature`, und wählen Sie dann einen Feldtyp aus dem Menü **Feldtyp** aus. Beachten Sie, dass ein benutzerdefinierter Feldname mit `attributes.` beginnt und als Attribut gespeichert wird, um [Abfragen zur Aggregation von Objekten](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html) auszuführen.

     Um die Einstellung zu aktualisieren und zu speichern, wählen Sie **Aktualisieren**.

### Erstellen einer Flottenmetrik
<a name="create-fleet-metrics-console"></a>

1. Öffnen Sie Ihre AWS IoT Konsole unter [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). 

1. Wählen Sie im AWS IoT Menü **Manage** und anschließend **Fleet Metrics** aus.

1. Wählen Sie auf der Seite **Flottenmetriken** die Option **Flottenmetrik erstellen** aus und schließen Sie die Schritte zur Erstellung ab.

1. **Konfigurieren Sie in Schritt 1 Flottenmetriken**.
   + Geben Sie im Abschnitt **Abfrage** eine Abfragezeichenfolge ein, um die Objekte oder Objektgruppen anzugeben, für die Sie die Aggregatsuche durchführen möchten. Die Abfragezeichenfolge besteht aus einem Attribut und einem Wert. Wählen Sie unter **Eigenschaften** das gewünschte Attribut aus, oder geben Sie das Attribut in das Feld ein, falls es nicht in der Liste angezeigt wird. Geben Sie den Wert nach `:` ein. Ein Beispiel für eine Abfragezeichenfolge kann `thingName:TempSensor*` sein. Drücken Sie für jede eingegebene Abfragezeichenfolge die **Eingabetaste** auf Ihrer Tastatur. Wenn Sie mehrere Abfragezeichenfolgen eingeben, geben Sie deren Beziehung an, indem Sie **und**, **oder** **und nicht** oder **oder nicht** auswählen. 
   + Wählen Sie in den **Berichtseigenschaften** **Indexname**, **Aggregationstyp** und **Aggregationsfeld** aus den jeweiligen Listen aus. Wählen Sie als Nächstes unter **Daten auswählen** die Daten aus, die Sie aggregieren möchten. Sie können dabei mehrere Datenwerte auswählen.
   + Wählen Sie **Weiter** aus.

1. **Geben Sie in Schritt 2 die Eigenschaften der Flottenmetrik an**.
   + Geben Sie im Feld **Name der Flottenmetrik** einen Namen für die Flottenmetrik ein, die Sie erstellen.
   + Geben Sie im Feld **Beschreibung – *optional*** eine Beschreibung für die Flottenmetrik ein, die Sie erstellen. Dies ist ein optionales Feld. 
   + Geben Sie in den Feldern **Stunden** und **Minuten** die Uhrzeit (wie oft) ein, zu der die Flottenkennzahl Daten senden soll CloudWatch.
   + Wählen Sie **Weiter** aus.

1. **Überprüfen und Erstellen Sie Ihre Metrik in Schritt 5**.
   + Überprüfen Sie die Einstellungen aus Schritt 1 und Schritt 2. Zum Bearbeiten der Einstellungen wählen Sie **Bearbeiten**.
   + Wählen Sie **Flottenmetrik erstellen** aus.

Nach erfolgreicher Erstellung wird die Flottenmetrik auf der Seite **Flottenmetrik** aufgeführt.

### Aktualisieren einer Flottenmetrik
<a name="update-fleet-metrics-console"></a>

1. Wählen Sie auf der Seite **Flottenmetrik** die Flottenmetrik aus, die Sie aktualisieren möchten.

1. Klicken Sie auf der Seite **Details** auf **Bearbeiten**. Dadurch werden die Schritte zur Erstellung geöffnet, in denen Sie Ihre Flottenmetrik in einem der drei Schritte aktualisieren können. 

1. Nachdem Sie die Aktualisierung der Flottenmetrik abgeschlossen haben, wählen Sie **Flottenmetrik aktualisieren** aus.

### Löschen einer Flottenmetrik
<a name="delete-fleet-metrics-console"></a>

1. Wählen Sie auf der Seite **Flottenmetrik** die Flottenmetrik aus, die Sie löschen möchten.

1. Wählen Sie auf der nächsten Seite, auf der Details zu Ihrer Flottenmetrik angezeigt werden, **Löschen** aus.

1. Geben Sie im Dialogfeld den Namen Ihrer Flottenmetrik ein, um das Löschen zu bestätigen.

1. Wählen Sie **Löschen** aus. In diesem Schritt wird Ihre Flottenmetrik dauerhaft gelöscht.

## Verwalten von Flottenmetriken (CLI)
<a name="managing-fleet-metrics-cli"></a>

In den folgenden Abschnitten wird gezeigt, wie Sie mit AWS CLI dem Ihre Flottenkennzahlen verwalten können. Stellen Sie sicher, dass Sie die Flottenindizierung mit den zugehörigen Datenquellen und Konfigurationen aktiviert haben, bevor Sie Flottenmetriken erstellen. Um die Flottenindizierung für Ihre Objekte oder Objektgruppen zu aktivieren, folgen Sie den Anweisungen unter [Verwalten der Objektindizierung](managing-index.md#enable-index) oder [Verwalten der Objektgruppenindizierung](thinggroup-index.md#enable-group-index).

### Erstellen einer Flottenmetrik
<a name="create-fleet-metrics"></a>

Sie können den create-fleet-metric CLI-Befehl verwenden, um eine Flottenmetrik zu erstellen. 

```
aws iot create-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 60 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum
```

Die Ausgabe dieses Befehls enthält den Namen und den Amazon-Ressourcennamen (ARN) Ihrer Flottenmetrik. Die Ausgabe sollte wie folgt aussehen:

```
{
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "metricName": "YourFleetMetricName"
}
```

### Auflisten von Flottenmetriken
<a name="list-fleet-metrics"></a>

Sie können den list-fleet-metric CLI-Befehl verwenden, um alle Flottenkennzahlen in Ihrem Konto aufzulisten. 

```
aws iot list-fleet-metrics
```

Die Ausgabe dieses Befehls enthält alle Flottenmetriken. Die Ausgabe sollte wie folgt aussehen:

```
{
    "fleetMetrics": [
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric1", 
            "metricName": "YourFleetMetric1"
        }, 
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric2", 
            "metricName": "YourFleetMetric2"
        }
    ]
}
```

### Beschreiben einer Flottenmetrik
<a name="describe-fleet-metrics"></a>

Sie können den describe-fleet-metric CLI-Befehl verwenden, um detailliertere Informationen zu einer Flottenmetrik anzuzeigen. 

```
aws iot describe-fleet-metric --metric-name "YourFleetMetricName"
```

Die Ausgabe des Befehls enthält detaillierte Informationen über die angegebene Flottenmetrik. Die Ausgabe sollte wie folgt aussehen:

```
{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625790642.355, 
    "queryString": "*", 
    "period": 60, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 1, 
    "aggregationType": {
        "values": [
            "sum"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625790642.355, 
    "metricName": "YourFleetMetricName"
}
```

### Aktualisieren einer Flottenmetrik
<a name="update-fleet-metrics"></a>

Sie können den update-fleet-metric CLI-Befehl verwenden, um eine Flottenmetrik zu aktualisieren. 

```
aws iot update-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 120 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum,count --index-name AWS_Things
```

Der Befehl update-fleet-metric erzeugt keine Ausgabe. Sie können den describe-fleet-metric CLI-Befehl verwenden, um das Ergebnis zu sehen.

```
{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625792300.881, 
    "queryString": "*", 
    "period": 120, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 2, 
    "aggregationType": {
        "values": [
            "sum", 
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625792300.881, 
    "metricName": "YourFleetMetricName"
}
```

### Löschen einer Flottenmetrik
<a name="delete-fleet-metrics"></a>

Verwenden Sie den delete-fleet-metric CLI-Befehl, um eine Flottenmetrik zu löschen. 

```
aws iot delete-fleet-metric --metric-name "YourFleetMetricName"
```

Dieser Befehl erzeugt keine Ausgabe, wenn das Löschen erfolgreich ist oder wenn Sie eine Flottenmetrik angeben, die nicht existiert.

Weitere Informationen finden Sie unter [Problembehebung bei Flottenmetriken](fleet-indexing-troubleshooting.md#fleet-metrics-troubleshooting).

## Autorisieren des Taggings von IoT-Ressourcen
<a name="managing-fleet-metrics-policy"></a>

Für eine bessere Kontrolle über Flottenmetriken, die Sie erstellen, ändern oder verwenden, können Sie den Flottenmetriken Tags hinzufügen.

Um Flottenkennzahlen zu taggen, die Sie mithilfe von AWS-Managementkonsole oder erstellen AWS CLI, müssen Sie die `iot:TagResource` Aktion in Ihre IAM-Richtlinie aufnehmen, um den Benutzern Berechtigungen zu gewähren. Wenn Ihre IAM-Richtlinie `iot:TagResource` nicht beinhaltet, wird bei allen Aktionen zur Erstellung einer Flottenmetrik mit einem Tag ein Fehler `AccessDeniedException` zurückgegeben.

Weitere allgemeine Informationen zum Taggen von Ressourcen finden Sie unter [Markieren Ihrer AWS IoT -Ressourcen](https://docs.aws.amazon.com//iot/latest/developerguide/tagging-iot.html).

### Beispiele für IAM-Richtlinien
<a name="managing-fleet-metrics-policy-example"></a>

Sehen Sie sich das folgende Beispiel für eine IAM-Richtlinie an, in dem Tagging-Berechtigungen gewährt werden, wenn Sie eine Flottenmetrik erstellen:

****  

```
{
	"Version":"2012-10-17",		 	 	 
	"Statement": [
		{
			"Action": [
				"iot:TagResource"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		},
		{
			"Action": [
				"iot:CreateFleetMetric"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:index/*",
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		}
	]
}
```

Weitere Informationen finden Sie unter [Aktionen, Ressourcen und Bedingungsschlüssel für AWS IoT](https://docs.aws.amazon.com//service-authorization/latest/reference/list_awsiot.html).