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.

Vorbereitung der Flottenindizierung

Mit der AWS IoT Flottenindizierung können Sie Daten suchen und aggregieren, indem Sie den reservierten Namen shadow () verwenden. $package Sie können AWS IoT Dinge auch gruppieren, indem Sie die Reservierter benannter Schatten und dynamische Dinggruppen abfragen. Sie können beispielsweise Informationen darüber finden, welche AWS IoT Dinge eine bestimmte Paketversion verwenden, für die keine bestimmte Paketversion installiert ist oder für die keine Paketversion installiert ist. Sie können weitere Erkenntnisse gewinnen, indem Sie Attribute kombinieren. Zum Beispiel die Identifizierung von Objekten, die eine bestimmte Version und einen bestimmten Objekttyp haben (wie Version 1.0.0 und den Objekttyp pump_sensor). Weitere Informationen finden Sie unter Flottenindizierung.

Den $package Schatten als Datenquelle festlegen

Um die Flottenindizierung mit dem Softwarepaket-Katalog zu verwenden, müssen Sie die Flottenindizierung aktivieren, den benannten Schatten als Datenquelle festlegen und $package als benannten Schattenfilter definieren. Wenn Sie die Flottenindizierung nicht aktiviert haben, können Sie sie im Rahmen dieses Vorgangs aktivieren. Öffnen Sie von AWS IoT Core in der Konsole Einstellungen, wählen Sie Indizierung verwalten, dann Benannte Schatten hinzufügen, Gerätesoftwarepakete und -versionen hinzufügen und Aktualisieren. Weitere Informationen finden Sie unter Verwalten der Objektindizierung.

Alternativ können Sie die Flottenindizierung aktivieren, wenn Sie Ihr erstes Paket erstellen. Wenn das Dialogfeld Abhängigkeiten für die Paketverwaltung aktivieren angezeigt wird, wählen Sie die Option, Gerätesoftwarepakete und -versionen als Datenquellen zur Flottenindizierung hinzuzufügen. Durch Auswahl dieser Option aktivieren Sie auch die Flottenindizierung.

In der Konsole dargestellte Metriken

Auf der Detailseite des AWS IoT Konsolen-Softwarepakets werden im Discovery-Bereich Standardmetriken angezeigt, die über den $package Shadow aufgenommen wurden.

Eine weitere Methode, um einen Einblick in die Erfassung der Paketversionsverteilung zu erhalten, finden Sie unter Erfassung der Paketversionsverteilung durch getBucketsAggregation.

Abfragemuster

Die Flottenindizierung mit dem Softwarepaket-Katalog verwendet die meisten der unterstützten Funktionen (z. B. Begriffe und Ausdrücke und Suchfelder), die für die Flottenindizierung Standard sind. Die Ausnahme ist, dass die Abfragen comparison und range für den reservierten benannten Schattenschlüssel ($package) version nicht verfügbar sind. Diese Abfragen sind jedoch für den attributes Schlüssel verfügbar. Weitere Informationen finden Sie unter Abfragesyntax.

Beispiel für Daten

Hinweis: Informationen zum reservierten benannten Schatten und seiner Struktur finden Sie unter Reservierter benannter Schatten.

In diesem Beispiel wird ein erstes Gerät AnyThing benannt und es sind die folgenden Pakete installiert:

Der Schatten sieht wie folgt aus:

{
    "state": {
        "reported": {
            "SamplePackage": {
                "version": "1.0.0",
                "attributes": {
                    "s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
                    "packageID": "1111"
                    }
            }
        }
    }
}

Ein zweites Gerät wird AnotherThing benannt und hat das folgende Paket installiert:

Der Schatten sieht wie folgt aus:

{
    "state": {
        "reported": {
            "SamplePackage": {
                "version": "1.0.0",
                "attributes": {
                    "s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
                    "packageID": "1111"
                }
            },
            "OtherPackage": {
                "version": "1.2.5",
                "attributes": {
                    "s3UrlForOtherPackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile2",
                    "packageID": "2222"
                    }
            },
        }
    }
}

Beispielabfragen

In der folgenden Tabelle sind Beispielabfragen aufgeführt, die auf den Geräteschatten für AnyThing und AnotherThing basieren. Weitere Informationen finden Sie unter Beispiel-Objektabfragen.

Sammeln der Paketversion und Verteilung über getBucketsAggregation

Zusätzlich zum Discovery-Bereich in der AWS IoT Konsole können Sie mithilfe des GetBucketsAggregationAPIVorgangs auch Informationen zur Verteilung der Paketversion abrufen. Um die Distributionsinformationen der Paketversion zu erhalten, gehen Sie wie folgt vor:

Weitere Informationen finden Sie im Abschnitt Benutzerdefinierte Felder in der AWS IoT Flottenindizierung.