Verwalten von Flottenmetriken

In diesem Thema wird gezeigt, wie Sie die AWS IoT Konsole und verwenden AWS CLI , um Ihre Flottenmetriken zu verwalten.

Verwalten von Flottenmetriken (Konsole)

In den folgenden Abschnitten wird gezeigt, wie Sie die AWS IoT Konsole verwenden, um Ihre Flottenmetriken zu verwalten. Stellen Sie sicher, dass Sie die Flottenindizierung mit den zugehörigen Datenquellen und Konfigurationen aktiviert haben, bevor Sie Flottenmetriken erstellen.

Aktivieren der Flottenindizierung

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/.

2. Wählen Sie im AWS IoT Menü Einstellungen aus.

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

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

5. 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 auszuführen.

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

Erstellen einer Flottenmetrik

1. Öffnen Sie Ihre - AWS IoT Konsole unter https://console.aws.amazon.com/iot/.

2. Wählen Sie im AWS IoT Menü Verwalten und dann Flottenmetriken aus.

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

4. 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.

5. 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 die Felder Stunden und Minuten die Zeit ein (wie oft), zu der die Flottenmetrik Daten an ausgeben soll CloudWatch.

   • Wählen Sie Weiter aus.

6. Ü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

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

2. 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.

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

Löschen einer Flottenmetrik

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

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

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

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

Verwalten von Flottenmetriken (CLI)

In den folgenden Abschnitten wird gezeigt, wie Sie AWS CLI Ihre Flottenmetriken mithilfe der verwalten. 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 oder Verwalten der Objektgruppenindizierung.

Erstellen einer Flottenmetrik

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

Sie können den list-fleet-metric CLI-Befehl verwenden, um alle Flottenmetriken 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

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

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 update-fleet-metric Befehl erzeugt keine Ausgabe. Sie können den describe-fleet-metric CLI-Befehl verwenden, um das Ergebnis anzuzeigen.

{
    "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

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.

Autorisieren des Taggings von IoT-Ressourcen

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

Um Flottenmetriken zu markieren, die Sie mit AWS Management Console oder erstellen AWS CLI, müssen Sie die -iot:TagResourceAktion in Ihre IAM-Richtlinie aufnehmen, um dem Benutzer Berechtigungen zu erteilen. 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.

Beispiele für IAM-Richtlinien

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.