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](preparing-to-use-software-package-catalog.md#reserved-named-shadow) und [dynamische](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html) 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\$1sensor). Weitere Informationen finden Sie unter [Flottenindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/iot-indexing.html).
## 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](https://console.aws.amazon.com/iot/home) 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](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#thing-index).
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.
**Anmerkung**
Die Aktivierung der Flottenindizierung für den Softwarepaket-Katalog verursacht Standard-Servicekosten. Weitere Informationen finden Sie unter [AWS IoT Device Management-Preisgestaltung](https://aws.amazon.com/iot-device-management/pricing/).
## In der Konsole dargestellte Metriken
![\[Bild mit Standardmetriken\]](http://docs.aws.amazon.com/de_de/iot/latest/developerguide/images/package-catalog-discovery-metrics.png)
Auf der Detailseite des AWS IoT Konsolen-Softwarepakets werden im **Discovery-Bereich** Standardmetriken angezeigt, die über den `$package` Shadow aufgenommen wurden.
+ Das Diagramm zur **Verteilung der aktuellen Version** zeigt die Anzahl der Geräte und den Prozentsatz aller Geräte, die diesem Softwarepaket zugeordnet sind, für die 10 neuesten Paketversionen, die einer AWS IoT Sache zugeordnet sind. **Hinweis:** Wenn das Softwarepaket mehr Paketversionen als die in der Tabelle angegebenen enthält, finden Sie diese unter **Andere** gruppiert.
+ Das **Verlaufsdiagramm** zeigt die Anzahl der Geräte, die den ausgewählten Paketversionen über einen bestimmten Zeitraum zugeordnet sind. Das Diagramm ist zunächst leer, bis Sie bis zu 5 Paketversionen auswählen und den Datumsbereich und das Zeitintervall definieren. Um die Parameter des Diagramms auszuwählen, wählen Sie **Einstellungen**. Die im **Verlaufsdiagramm** angezeigten Daten unterscheiden sich möglicherweise vom **Verteilungsdiagramm der aktuellen Version**. Dies liegt an der unterschiedlichen Anzahl der angezeigten Paketversionen und auch daran, dass Sie im **Verlaufsdiagramm** auswählen können, welche Paketversionen analysiert werden sollen. **Hinweis:** Wenn Sie eine Paketversion zur Visualisierung auswählen, wird diese auf die maximale Anzahl von Flottenkennzahlen angerechnet. Weitere Informationen finden Sie unter [Flottenindizierungsgrenzen und -quoten](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits).
Eine weitere Methode, um einen Einblick in die Erfassung der Paketversionsverteilung zu erhalten, finden Sie unter [Erfassung der Paketversionsverteilung durch `getBucketsAggregation`](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-fleet-indexing.html#package-version-distribution).
## Abfragemuster
Die Flottenindizierung mit dem Softwarepaketkatalog verwendet die meisten unterstützten Standardfunktionen (wie Begriffe, Ausdrücke und Suchfelder). Vergleichsoperatoren (z. B. kleiner als `<` und größer als`>`) und `range` Abfragen sind jedoch für den reservierten benannten `version` Shadow-Schlüssel (`$package`) nicht verfügbar. Diese Abfragen sind für den `attributes` Schlüssel verfügbar. Weitere Informationen finden Sie unter [Abfragesyntax](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html).
### Beispiel für Daten
**Hinweis:** Informationen zum reservierten benannten Schatten und seiner Struktur finden Sie unter [Reservierter benannter Schatten](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-to-use-software-package-catalog.html#reserved-named-shadow).
In diesem Beispiel wird ein erstes Gerät `AnyThing` benannt und es sind die folgenden Pakete installiert:
+ Softwarepaket: `SamplePackage`
Paketversion: `1.0.0`
Paket-ID: `1111`
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:
+ Softwarepaket: `SamplePackage`
Paketversion: `1.0.0`
Paket-ID: `1111`
+ Softwarepaket: `OtherPackage`
Paketversion: `1.2.5`
Paket-ID: `2222`
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](https://docs.aws.amazon.com/iot/latest/developerguide/example-queries.html).
**Aktuelle Version von AWS IoT Device Tester for freeRTOS**
| **Angeforderte Informationen** | **Abfrage** | **Ergebnis** |
| --- | --- | --- |
| Objekte, auf denen eine bestimmte Paketversion installiert ist | `shadow.name.$package.reported.SamplePackage.version:1.0.0` | `AnyThing`, `OtherThing` |
| Objekte, auf denen keine bestimmte Paketversion installiert ist | `NOT shadow.name.$package.reported.OtherPackage.version:1.2.5` | `AnyThing` |
| Jedes Gerät, das eine Paketversion verwendet, deren Paket-ID größer als 1500 ist | `shadow.name.$package.reported.*.attributes.packageID>1500"` | `OtherThing` |
| Objekte, auf denen ein bestimmtes Paket installiert ist und auf denen mehr als ein Paket installiert ist | `shadow.name.$package.reported.SamplePackage.version:1.0.0 AND shadow.name.$package.reported.totalCount:2` | `OtherThing` |
## Sammeln der Paketversion und Verteilung über `getBucketsAggregation`
Zusätzlich zum **Discovery-Bereich** in der AWS IoT Konsole können Sie mithilfe der [https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html](https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html)API-Operation auch Informationen zur Verteilung der Paketversion abrufen. Um die Distributionsinformationen der Paketversion zu erhalten, gehen Sie wie folgt vor:
+ Definieren Sie in der Flottenindizierung für jedes Softwarepaket ein benutzerdefiniertes Feld. **Hinweis:** Die Erstellung benutzerdefinierter Felder wird auf die [AWS IoT Service Quotas für die Flottenindexierung](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits) angerechnet.
+ Formatieren Sie das benutzerdefinierte Feld wie folgt:
`shadow.name.$package.reported..version`
Weitere Informationen finden Sie im Abschnitt [Benutzerdefinierte Felder](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#custom-field) in der AWS IoT Flottenindizierung.