Verwalten der Flottenindizierung - AWS IoT Core
ObjektindizierungModus für die Objektgruppenindizierung.Verwaltete FelderBenutzerdefinierte Felder

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 der Flottenindizierung

Flottenindizierung verwaltet zwei Arten von Indizes für Sie: die Objektindizierung und die Objektgruppenindizierung.

Objektindizierung

AWS_Things ist der Index für all Ihre Objekte. Die Objektindizierung unterstützt die folgenden Datenquellen: AWS IoT Registrierungsdaten, AWS IoT Device Schatten-Daten, AWS IoT Konnektivitätsdaten und Daten zu AWS IoT Device DefenderVerstößen. Indem Sie diese Datenquellen zu Ihrer Flottenindexierungskonfiguration hinzufügen, können Sie nach Objekten suchen, aggregierte Daten abfragen und dynamische Objektgruppen und Flottenmetriken auf der Grundlage Ihrer Suchanfragen erstellen.

Registry —AWS IoT bietet ein Register, mit dem Sie Dinge verwalten können. Sie können die Registrierungsdaten zu Ihrer Flottenindexierungskonfiguration hinzufügen, um anhand der Objektnamen, Beschreibungen und anderen Registrierungsattributen nach Geräten zu suchen. Weitere Informationen zur -Registrierung finden Sie unter Verwalten von Aufgaben mit der -Registrierung.

Schatten — Der AWS IoT Device Schatten-Dienst bietet Schatten, mit denen Sie Ihre Gerätestatusdaten speichern können. Die Indizierung von Objekten unterstützt sowohl klassische unbenannte Schatten als auch benannte Schatten. Um benannte Schatten zu indizieren, aktivieren Sie Ihre Einstellungen für benannte Schatten und geben Sie Ihre Schattennamen in der Konfiguration für die Objektindizierung an. Standardmäßig können Sie bis zu 10 Schattennamen pro Datei hinzufügen AWS-Konto. Informationen darüber, wie Sie die Obergrenze für die Anzahl der Schattennamen erhöhen können, finden Sie in der AWS allgemeinen Referenz unter AWS IoT Device Management Kontingente.

So fügen Sie benannte Schatten für die Indizierung hinzu:

  • Wenn Sie die AWS IoT Konsole verwenden, aktivieren Sie die Objektindizierung, wählen Sie Benannte Schatten hinzufügen und fügen Sie Ihre Schattennamen über die Auswahl benannter Schatten hinzu.

  • Wenn Sie das AWS Command Line Interface (AWS CLI) verwenden, setzen Sie namedShadowIndexingMode es auf und geben Sie Schattennamen in an IndexingFilter. ON Beispiele für CLI-Befehle finden Sie unter Objektindizierung verwalten.

Wichtig

Am 20. Juli 2022 erscheint die Version General Availability (GA) der AWS IoT Device Management-Flottenindexierungsintegration mit AWS IoT Core Named Shadows und AWS IoT Device Defender Detect Violations. Mit dieser GA-Version können Sie bestimmte benannte Schatten indizieren, indem Sie Schattennamen angeben. Wenn Sie Ihre benannten Schatten während der öffentlichen Vorschauphase dieser Funktion vom 30. November 2021 bis 19. Juli 2022 für die Indizierung hinzugefügt haben, empfehlen wir Ihnen, Ihre Einstellungen für die Flottenindizierung neu zu konfigurieren und spezifische Schattennamen auszuwählen, um die Indexierungskosten zu senken und die Leistung zu optimieren.

Weitere Informationen zu Schatten finden Sie unter AWS IoT Device Schatten-Service.

Konnektivität — Mithilfe der Daten zur Gerätekonnektivität können Sie den Verbindungsstatus Ihrer Geräte ermitteln. Diese Konnektivitätsdaten werden durch Lebenszyklusereignisse bestimmt. Wenn ein Client eine Verbindung herstellt oder die Verbindung trennt, AWS IoT veröffentlicht er Lebenszyklusereignisse mit Meldungen zu MQTT-Themen. Eine Verbindungs- oder Trennungsnachricht kann eine Liste von JSON-Elementen sein, die Details zum Verbindungsstatus enthalten. Weitere Informationen zur Gerätekonnektivität finden Sie unter Lebenszyklusereignisse.

Verstöße gegen Device Defender — Daten zu AWS IoT Device Defender Verstößen helfen dabei, ungewöhnliches Geräteverhalten im Vergleich zu den normalen Verhaltensweisen zu identifizieren, die Sie in einem Sicherheitsprofil definieren. Ein Sicherheitsprofil enthält eine Reihe von Verhaltensweisen. Für jedes Verhalten wird eine Metrik verwendet, die das normale Verhalten Ihrer Geräte angibt. Weitere Informationen zu Device Defender-Verstößen finden AWS IoT Device Defender Sie unter Erkennen.

Weitere Informationen finden Sie unter Verwalten der Objektindizierung.

Modus für die Objektgruppenindizierung.

AWS_ThingGroups ist der Index, die alle Ihre Objektgruppen enthält. Dieser Index ermöglicht Ihnen die Suche nach Gruppen basierend auf Gruppennamen, Beschreibung, Attributen und allen übergeordneten Gruppennamen.

Weitere Informationen finden Sie unter Verwalten der Objektgruppenindizierung.

Verwaltete Felder

Verwaltete Felder enthalten Daten, die mit Dingen, Dinggruppen, Geräteschatten, Gerätekonnektivität und Device Defender-Verstößen verknüpft sind. AWS IoT definiert den Datentyp in verwalteten Feldern. Sie geben die Werte jedes verwalteten Felds an, wenn Sie ein AWS IoT Ding erstellen. Beispielsweise sind Objektnamen, Objektgruppen und Objektbeschreibungen alles verwaltete Felder. Der Flottenindizierungsservice indiziert verwaltete Felder basierend auf dem von Ihnen angegebenen Indizierungsmodus: Verwaltete Felder können nicht geändert oder in customFields angezeigt werden. Weitere Informationen finden Sie unter Benutzerdefinierte Felder.

Im Folgenden sind verwaltete Felder für die Indizierung von Objekten aufgeführt:

  • Verwaltete Felder für die Registrierung

    "managedFields" : [
  {name:thingId, type:String},
  {name:thingName, type:String},
  {name:registry.version, type:Number},
  {name:registry.thingTypeName, type:String},
  {name:registry.thingGroupNames, type:String},
]

  • Verwaltete Felder für klassische unbenannte Schatten

    "managedFields" : [
  {name:shadow.version, type:Number},
  {name:shadow.hasDelta, type:Boolean}
]

  • Verwaltete Felder für benannte Schatten

    "managedFields" : [
  {name:shadow.name.shadowName.version, type:Number},
  {name:shadow.name.shadowName.hasDelta, type:Boolean}
]

  • Verwaltete Felder für die Objektkonnektivität

    "managedFields" : [
  {name:connectivity.timestamp, type:Number},
  {name:connectivity.version, type:Number},
  {name:connectivity.connected, type:Boolean},
  {name:connectivity.disconnectReason, type:String}
]

  • Verwaltete Felder für Device Defender

    "managedFields" : [
  {name:deviceDefender.violationCount, type:Number},
  {name:deviceDefender.securityprofile.behaviorname.metricName, type:String},
  {name:deviceDefender.securityprofile.behaviorname.lastViolationTime, type:Number},
  {name:deviceDefender.securityprofile.behaviorname.lastViolationValue, type:String},
  {name:deviceDefender.securityprofile.behaviorname.inViolation, type:Boolean}
]

  • Verwaltete Felder für Objektgruppen

    "managedFields" : [
  {name:description, type:String},
  {name:parentGroupNames, type:String},
  {name:thingGroupId, type:String},
  {name:thingGroupName, type:String},
  {name:version, type:Number},
]

In der folgenden Tabelle sind verwaltete Felder aufgeführt, die nicht durchsucht werden können.

Datenquelle Verwaltetes Feld, das nicht durchsucht werden kann
Registrierung registry.version
Unbenannte Schatten shadow.version
Benannter Schatten shadow.name.*.version
Device Defender deviceDefender.version
Objektgruppen version

Benutzerdefinierte Felder

Sie können Objekt-Attribute, Device Schatten-Daten und Daten zu Device Defender-Verstößen aggregieren, indem Sie benutzerdefinierte Felder erstellen, um sie zu indizieren. Das Attribut customFields ist eine Liste von Feld- und Datentyppaaren. Sie können Aggregationsabfragen auf der Grundlage des Datentyps durchführen. Der von Ihnen gewählte Indizierungsmodus wirkt sich auf Felder aus, in denen Sie angeben können. customFields Wenn Sie beispielsweise den Indizierungsmodus REGISTRY angeben, können Sie kein Feld aus einem Schattenobjekt angeben. Sie können den update-indexing-configurationCLI-Befehl verwenden, um die benutzerdefinierten Felder zu erstellen oder zu aktualisieren (einen Beispielbefehl finden Sie unter Beispiele zur Aktualisierung der Indexierungskonfiguration).

  • Namen benutzerdefinierter Felder

Benutzerdefinierte Feldnamen für Objekt- und Objektgruppenattribute beginnen mit attributes., gefolgt vom Attributnamen. Wenn die unbenannte Schattenindizierung aktiviert ist, können Objekte benutzerdefinierte Feldnamen haben, die mit shadow.desired odershadow.reported beginnen, gefolgt vom Namen des unbenannten Schattendatenwerts. Wenn die benannte Schattenindizierung aktiviert ist, können Objekte benutzerdefinierte Feldnamen haben, die mit shadow.name.*.desired. oder shadow.name.*.reported. beginnen, gefolgt vom benannten Schattendatenwert. Wenn die Device Defender-Indizierung für Verstöße aktiviert ist, können Objekte benutzerdefinierte Feldnamen haben, die mit deviceDefender., gefolgt vom Datenwert Device Defender-Verletzungen beginnen.

Der Name des Attributs oder Datenwerts, der auf das Präfix folgt, darf nur aus alphanumerischen Zeichen, Bindestrichen und Unterstrichen bestehen. Er darf keine Leerzeichen enthalten.

Wenn zwischen einem benutzerdefinierten Feld in der Konfiguration und dem indizierten Wert eine Typinkonsistenz besteht, ignoriert der Flottenindizierungsservice den inkonsistenten Wert für Aggregationsabfragen. -Protokolle sind hilfreich bei der Behebung von Problemen mit Aggregationsabfragen. CloudWatch Protokolle sind hilfreich bei der Behebung von Problemen mit Aggregationsabfragen. Weitere Informationen finden Sie unter Fehlerbehebung bei Aggregationsabfragen für den Flottenindizierungsservice.

  • Benutzerdefinierte Feldtypen

Benutzerdefinierte Feldtypen haben die folgenden unterstützten Werte: NumberString, undBoolean.