Ereignisse im Lebenszyklus - AWS IoT Core

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.

Ereignisse im Lebenszyklus

AWS IoT kann Lebenszyklusereignisse zu den MQTT-Themen veröffentlichen. Diese Ereignisse stehen standardmäßig zur Verfügung und können nicht deaktiviert werden.

Anmerkung

Nachrichten zum Lebenszyklus können ohne feste Reihenfolge gesendet werden. Unter Umständen erhalten Sie einzelne Nachrichten auch mehrfach.

„Verbinden/Verbindung trennen“-Ereignisse

Anmerkung

Mit der AWS IoT Device Management-Flottenindizierung können Sie nach Dingen suchen, aggregierte Abfragen ausführen und dynamische Gruppen auf der Grundlage von Connect/Disconnect-Ereignissen für Dinge erstellen. Weitere Informationen finden Sie unter Flottenindizierung.

AWS IoT veröffentlicht eine Nachricht zu den folgenden MQTT-Themen, wenn ein Client eine Verbindung herstellt oder trennt:

  • $aws/events/presence/connected/clientId: Ein Client, der mit dem Message Broker verbunden ist.

  • $aws/events/presence/disconnected/clientId: Ein Client, dessen Verbindung mit dem Message Broker getrennt wurde

Die nachfolgende Liste enthält JSON-Elemente, die in „Verbinden/Verbindung trennen“-Nachrichten enthalten sind, die an das Topic $aws/events/presence/connected/clientId gesendet werden.

clientId

Die Client-ID des Clients, der eine Verbindung herstellt oder trennt

Anmerkung

Client-IDs, die „#“ oder „+“ enthalten, empfangen keine Ereignisse zum Lebenszyklus.

Klient InitiatedDisconnect

„True“, wenn der Client die Verbindungstrennung initiiert hat. Ansonsten „false”. Nur in Trennungsnachrichten.

disconnectReason

Der Grund, warum der Client die Verbindung trennt. Nur in Trennungsnachrichten. Die folgende Tabelle enthält gültige Werte und gibt an, ob der Broker beim Verbindungsabbruch Last Will and Testament (LWT)-Nachrichten sendet.

Grund für das Trennen der Verbindung Beschreibung Der Broker sendet die LWT-Nachrichten
AUTH_ERROR Der Client konnte sich nicht authentifizieren, oder die Autorisierung ist fehlgeschlagen. Ja. Wenn das Gerät vor dem Empfang dieses Fehlers über eine aktive Verbindung verfügt.
CLIENT_INITIATED_DISCONNECT Der Client gibt an, dass die Verbindung getrennt wird. Der Client kann dies tun, indem er entweder ein DISCONNECT MQTT-Steuerpaket sendet oder Close frame ob der Client eine WebSocket Verbindung verwendet. Nein.
CLIENT_ERROR Der Client hat etwas falsch gemacht, das dazu führt, dass die Verbindung getrennt wird. Beispielsweise wird ein Client getrennt, wenn mehr als ein MQTT CONNECT-Paket auf derselben Verbindung gesendet wird, oder wenn der Client versucht, mit einer Nutzlast zu veröffentlichen, die das Nutzlast-Limit überschreitet. Ja.
CONNECTION_LOST Die Client-Server-Verbindung wird unterbrochen. Dies kann während eines Zeitraums mit hoher Netzwerklatenz geschehen, oder wenn die Internetverbindung unterbrochen wird. Ja.
DUPLICATE_CLIENTID Der Client verwendet eine Client-ID, die bereits verwendet wird. In diesem Fall wird der Client, der bereits verbunden ist, mit diesem Trenngrund getrennt. Ja.
FORBIDDEN_ACCESS Der Client darf keine Verbindung herstellen. So kann ein Client beispielsweise mit einer abgelehnten IP-Adresse keine Verbindung herstellen. Ja. Wenn das Gerät vor dem Empfang dieses Fehlers über eine aktive Verbindung verfügt.
MQTT_KEEP_ALIVE_TIMEOUT Wenn es für das 1,5-fache der Keepalive-Zeit des Clients keine Client-Server-Kommunikation gibt, wird der Client getrennt. Ja.
SERVER_ERROR Trennung der Verbindung aufgrund unerwarteter Serverprobleme. Ja.
SERVER_INITIATED_DISCONNECT Der Server trennt einen Client aus betrieblichen Gründen absichtlich. Ja.
THROTTLED Der Client wird getrennt, weil er ein Drosselungslimit überschritten hat. Ja.
WEBSOCKET_TTL_EXPIRATION Die Verbindung mit dem Client wird unterbrochen, weil die Verbindung mit a WebSocket länger dauert als sein time-to-live Wert. Ja.
CUSTOMAUTH_TTL_EXPIRATION Die Verbindung zum Client wurde unterbrochen, weil die Verbindung länger dauert als der time-to-live Wert seines benutzerdefinierten Autorisierers. Ja.
eventType

Der Ereignistyp. Gültige Werte sind connected oder disconnected.

ipAddress

Die IP-Adresse des verbindenden Clients. Diese kann im IPv4- oder IPv6-Format vorliegen. Nur in Verbindungsnachrichten.

principalIdentifier

Die zur Anmeldung verwendeten Anmeldeinformationen. Für gegenseitige TLS-Authentifizierungszertifikate ist dies die Zertifikat-ID. Für andere Verbindungsarten sind dies die IAM-Anmeldeinformationen.

sessionIdentifier

Ein global eindeutiger Bezeichner AWS IoT , der für die Dauer der Sitzung existiert.

Zeitstempel

Eine ungefähre Schätzung, wann das Ereignis eingetreten ist.

versionNumber

Die Versionsnummer für das Lebenszyklusereignis. Dies ist ein monoton ansteigender langer Ganzzahlwert für jede Client-ID-Verbindung. Die Versionsnummer kann von einem Abonnenten verwendet werden, um die Reihenfolge der Lebenszyklusereignisse festzustellen.

Anmerkung

Die Verbindungs- und Trennungsnachrichten für eine Client-Verbindung haben dieselbe Versionsnummer.

Die Versionsnummer kann Werte überspringen und wird nicht zwingend konsistent für jedes Ereignis um 1 erhöht.

Wenn ein Client etwa eine Stunde lang nicht verbunden ist, wird die Versionsnummer auf 0 zurückgesetzt. Bei persistenten Sitzungen wird die Versionsnummer auf 0 zurückgesetzt, nachdem ein Client länger als die für die persistente Sitzung konfigurierte Verbindung time-to-live (TTL) getrennt wurde.

Eine Verbindungsnachricht hat die folgende Struktur.

{ "clientId": "186b5", "timestamp": 1573002230757, "eventType": "connected", "sessionIdentifier": "a4666d2a7d844ae4ac5d7b38c9cb7967", "principalIdentifier": "12345678901234567890123456789012", "ipAddress": "192.0.2.0", "versionNumber": 0 }

Eine Trennungsnachricht hat die folgende Struktur.

{ "clientId": "186b5", "timestamp": 1573002340451, "eventType": "disconnected", "sessionIdentifier": "a4666d2a7d844ae4ac5d7b38c9cb7967", "principalIdentifier": "12345678901234567890123456789012", "clientInitiatedDisconnect": true, "disconnectReason": "CLIENT_INITIATED_DISCONNECT", "versionNumber": 0 }

Umgang mit Client-Verbindungstrennungen

Es ist eine bewährte Methode, für Lebenszyklusereignisse (einschließlich Last Will and Testament (LWT)-Nachrichten) stets einen implementierten Wartestatus zu verwenden. Wenn eine getrennte Verbindung signalisiert wird, sollte Ihr Code eine gewisse Zeit warten und überprüfen, ob ein Gerät noch offline ist, bevor Maßnahmen ergriffen werden. Eine Möglichkeit dazu ist das Verwenden von SQS-Verzögerungswarteschlangen. Wenn ein Client ein LWT- oder Lebenszyklusereignis erhält, können Sie eine Nachricht für (beispielsweise) ca. 5 Sekunden in eine Warteschlange stellen. Wenn die Nachricht verfügbar ist und verarbeitet wird (durch Lambda oder einen anderen Service), können Sie zunächst überprüfen, ob das Gerät immer noch offline ist, bevor Sie zu weiteren Maßnahmen greifen.

„Abonnieren/Abonnement beenden“-Ereignisse

AWS IoT veröffentlicht eine Nachricht zum folgenden MQTT-Thema, wenn ein Client ein MQTT-Thema abonniert oder abbestellt:

$aws/events/subscriptions/subscribed/clientId

or

$aws/events/subscriptions/unsubscribed/clientId

Hierbei ist clientId die MQTT-Client-ID, über die eine Verbindung zum AWS IoT Message Broker hergestellt wird.

Die im Topic veröffentlichte Nachricht weist die folgende Struktur auf:

{ "clientId": "186b5", "timestamp": 1460065214626, "eventType": "subscribed" | "unsubscribed", "sessionIdentifier": "00000000-0000-0000-0000-000000000000", "principalIdentifier": "000000000000/ABCDEFGHIJKLMNOPQRSTU:some-user/ABCDEFGHIJKLMNOPQRSTU:some-user", "topics" : ["foo/bar","device/data","dog/cat"] }

Die nachfolgende Liste enthält JSON-Elemente, die in „Abonnieren/Abonnement abbestellen“-Nachrichten enthalten sind, die an die Topics $aws/events/subscriptions/subscribed/clientId und $aws/events/subscriptions/unsubscribed/clientId gesendet werden.

clientId

Die Client-ID des Clients, der ein Topic abonniert oder das Abonnement abbestellt.

Anmerkung

Client-IDs, die „#“ oder „+“ enthalten, empfangen keine Ereignisse zum Lebenszyklus.

eventType

Der Ereignistyp. Gültige Werte sind subscribed oder unsubscribed.

principalIdentifier

Die zur Anmeldung verwendeten Anmeldeinformationen. Für gegenseitige TLS-Authentifizierungszertifikate ist dies die Zertifikat-ID. Für andere Verbindungsarten sind dies die IAM-Anmeldeinformationen.

sessionIdentifier

Ein global eindeutiger Bezeichner AWS IoT , der für die Dauer der Sitzung existiert.

Zeitstempel

Eine ungefähre Schätzung, wann das Ereignis eingetreten ist.

topics

Ein Array der vom Client abonnierten MQTT-Topics.

Anmerkung

Nachrichten zum Lebenszyklus können ohne feste Reihenfolge gesendet werden. Unter Umständen erhalten Sie einzelne Nachrichten auch mehrfach.