Message Broker-Protokolleinträge OCSP-Protokolleinträge des Serverzertifikats Protokolleinträge „Geräteschatten“Protokolleinträge zur Regel-Engine Auftrag-Protokolleinträge Protokolleinträge für Gerätebereitstellung Protokolleinträge „Dynamische Objektgruppen“Protokolleinträge für die Flottenindizierung Allgemeine CloudWatch Log-Attribute

CloudWatch Protokolle AWS IoT Einträge protokollieren

Jede Komponente von AWS IoT generiert ihre eigenen Protokolleinträge. Jeder Protokolleintrag besitzt einen eventType, der die Operation angibt, die den Protokolleintrag generiert hat. In diesem Abschnitt werden die Protokolleinträge beschrieben, die von den folgenden AWS IoT -Komponenten generiert werden.

Themen

Message Broker-Protokolleinträge
OCSP-Protokolleinträge des Serverzertifikats
Protokolleinträge „Geräteschatten“
Protokolleinträge zur Regel-Engine
Auftrag-Protokolleinträge
Protokolleinträge für Gerätebereitstellung
Protokolleinträge „Dynamische Objektgruppen“
Protokolleinträge für die Flottenindizierung
Allgemeine CloudWatch Log-Attribute

Message Broker-Protokolleinträge

Der AWS IoT Message Broker generiert Logeinträge für die folgenden Ereignisse:

Protokolleintrag „Connect“

Der AWS IoT Message Broker generiert einen Logeintrag mit einem eventType von, Connect wenn ein MQTT-Client eine Verbindung herstellt.

Beispiel für den Protokolleintrag „Connect“


{
    "timestamp": "2017-08-10 15:37:23.476",
    "logLevel": "INFO",
    "traceId": "20b23f3f-d7f1-feae-169f-82263394fbdb",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "Connect",
    "protocol": "MQTT",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten Connect Logeinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
Protokoll: Das für die Anforderung verwendete Protokoll. Gültige Werte sind MQTT oder HTTP.
sourceIp: Die IP-Adresse, von der die Anforderung stammt.
sourcePort: Der Port, von dem die Anforderung stammt.

Protokolleintrag „Disconnect“

Der AWS IoT Message Broker generiert einen Logeintrag mit einem oder, Disconnect wenn ein eventType MQTT-Client die Verbindung trennt.

Beispiel für den Protokolleintrag „Disconnect“


{
    "timestamp": "2017-08-10 15:37:23.476",
    "logLevel": "INFO",
    "traceId": "20b23f3f-d7f1-feae-169f-82263394fbdb",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "Disconnect",
    "protocol": "MQTT",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490,
    "reason": "DUPLICATE_CLIENT_ID",
    "details": "A new connection was established with the same client ID",
    "disconnectReason": "CLIENT_INITIATED_DISCONNECT"
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten Disconnect Logeinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
Protokoll: Das für die Anforderung verwendete Protokoll. Gültige Werte sind MQTT oder HTTP.
sourceIp: Die IP-Adresse, von der die Anforderung stammt.
sourcePort: Der Port, von dem die Anforderung stammt.
Grund: Der Grund, warum der Client die Verbindung trennt.
Details: Eine kurze Erläuterung des Fehlers.
disconnectReason: Der Grund, warum der Client die Verbindung trennt.

Ping-Logeintrag

Der AWS IoT Message Broker generiert einen Logeintrag mit einem eventType oder, Ping wenn er einen MQTT-PINGREQ von einem verbundenen Client verarbeitet und den entsprechenden PINGRESP sendet. Pro Ping-Vorgang wird ein einzelner Logeintrag ausgegeben.

Wichtig

Ping-Logeinträge sind standardmäßig aktiviert und deaktiviert. Der Emissionsschwellenwert entspricht dem Ergebnis pro Eintrag: Erfolgseinträge werden auf der DEBUG Ebene ausgegeben und Fehlereinträge werden auf der ERROR Ebene ausgegeben. Daher werden immer dann Ping-Fehlereinträge angezeigt, wenn die für die Verbindung geltende Ereignisebene oder die Resource-specific Außerkraftsetzung auf ERROR oder eine ausführlichere Stufe (WARNINFO, oderDEBUG) festgelegt ist. Ping-Erfolgseinträge werden jedoch nur veröffentlicht, wenn diese Stufe auf eingestellt ist. DEBUG Informationen zum Konfigurieren dieser Einstellungen finden Sie unter und. Konto konfigurieren und anmelden Event-level AWS IoT (CLI) Konfigurieren Sie Resource-specific Überschreibungen in AWS IoT (CLI)

Bei Erfolg logLevel gilt das ist DEBUG und das status istSuccess. Bei einem Fehler (z. B. wenn die Client-Verbindung beendet wird, bevor der PINGRESP gesendet werden kann), logLevel ist ERROR und ist. status Failure

Beispiel für einen Ping-Logeintrag (erfolgreich)


{
    "timestamp": "2025-10-31 15:37:23.476",
    "logLevel": "DEBUG",
    "traceId": "20b23f3f-d7f1-feae-169f-82263394fbdb",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "Ping",
    "protocol": "MQTT",
    "latency": 128,
    "requestTimestamp": "2025-10-31 15:37:23.348",
    "responseTimestamp": "2025-10-31 15:37:23.476",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490
}

Beispiel für einen Ping-Logeintrag (Fehler)


{
    "timestamp": "2025-10-31 15:37:23.476",
    "logLevel": "ERROR",
    "traceId": "20b23f3f-d7f1-feae-169f-82263394fbdb",
    "accountId": "123456789012",
    "status": "Failure",
    "eventType": "Ping",
    "protocol": "MQTT",
    "requestTimestamp": "2025-10-31 15:37:23.476",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490,
    "reason": "CONNECTION_ALREADY_CLOSED",
    "details": "Connection has already closed"
}

Neben Allgemeine CloudWatch Log-Attribute enthalten Ping-Protokolleinträge die folgenden Attribute:

Protokoll: Das für die Anforderung verwendete Protokoll. Dieser Wert ist immer MQTT.
latency: Die Zeit in Millisekunden zwischen dem Empfangen des PINGREQ und dem Senden des PINGRESP. Dieses Feld ist nur vorhanden, wenn das ist. status Success
RequestTimestamp: Der Zeitstempel, zu dem der PINGREQ vom Client AWS IoT Core empfangen wurde.
Zeitstempel der Antwort: Der Zeitstempel, als der PINGRESP AWS IoT Core an den Client gesendet wurde. Dieses Feld ist nur vorhanden, wenn das ist. status Success
clientId: Die ID des Clients, der die Anforderung stellt.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
sourceIp: Die IP-Adresse, von der die Anforderung stammt.
sourcePort: Der Port, von dem die Anforderung stammt.
Grund: Der Grund für den Ausfall des Ping-Vorgangs. Dieses Feld ist nur vorhanden, wenn das status istFailure.
Details: Eine kurze Erläuterung des Fehlers. Dieses Feld ist nur vorhanden, wenn das status istFailure.

Connection.AuthNError Log-Eintrag

Der AWS IoT Message Broker generiert einen Protokolleintrag mit einem eventType vonConnection.AuthNError, wenn ein Client-Verbindungsversuch aufgrund eines Authentifizierungsfehlers abgelehnt wird. Das logLevel für diesen Logeintrag ist immer ERROR und das status ist immerFailure. Dieser Logeintrag entspricht der Connection.AuthNError CloudWatch Metrik.

Wichtig

Connection.AuthNErrorLogeinträge sind standardmäßig aktiviert und deaktiviert. Sie werden auf ERROR Protokollebene ausgegeben, sodass ein Connection.AuthNError Protokolleintrag nur veröffentlicht wird, wenn die für die Verbindung geltende Ereignisebene oder die Resource-specific Außerkraftsetzung auf ERROR oder eine ausführlichere Stufe (WARN, INFO oder) gesetzt ist. DEBUG Informationen zum Konfigurieren dieser Einstellungen finden Sie unter und. Konto konfigurieren und anmelden Event-level AWS IoT (CLI) Konfigurieren Sie Resource-specific Überschreibungen in AWS IoT (CLI)

Anmerkung

Dieser Protokolleintrag wird auf demjenigen veröffentlicht AWS-Konto , dem die im TLS-Handshake bereitgestellte Server Name Indication (SNI) gehört. Wenn der Client kein SNI bereitstellt oder das SNI nicht zu einem Konto aufgelöst werden kann, wird kein Logeintrag oder keine Metrik ausgegeben.

Connection.AuthNError Beispiel für einen Logeintrag


{
    "timestamp": "2025-10-31 15:37:23.476",
    "logLevel": "ERROR",
    "traceId": "20b23f3f-d7f1-feae-169f-82263394fbdb",
    "accountId": "123456789012",
    "status": "Failure",
    "eventType": "Connection.AuthNError",
    "protocol": "MQTT",
    "authenticationType": "AWS_X509",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490,
    "targetIp": "52.94.236.10",
    "targetPort": 8883,
    "serverNameIndication": "a1b2c3d4e5f6g7-ats.iot.us-east-1.amazonaws.com",
    "reason": "DEVICE_CERTIFICATE_NOT_REGISTERED",
    "details": "Device certificate is not registered"
}

Neben Allgemeine CloudWatch Log-Attribute enthalten Connection.AuthNError-Protokolleinträge die folgenden Attribute:

Protokoll: Das für die Anforderung verwendete Protokoll. Gültige Werte sind MQTT oder HTTP.
AuthenticationType: Die Art der Authentifizierung, die für den Verbindungsversuch verwendet wird. Gültige Werte sind AWS_X509, AWS_SIGV4, CUSTOM_AUTH und CUSTOM_AUTH_X509.
clientId: Die ID des Clients, der die Anfrage stellt, falls verfügbar.
principalId: Die ID des Prinzipals, der die Anfrage stellt, falls verfügbar.
sourceIp: Die IP-Adresse, von der die Anforderung stammt.
sourcePort: Der Port, von dem die Anforderung stammt.
Ziel-IP: Die Ziel-IP-Adresse der Verbindung. Dieses Feld ist möglicherweise nicht in allen Protokolleinträgen vorhanden.
Zielport: Der Zielport der Verbindung.
Server NameIndication: Der vom Client bereitgestellte Hostname für die Erweiterung SNI (TLS Server Name Indication).
Grund: Der Grund, warum die Client-Authentifizierung fehlgeschlagen ist. Eine Liste der möglichen Werte finden Sie unterConnection.AuthNError Fehlercodes.
Details: Eine kurze Beschreibung des Authentifizierungsfehlers.

Connection.AuthNError Fehlercodes

In der folgenden Tabelle sind die reason Fehlercodes und die entsprechenden details Meldungen aufgeführt, die für einen Connection.AuthNError Protokolleintrag auftreten können. In Zukunft können weitere Fehlercodes hinzugefügt werden.

Fehlercode	Fehlermeldung
`CUSTOM_AUTHORIZER_LAMBDA_EXECUTION_ERROR`	Der Lambda-Aufruf des benutzerdefinierten Authorizers ist fehlgeschlagen
`CUSTOM_AUTHORIZER_NOT_FOUND`	Benutzerdefinierter Autorisierer konnte nicht gefunden werden
`CUSTOM_AUTHORIZER_PARAMETER_INVALID`	Der benutzerdefinierte Authentifizierungsparameter ist ungültig
`DEVICE_CERTIFICATE_INACTIVE`	Das Gerätezertifikat ist nicht aktiv
`DEVICE_CERTIFICATE_NOT_REGISTERED`	Das Gerätezertifikat ist nicht registriert
`DEVICE_CERTIFICATE_REVOKED`	Das Gerätezertifikat wurde gesperrt
`DOMAIN_CONFIGURATION_DISABLED`	Die Domänenkonfiguration für die bereitgestellte Server Name Indication (SNI) ist deaktiviert
`DOMAIN_CONFIGURATION_INVALID`	Der Endpunkttyp in der Domänenkonfiguration ist ungültig
`INTERNAL_SERVER_ERROR`	Interner Serverfehler
`NOT_AUTHENTICATED`	Die angegebenen Anmeldeinformationen konnten nicht authentifiziert werden
`SECURITY_TOKEN_EXPIRED`	Das Sicherheitstoken ist abgelaufen
`SECURITY_TOKEN_INVALID`	Das in der Anfrage enthaltene Sicherheitstoken ist ungültig
`SECURITY_TOKEN_SIGNATURE_MISMATCH`	Die Anforderungssignatur stimmt nicht mit der angegebenen Signatur überein
`SNI_MISUSED`	Der Kunde hat eine SNI verwendet, die nicht mit diesem Konto verknüpft ist

DeleteConnection Log-Eintrag

Der AWS IoT Message Broker generiert einen Logeintrag mit einem eventType von, DeleteConnection wenn eine MQTT-Client-Verbindung gelöscht wird.

DeleteConnection Beispiel für einen Logeintrag


{
    "timestamp": "2025-08-09 15:37:23.476",
    "logLevel": "INFO",
    "traceId": "20b23f3f-d7f1-feae-169f-82263394fbdb",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "DeleteConnection",
    "protocol": "HTTP",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten DeleteConnection Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der getrennt wird.
principalId: Die ID des Prinzipals, der die Anforderung stellt. Informationen zur Identifizierung des Principals anhand der Principal-ID finden Sie im IAM-Benutzerhandbuch unter Vergleichen von IAM-Identitäten und -Anmeldeinformationen.
Protokoll: Das für die Anforderung verwendete Protokoll. Der gültige Wert lautet HTTP.
sourceIp: Die IP-Adresse, von der die Anforderung stammt.
sourcePort: Der Port, von dem die Anforderung stammt.

GetRetainedMessage Log-Eintrag

Der AWS IoT Message Broker generiert einen Logeintrag mit einem oder eventTypeGetRetainedMessage, wenn er aufgerufen GetRetainedMessage wird.

GetRetainedMessage Beispiel für einen Logeintrag


{
    "timestamp": "2017-08-07 18:47:56.664", 
    "logLevel": "INFO", 
    "traceId": "1a60d02e-15b9-605b-7096-a9f584a6ad3f", 
    "accountId": "123456789012", 
    "status": "Success", 
    "eventType": "GetRetainedMessage", 
    "protocol": "HTTP",
    "topicName": "a/b/c",
    "qos": "1",
    "lastModifiedDate": "2017-08-07 18:47:56.664"
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten GetRetainedMessage Protokolleinträge die folgenden Attribute:

letzte ModifiedDate: Das Epochendatum und die Uhrzeit in Millisekunden, zu denen die aufbewahrte Nachricht gespeichert wurde. AWS IoT
Protokoll: Das für die Anforderung verwendete Protokoll. Zulässiger Wert: HTTP.
qos: Das QoS (Quality of Service)-Niveau, das in der Veröffentlichungsanforderung verwendet wird. Gültige Werte sind 0 oder 1.
topicName: Der Name des abonnierten Themas.

ListRetainedMessage Log-Eintrag

Der AWS IoT Message Broker generiert einen Logeintrag mit einem oder eventTypeListRetainedMessage, wenn er aufgerufen ListRetainedMessages wird.

ListRetainedMessage Beispiel für einen Logeintrag


{
    "timestamp": "2017-08-07 18:47:56.664", 
    "logLevel": "INFO", 
    "traceId": "1a60d02e-15b9-605b-7096-a9f584a6ad3f", 
    "accountId": "123456789012", 
    "status": "Success", 
    "eventType": "ListRetainedMessage", 
    "protocol": "HTTP"
}

Zusätzlich zu den enthalten Allgemeine CloudWatch Log-Attribute die ListRetainedMessage Protokolleinträge das folgende Attribut:

Protokoll: Das für die Anforderung verwendete Protokoll. Zulässiger Wert: HTTP.

ListSubscriptions Log-Eintrag

Der AWS IoT Message Broker generiert einen Logeintrag mit einem eventType von, ListSubscriptions wenn eine Anfrage zum Auflisten von Kundenabonnements eingeht.

ListSubscriptions Beispiel für einen Logeintrag


{
    "timestamp": "2025-08-22 19:57:46.587",
    "logLevel": "INFO",
    "traceId": "5bea658a-0752-bf20-770f-ad17c8dabb95",
    "accountId": "987654321",
    "status": "Success",
    "eventType": "ListSubscriptions",
    "protocol": "HTTP",
    "clientId": "abc",
    "principalId": "AIDAZPOK3C3545MCMYATF",
    "sourceIp": "52.94.133.137",
    "sourcePort": 13490,
    "maxResults": 100
}

Neben Allgemeine CloudWatch Log-Attribute enthalten ListSubscriptions-Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
Protokoll: Das für die Anforderung verwendete Protokoll. Zulässiger Wert: HTTP.
sourceIp: Die IP-Adresse, von der die Anforderung stammt.
sourcePort: Der Port, von dem die Anforderung stammt.
maxResults: Die maximale Anzahl angeforderter Ergebnisse.

GetConnection Log-Eintrag

Der AWS IoT Message Broker generiert einen Logeintrag mit einem oderGetConnection, wenn eine Anfrage zum Abrufen eventType von Verbindungsinformationen eingeht.

GetConnection Beispiel für einen Logeintrag


{
    "timestamp": "2025-08-22 19:19:50.679",
    "logLevel": "INFO",
    "traceId": "7a04de1a-d1a3-50bc-3ca5-96b1ee293dae",
    "accountId": "987654321",
    "status": "Success",
    "eventType": "GetConnection",
    "protocol": "HTTP",
    "clientId": "aClient",
    "principalId": "AIDAZPOK3C3545MCMYATF",
    "sourceIp": "52.94.133.137",
    "sourcePort": 31983
}

Neben Allgemeine CloudWatch Log-Attribute enthalten GetConnection-Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
Protokoll: Das für die Anforderung verwendete Protokoll. Zulässiger Wert: HTTP.
sourceIp: Die IP-Adresse, von der die API-Anfrage stammt.
sourcePort: Der Port, von dem die API-Anfrage stammt.

Publish-In Log-Eintrag

Wenn der AWS IoT Message Broker eine MQTT-Nachricht empfängt, generiert er einen Logeintrag mit einem eventType vonPublish-In.

Publish-In Beispiel für einen Logeintrag


{
        "timestamp": "2017-08-10 15:39:30.961",
        "logLevel": "INFO",
        "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699",
        "accountId": "123456789012",
        "status": "Success",
        "eventType": "Publish-In",
        "protocol": "MQTT",
        "topicName": "$aws/things/MyThing/shadow/get",
        "clientId": "abf27092886e49a8a5c1922749736453",
        "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
        "sourceIp": "205.251.233.181",
        "sourcePort": 13490,
        "retain": "True"
    }

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten Publish-In Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
Protokoll: Das für die Anforderung verwendete Protokoll. Gültige Werte sind MQTT oder HTTP.
Beibehaltung: Das Attribut, das verwendet wird, wenn für eine Nachricht das RETAIN-Flag auf den Wert True festgelegt ist. Wenn für die Nachricht das RETAIN-Flag nicht festgelegt ist, erscheint dieses Attribut nicht im Protokolleintrag. Weitere Informationen finden Sie unter Beibehaltene MQTT-Meldungen.
sourceIp: Die IP-Adresse, von der die Anforderung stammt.
sourcePort: Der Port, von dem die Anforderung stammt.
topicName: Der Name des abonnierten Themas.

Publish-Out Log-Eintrag

Wenn der Message Broker eine MQTT-Nachricht veröffentlicht, generiert er einen Protokolleintrag mit dem eventType Publish-Out

Publish-Out Beispiel für einen Protokolleintrag


{
    "timestamp": "2017-08-10 15:39:30.961",
    "logLevel": "INFO",
    "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "Publish-Out",
    "protocol": "MQTT",
    "topicName": "$aws/things/MyThing/shadow/get",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten Publish-Out Protokolleinträge die folgenden Attribute:

clientId: Die ID des abonnierten Clients, der Nachrichten zu diesem MQTT-Thema empfängt.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
Protokoll: Das für die Anforderung verwendete Protokoll. Gültige Werte sind MQTT oder HTTP.
sourceIp: Die IP-Adresse, von der die Anforderung stammt.
sourcePort: Der Port, von dem die Anforderung stammt.
topicName: Der Name des abonnierten Themas.

Protokolleintrag in der Warteschlange

Wenn ein Gerät mit einer persistenten Sitzung getrennt wird, speichert der MQTT-Nachrichtenbroker die Nachrichten des Geräts und AWS IoT generiert Protokolleinträge mit einem EventType-Wert von. Queued Weitere Hinweise zu persistenten MQTT-Sitzungen finden Sie unter. Persistente MQTT-Sitzungen

Beispiel für einen Eintrag in das Fehlerprotokoll eines Servers in der Warteschlange


{
    "timestamp": "2022-08-10 15:39:30.961",
    "logLevel": "ERROR",
    "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699",
    "accountId": "123456789012",
    "topicName": "$aws/things/MyThing/get",
    "clientId": "123123123",
    "qos": "1",
    "protocol": "MQTT",
    "eventType": "Queued",
    "status": "Failure",
    "details": "Server Error"
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten Queued Serverfehlerprotokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, für den sich die Nachricht in der Warteschlange befindet.
Details: Serverfehler

Aufgrund eines Serverfehlers konnte die Nachricht nicht gespeichert werden.
Protokoll: Das für die Anforderung verwendete Protokoll. Dieser Wert ist immer MQTT.
qos: Die QoS (Quality of Service)-Ebene der Anforderung. Der Wert ist immer 1, da die Nachrichten mit QoS von 0 nicht gespeichert werden.
topicName: Der Name des abonnierten Themas.

Beispiel für einen Eintrag in einem Erfolgsprotokoll in der Warteschlange


{
    "timestamp": "2022-08-10 15:39:30.961",
    "logLevel": "INFO",
    "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699",
    "accountId": "123456789012",
    "topicName": "$aws/things/MyThing/get",
    "clientId": "123123123",
    "qos": "1",
    "protocol": "MQTT",
    "eventType": "Queued",
    "status": "Success"
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten Queued Erfolgsprotokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, für den sich die Nachricht in der Warteschlange befindet.
Protokoll: Das für die Anforderung verwendete Protokoll. Dieser Wert ist immer MQTT.
qos: Die QoS (Quality of Service)-Ebene der Anforderung. Der Wert ist immer 1, da die Nachrichten mit QoS von 0 nicht gespeichert werden.
topicName: Der Name des abonnierten Themas.

Beispiel für einen gedrosselten Protokolleintrag in der Warteschlange


{
    "timestamp": "2022-08-10 15:39:30.961",
    "logLevel": "ERROR",
    "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699",
    "accountId": "123456789012",
    "topicName": "$aws/things/MyThing/get",
    "clientId": "123123123",
    "qos": "1",
    "protocol": "MQTT",
    "eventType": "Queued",
    "status": "Failure",
    "details": "Throttled while queueing offline message"
}

Zusätzlich zu den enthalten Allgemeine CloudWatch Log-Attribute Queued gedrosselte Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, für den sich die Nachricht in der Warteschlange befindet.
Details: Beim Einstellen einer Offline-Nachricht in die Warteschlange gedrosselt

Der Client hat das Queued messages per second per account Limit überschritten, sodass die Nachricht nicht gespeichert wurde.
Protokoll: Das für die Anforderung verwendete Protokoll. Dieser Wert ist immer MQTT.
qos: Die QoS (Quality of Service)-Ebene der Anforderung. Der Wert ist immer 1, da die Nachrichten mit QoS von 0 nicht gespeichert werden.
topicName: Der Name des abonnierten Themas.

Der AWS IoT Message Broker generiert einen Logeintrag mit einem oder, Subscribe wenn ein eventType MQTT-Client ein Thema abonniert.


{
    "timestamp": "2017-08-10 15:39:04.413",
    "logLevel": "INFO",
    "traceId": "7aa5c38d-1b49-3753-15dc-513ce4ab9fa6",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "Subscribe",
    "protocol": "MQTT",
    "topicName": "$aws/things/MyThing/shadow/#",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten Subscribe Logeinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
Protokoll: Das für die Anforderung verwendete Protokoll. Dieser Wert ist immer MQTT.
sourceIp: Die IP-Adresse, von der die Anforderung stammt.
sourcePort: Der Port, von dem die Anforderung stammt.
topicName: Der Name des abonnierten Themas.


{
	"timestamp": "2022-11-30 16:24:15.628",
	"logLevel": "INFO",
	"traceId": "7aa5c38d-1b49-3753-15dc-513ce4ab9fa6",
	"accountId": "123456789012",
	"status": "Success",
	"eventType": "Subscribe",
	"protocol": "MQTT",
	"topicName": "test/topic1,$invalid/reserved/topic",
	"subscriptions": [
		{
			"topicName": "test/topic1",
			"reasonCode": 1
		},
		{
			"topicName": "$invalid/reserved/topic",
			"reasonCode": 143
		}
	],
	"clientId": "abf27092886e49a8a5c1922749736453",
	"principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
	"sourceIp": "205.251.233.181",
	"sourcePort": 13490
}

Für MQTT 5-Subscribe-Operationen enthalten MQTT 5-Protokolleinträge zusätzlich zu den Protokolleintragsattributen Allgemeine CloudWatch Log-Attribute und den MQTT 3-Subscribe-Protokolleintragsattributen das folgende Attribut: Subscribe

Abonnements: Eine Liste von Zuordnungen zwischen den angeforderten Themen in der Abonnement-Anforderung und dem individuellen MQTT 5-Ursachencode. Weitere Informationen finden Sie unter MQTT-Ursachencodes.

Protokolleintrag abbestellen

Der AWS IoT Message Broker generiert einen Logeintrag mit einem eventType von, Unsubscribe wenn sich ein MQTT-Client von einem MQTT-Thema abmeldet.

Beispiel für einen MQTT-Logeintrag zum Abbestellen


{
    "timestamp": "2024-08-20 22:53:32.844",
    "logLevel": "INFO",
    "traceId": "db6bd09a-2c3f-1cd2-27cc-fd6b1ce03b58",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "Unsubscribe",
    "protocol": "MQTT",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "sourceIp": "205.251.233.181",
    "sourcePort": 13490
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten Unsubscribe Logeinträge die folgenden Attribute:

Protokoll: Das für die Anforderung verwendete Protokoll. Dieser Wert ist immer MQTT.
clientId: Die ID des Clients, der die Anforderung stellt.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
sourceIp: Die IP-Adresse, von der die Anforderung stammt.
sourcePort: Der Port, von dem die Anforderung stammt.

SendDirectMessage Log-Eintrag

Der AWS IoT Message Broker generiert einen Logeintrag mit einem eventType vonSendDirectMessage, wenn eine SendDirectMessage API-Anfrage gestellt wird.

AWS IoT Core protokolliert SendDirectMessage Ereignisse in CloudWatch Logs, wenn Sie die IoT-Protokollierung aktivieren. Weitere Informationen zur Konfiguration der Protokollierung finden Sie unterKonfiguration AWS IoT Protokollierung.

SendDirectMessage Beispiel für einen Erfolgsprotokolleintrag


{
    "timestamp": "2026-01-20 20:44:00.123",
    "logLevel": "INFO",
    "traceId": "1a2b3c4d-1234-3214-abcd-1a2b3c4d5e6f",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "SendDirectMessage",
    "protocol": "HTTP",
    "topicName": "commands/reboot",
    "clientId": "mydevice-002",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "confirmation": true,
    "sourceIp": "203.0.113.45",
    "sourcePort": 52847,
    "timeout": 3
}

SendDirectMessage Beispiel für einen Fehlerprotokolleintrag


{
    "timestamp": "2026-01-15 20:30:00.123",
    "logLevel": "ERROR",
    "traceId": "1a2b3c4d-1234-5678-abcd-1a2b3c4d5e6f",
    "accountId": "123456789012",
    "status": "Failure",
    "eventType": "SendDirectMessage",
    "protocol": "HTTP",
    "topicName": "commands/reboot",
    "clientId": "myDevice",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "confirmation": true,
    "sourceIp": "203.0.113.45",
    "sourcePort": 52847,
    "reason": "DELIVERY_CONFIRMATION_TIMEOUT",
    "details": "The delivery confirmation was not received within the specified timeout period",
    "timeout": 2
}

Neben Allgemeine CloudWatch Log-Attribute enthalten SendDirectMessage-Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Direktnachricht empfängt.
topicName: Das Thema, zu dem die Nachricht gesendet wurde.
Protokoll: Das für die Anforderung verwendete Protokoll. Zulässiger Wert: HTTP.
Bestätigung: Ob eine Lieferbestätigung angefordert wurde. Gültige Werte sind true oder false.
timeout: Maximale Wartezeit in Sekunden auf eine Lieferbestätigung des empfangenden Kunden. Nur anwesend, wenn confirmation es isttrue.
Grund: Der Ursachencode für den Fehler.
Details: Eine kurze Erläuterung des Fehlers.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
sourceIp: Die IP-Adresse, von der die Anforderung stammt.
sourcePort: Der Port, von dem die Anforderung stammt.

Ursachencodes

Die folgenden Ursachencodes und Details werden in den Fehlerprotokolleinträgen angezeigt:

SendDirectMessage Ursachencodes
Grund	Details
`MALFORMED_CLIENTID`	Diese Client-ID ist nicht gültig. Kunden-IDs dürfen 128 Zeichen nicht überschreiten und dürfen nicht mit einem Dollarzeichen ($) beginnen. Geben Sie eine andere Kunden-ID ein
`INVALID_TOPIC`	Dieses Thema ist nicht gültig. Themen müssen innerhalb von 256 Byte lang sein, sollten weniger als 9 Teile enthalten und dürfen nicht mit einem Dollarzeichen ($) beginnen
`INVALID_TIMEOUT_PARAMETER`	Ungültiger Timeout-Wert. Muss eine Ganzzahl zwischen 1 und 15 sein
`INVALID_CONFIRMATION_PARAMETER`	Ungültiger Bestätigungswert. Muss 'wahr' oder 'falsch' sein
`RECEIVE_AUTHORIZATION_FAILURE`	Die Autorisierung für den Zielclient ist fehlgeschlagen. Stellen Sie sicher, dass Ihre Richtlinie die erforderlichen Berechtigungen gewährt
`TARGET_CLIENT_ID_NOT_FOUND`	Die Client-ID wurde nicht gefunden. Stellen Sie sicher, dass der Client verbunden ist, und versuchen Sie es erneut
`TARGET_CLIENT_NOT_CONNECTED`	Die Zielclient-ID ist nicht verbunden, es besteht jedoch eine aktive persistente Sitzung
`SEND_DIRECT_MESSAGE_THROTTLED`	Die Anfrage wurde abgelehnt, da die Anforderungsrate zum Senden von Direktnachrichten überschritten wurde
`RECEIVE_SESSION_THROTTLED`	Die Anfrage wurde abgelehnt, da die Anforderungsrate die ausgehenden Veröffentlichungsanfragen pro Sekunde pro Verbindung überstieg
`RECEIVER_MAX_UNACKED_QOS1_EXCEEDED`	Der Empfängerclient hat die maximale Anzahl unbestätigter QoS 1-Nachrichten erreicht
`DELIVERY_CONFIRMATION_TIMEOUT`	Die Lieferbestätigung wurde nicht innerhalb des angegebenen Timeout-Zeitraums empfangen
`DELIVERY_CONFIRMATION_SENDER_DISCONNECT`	Der Absender hat die Verbindung unterbrochen, bevor die Lieferbestätigung empfangen wurde
`CLIENT_ENDPOINT_NOT_WRITABLE`	Der Endpunkt des Empfänger-Clients ist nicht beschreibbar
`INTERNAL_SERVER_ERROR`	Interner Serverfehler

OCSP-Protokolleinträge des Serverzertifikats

AWS IoT Core generiert Protokolleinträge für das folgende Ereignis:

Themen

RetrieveOCSPStapleData Log-Eintrag
RetrieveOCSPStapleData Protokolleintrag für private Endpunkte

RetrieveOCSPStapleData Log-Eintrag

AWS IoT Core generiert einen Protokolleintrag mit einem oder, RetrieveOCSPStapleData wenn eventType der Server die OCSP-Stapeldaten abruft.

RetrieveOCSPStapleData Beispiele für Protokolleinträge

Im Folgenden finden Sie ein Beispiel für einen Protokolleintrag vonSuccess.


{
	"timestamp": "2024-01-30 15:39:30.961",
	"logLevel": "INFO",
	"traceId": "180532b7-0cc7-057b-687a-5ca1824838f5",
	"accountId": "123456789012",
	"status": "Success",
	"eventType": "RetrieveOCSPStapleData",
	"domainConfigName": "test-domain-config-name",
	"connectionDetails": {
		"httpStatusCode": "200",
		"ocspResponderUri": "http://ocsp.example.com",
		"sourceIp": "205.251.233.181",
		"targetIp": "250.15.5.3"
	},
	"ocspRequestDetails": {
		"requesterName": "iot.amazonaws.com",
		"requestCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01"
	},
	"ocspResponseDetails": {
		"responseCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01",
		"ocspResponseStatus": "successful",
		"certStatus": "good",
		"signature": "4C:6F:63:61:6C:20:52:65:73:70:6F:6E:64:65:72:20:53:69:67:6E:61:74:75:72:65",
		"thisUpdateTime": "Jan 31 01:21:02 2024 UTC",
		"nextUpdateTime": "Feb 02 00:21:02 2024 UTC",
		"producedAtTime": "Jan 31 01:37:03 2024 UTC",
		"stapledDataPayloadSize": "XXX"
	}
}

Im Folgenden finden Sie ein Beispiel für einen Protokolleintrag fürFailure.


{
	"timestamp": "2024-01-30 15:39:30.961",
	"logLevel": "ERROR",
	"traceId": "180532b7-0cc7-057b-687a-5ca1824838f5",
	"accountId": "123456789012",
	"status": "Failure",
	"reason": "A non 2xx HTTP response was received from the OCSP responder.",
	"eventType": "RetrieveOCSPStapleData",
	"domainConfigName": "test-domain-config-name",
	"connectionDetails": {
		"httpStatusCode": "444",
		"ocspResponderUri": "http://ocsp.example.com",
		"sourceIp": "205.251.233.181",
		"targetIp": "250.15.5.3"
	},
	"ocspRequestDetails": {
		"requesterName": "iot.amazonaws.com",
		"requestCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01"
	}
}

Für den RetrieveOCSPStaple Vorgang enthalten die Allgemeine CloudWatch Log-Attribute Protokolleinträge zusätzlich zu den die folgenden Attribute:

Grund

Der Grund, warum der Vorgang fehlschlägt.

Domäne ConfigName

Der Name Ihrer Domain-Konfiguration.

Einzelheiten zur Verbindung

Eine kurze Erläuterung der Verbindungsdetails.

http StatusCode

HTTP-Statuscodes, die vom OCSP-Responder als Antwort auf die Anfrage des Clients an den Server zurückgegeben werden.
ocsp ResponderUri

Die OCSP-Responder-URI, die aus dem AWS IoT Core Serverzertifikat abruft.
sourceIp

Die Quell-IP-Adresse des Servers. AWS IoT Core
Ziel-IP

Die Ziel-IP-Adresse des OCSP-Responders.

ocsp RequestDetails

Details der OCSP-Anfrage.

Name des Anforderers

Der Bezeichner für den AWS IoT Core Server, der eine Anfrage an den OCSP-Responder sendet.
Anfrage CertId

Die Zertifikat-ID der Anfrage. Dies ist die ID des Zertifikats, für das die OCSP-Antwort angefordert wird.

ocsp ResponseDetails

Details der OCSP-Antwort.

Antwort CertId

Die Zertifikat-ID der OCSP-Antwort.
ocsp ResponseStatus

Der Status der OCSP-Antwort.
CertStatus

Der Status des Zertifikats.
signature

Die Signatur, die von einer vertrauenswürdigen Entität auf die Antwort angewendet wird.
das UpdateTime

Der Zeitpunkt, zu dem der angezeigte Status bekanntermaßen korrekt ist.
als nächstes UpdateTime

Der Zeitpunkt, zu dem oder vor dem neuere Informationen über den Status des Zertifikats verfügbar sein werden.
produziert AtTime

Der Zeitpunkt, zu dem der OCSP-Responder diese Antwort signiert hat.
geheftet DataPayloadSize

Die Nutzdatengröße der gehefteten Daten.

RetrieveOCSPStapleData Protokolleintrag für private Endpunkte

AWS IoT Core generiert einen Protokolleintrag mit einem oder, RetrieveOCSPStapleData wenn eventType der Server die OCSP-Stapeldaten abruft.

RetrieveOCSPStapleData Beispiele für Protokolleinträge für private Endpunkte

Im Folgenden finden Sie ein Beispiel für einen Protokolleintrag von. Success


{
	"timestamp": "2024-01-30 15:39:30.961",
	"logLevel": "INFO",
	"traceId": "180532b7-0cc7-057b-687a-5ca1824838f5",
	"accountId": "123456789012",
	"status": "Success",
	"eventType": "RetrieveOCSPStapleData",
	"domainConfigName": "test-domain-config-name",
        "lambdaDetails": {
        "lambdaArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
        "sourceArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/testDomainConfigure/6bzfg"
      },
        "authorizedResponderArn": "arn:aws:acm:us-west-2:123456789012:certificate/certificate_ID",
	"ocspRequestDetails": {
		"requesterName": "iot.amazonaws.com",
		"requestCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01"
	},
	"ocspResponseDetails": {
		"responderId": "04:C1:3F:8F:27:D6:49:13:F8:DE:B2:36:9D:85:8E:F8:31:3B:A6:D0"
               "responseCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01",
		"ocspResponseStatus": "successful",
		"certStatus": "good",
		"signature": "4C:6F:63:61:6C:20:52:65:73:70:6F:6E:64:65:72:20:53:69:67:6E:61:74:75:72:65",
		"thisUpdateTime": "Jan 31 01:21:02 2024 UTC",
		"nextUpdateTime": "Feb 02 00:21:02 2024 UTC",
		"producedAtTime": "Jan 31 01:37:03 2024 UTC",
		"stapledDataPayloadSize": "XXX"
	}
}

Im Folgenden finden Sie ein Beispiel für einen Protokolleintrag fürFailure.


{
	"timestamp": "2024-01-30 15:39:30.961",
	"logLevel": "ERROR",
	"traceId": "180532b7-0cc7-057b-687a-5ca1824838f5",
	"accountId": "123456789012",
	"status": "Failure",
	"reason": "The payload returned by the Lambda function exceeds the maximum response size of 7 kilobytes.",
	"eventType": "RetrieveOCSPStapleData",
	"domainConfigName": "test-domain-config-name",
        "lambdaDetails": {
        "lambdaArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
        "sourceArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/testDomainConfigure/6bzfg"
      },
        "authorizedResponderArn": "arn:aws:acm:us-west-2:123456789012:certificate/certificate_ID",
	 "ocspRequestDetails": {
		"requesterName": "iot.amazonaws.com",
		"requestCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01"
	}
}

Für den RetrieveOCSPStaple Vorgang enthalten die RetrieveOCSPStapleData Protokolleinträge für private Endpunkte zusätzlich zu den Attributen Allgemeine CloudWatch Log-Attribute und den Attributen im Protokolleintrag die folgenden Attribute:

Lambda-Einzelheiten

Details der Lambda-Funktion.

LambdaArn

ARN der Lambda-Funktion.
Quelle Arn

Der ARN der Domänenkonfiguration.

autorisiert ResponderArn: Der ARN des Authorizer-Responders, falls in der Domänenkonfiguration einer konfiguriert ist.

Protokolleinträge „Geräteschatten“

Der AWS IoT Device Shadow-Dienst generiert Protokolleinträge für die folgenden Ereignisse:

Themen

DeleteThingShadow Protokolleintrag
GetThingShadow Eintrag protokollieren
UpdateThingShadow Eintrag protokollieren

DeleteThingShadow Protokolleintrag

Der Geräteschatten-Service generiert einen Protokolleintrag eventType für DeleteThingShadow, wenn eine Anforderung zum Löschen eines Geräteschattens empfangen wird.

DeleteThingShadow Beispiel für einen Protokolleintrag


{
    "timestamp": "2017-08-07 18:47:56.664",
    "logLevel": "INFO",
    "traceId": "1a60d02e-15b9-605b-7096-a9f584a6ad3f",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "DeleteThingShadow",
    "protocol": "MQTT",
    "deviceShadowName": "Jack",
    "topicName": "$aws/things/Jack/shadow/delete"
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten DeleteThingShadow Protokolleinträge die folgenden Attribute:

Gerät ShadowName: Der Name des zu aktualisierenden Schattens.
Protokoll: Das für die Anforderung verwendete Protokoll. Gültige Werte sind MQTT oder HTTP.
topicName: Der Name des Themas, in dem die Anforderung veröffentlicht wurde.

GetThingShadow Eintrag protokollieren

Der Geräteschatten-Service generiert einen Protokolleintrag mit eventType für GetThingShadow, wenn eine Abrufanforderung für einen Schatten empfangen wird.

GetThingShadow Beispiel für einen Protokolleintrag


{
    "timestamp": "2017-08-09 17:56:30.941",
    "logLevel": "INFO",
    "traceId": "b575f19a-97a2-cf72-0ed0-c64a783a2504",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "GetThingShadow",
    "protocol": "MQTT",
    "deviceShadowName": "MyThing",
    "topicName": "$aws/things/MyThing/shadow/get"
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten GetThingShadow Protokolleinträge die folgenden Attribute:

Gerät ShadowName: Der Name des angefragten Schattens.
Protokoll: Das für die Anforderung verwendete Protokoll. Gültige Werte sind MQTT oder HTTP.
topicName: Der Name des Themas, in dem die Anforderung veröffentlicht wurde.

UpdateThingShadow Eintrag protokollieren

Der Geräteschatten-Service generiert einen Protokolleintrag durch eventType UpdateThingShadow, wenn eine Anforderung zum Aktualisieren eines Geräteschattens empfangen wird.

UpdateThingShadow Beispiel für einen Protokolleintrag


{
    "timestamp": "2017-08-07 18:43:59.436",
    "logLevel": "INFO",
    "traceId": "d0074ba8-0c4b-a400-69df-76326d414c28",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "UpdateThingShadow",
    "protocol": "MQTT",
    "deviceShadowName": "Jack",
    "topicName": "$aws/things/Jack/shadow/update"
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten UpdateThingShadow Protokolleinträge die folgenden Attribute:

Gerät ShadowName: Der Name des zu aktualisierenden Schattens.
Protokoll: Das für die Anforderung verwendete Protokoll. Gültige Werte sind MQTT oder HTTP.
topicName: Der Name des Themas, in dem die Anforderung veröffentlicht wurde.

Protokolleinträge zur Regel-Engine

Die AWS IoT Regel-Engine generiert Protokolle für die folgenden Ereignisse:

Themen

FunctionExecution Log-Eintrag
RuleExecution Log-Eintrag
RuleMatch Protokolleintrag
RuleEvaluation gedrosselter Protokolleintrag
RuleExecutionThrottled Log-Eintrag
RuleNotFound Log-Eintrag
StartingRuleExecution Log-Eintrag

FunctionExecution Log-Eintrag

Die Regel-Engine generiert einen Protokolleintrag mit eventType von FunctionExecution, wenn die SQL-Abfrage einer Regel eine externe Funktion aufruft. Eine externe Funktion wird aufgerufen, wenn die Aktion einer Regel eine HTTP-Anfrage an AWS IoT oder einen anderen Webdienst sendet (z. B. durch Aufrufen von get_thing_shadow odermachinelearning_predict).

FunctionExecution Beispiel für einen Logeintrag


{
    "timestamp": "2017-07-13 18:33:51.903",
    "logLevel": "DEBUG",
    "traceId": "180532b7-0cc7-057b-687a-5ca1824838f5",
    "status": "Success",
    "eventType": "FunctionExecution",
    "clientId": "N/A",
    "topicName":"rules/test",
    "ruleName": "ruleTestPredict",
    "ruleAction": "MachinelearningPredict",
    "resources": {
        "ModelId": "predict-model"
    },
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167"
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten FunctionExecution Protokolleinträge die folgenden Attribute:

clientId: N/A für FunctionExecution-Protokolle.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
Ressourcen: Eine Sammlung von Ressourcen, die von den Aktionen der Regel verwendet werden.
ruleName: Der Name der übereinstimmenden Regel.
topicName: Der Name des abonnierten Themas.

RuleExecution Log-Eintrag

Wenn die AWS IoT Regel-Engine die Aktion einer Regel auslöst, generiert sie einen RuleExecution Protokolleintrag.

RuleExecution Beispiel für einen Logeintrag


{
    "timestamp": "2017-08-10 16:32:46.070",
    "logLevel": "INFO",
    "traceId": "30aa7ccc-1d23-0b97-aa7b-76196d83537e",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "RuleExecution",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "topicName": "rules/test",
    "ruleName": "JSONLogsRule",
    "ruleAction": "RepublishAction",
    "resources": {
        "RepublishTopic": "rules/republish"
    },
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167"
}

RuleExecution Beispiel für einen Batch-Logeintrag


{
    "logLevel": "INFO",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "RuleExecution",
    "ruleName": "rule_test",
    "ruleAction": "HttpAction",
    "resources": {
        "Url": "https://example.com",
        "ConfirmationUrl": "https://example.com"
    },
    "details": "HttpAction made a request to the specified endpoint",
    "batchDetails": {
        "timestamps": [
            "1234567890123",
            "1234567890123",
            "1234567890123"
        ],
        "traceIds": [
            "30aa7ccc-1d23-0b97-aa7b-76196d83537e",
            "30aa7ccc-1d23-0b97-aa7b-76196d83537c",
            "30aa7ccc-1d23-0b97-aa7b-76196d83537d"
        ],
        "clientIds": [
            "N/A",
            "N/A",
            "N/A"
        ],
        "topicNames": [
            "topic/ruletest",
            "topic/ruletest",
            "topic/ruletest"
        ],
        "principalIds": [
            "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
            "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
            "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167"
        ],
        "batchSize": 3,
        "batchSizeInBytes": 114
    }
}

Neben Allgemeine CloudWatch Log-Attribute enthalten RuleExecution-Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
Ressourcen: Eine Sammlung von Ressourcen, die von den Aktionen der Regel verwendet werden.
ruleAction: Der Name der ausgelösten Aktion.
ruleName: Der Name der übereinstimmenden Regel.
topicName: Der Name des abonnierten Themas.

RuleMatch Protokolleintrag

Die AWS IoT Regel-Engine generiert einen Logeintrag mit einem eventType vonRuleMatch, wenn der Message Broker eine Nachricht erhält, die einer Regel entspricht.

RuleMatch Beispiel für einen Logeintrag


{
    "timestamp": "2017-08-10 16:32:46.002",
    "logLevel": "INFO",
    "traceId": "30aa7ccc-1d23-0b97-aa7b-76196d83537e",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "RuleMatch",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "topicName": "rules/test",
    "ruleName": "JSONLogsRule",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167"
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten RuleMatch Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
ruleName: Der Name der übereinstimmenden Regel.
topicName: Der Name des abonnierten Themas.

RuleEvaluation gedrosselter Protokolleintrag

Wenn AWS IoT die Rules Engine eine Regelauswertung für das Limit der Regelauswertungen pro Sekunde pro Konto drosselt, generiert sie einen Protokolleintrag mit einem „Von“ und einem Grund alseventType. RuleEvaluation Throttled

RuleEvaluation Beispiel für einen gedrosselten Protokolleintrag


{
    "timestamp": "2024-11-13 07:32:27.856",
    "logLevel": "ERROR",
    "traceId": "82995222-049b-ee5c-0cd4-15635f052ed3",
    "accountId": "123456789012",
    "status": "Failure",
    "eventType": "RuleEvaluation",
    "clientId": "57b3b41a-c726-44ab-bcd4-2cc1c2cc4295",
    "topicName": "N/A",
    "ruleName": "N/A",
    "principalId": "N/A",
    "reason": "Throttled",
    "details": "Exceeded Rule Evaluations per second per account limit"
}

Neben Allgemeine CloudWatch Log-Attribute enthalten RuleEvaluation-Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
Details: Eine kurze Erläuterung des Fehlers.
principalId: Die ID des Prinzipals, der die Anforderung stellt. Immer N/A für diesen Logeintrag.
Grund: Die Zeichenfolge „Throttled“.
ruleName: Der Name der Regel. Immer N/A für diesen Logeintrag.
topicName: Der Name des veröffentlichten Themas. Immer N/A für diesen Logeintrag.

RuleExecutionThrottled Log-Eintrag

Wenn eine Regelauswertung durch die Regel-Engine aufgrund von bösartigem Verhalten gedrosselt wird, z. B. aufgrund übermäßiger Ingest-Veröffentlichungsanfragen für nicht existierende Regeln, generiert die AWS IoT Regel-Engine einen Protokolleintrag mit dem Wert von. eventType RuleExecutionThrottled

RuleExecutionThrottled Beispiel für einen Protokolleintrag


{
    "timestamp": "2017-10-04 19:25:46.070",
    "logLevel": "ERROR",
    "traceId": "30aa7ccc-1d23-0b97-aa7b-76196d83537e",
    "accountId": "123456789012",
    "status": "Failure",
    "eventType": "RuleExecutionThrottled",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "topicName": "$aws/rules/example_rule",
    "ruleName": "example_rule",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "reason": "RuleExecutionThrottled",
    "details": "Exection of Rule example_rule throttled"
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten RuleExecutionThrottled Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
Details: Eine kurze Erläuterung des Fehlers.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
Grund: Die Zeichenfolge "RuleExecutionThrottled“.
ruleName: Der Name der Regel, die ausgelöst werden soll.
topicName: Der Name des Themas, das veröffentlicht wurde.

RuleNotFound Log-Eintrag

Wenn die AWS IoT Regel-Engine keine Regel mit einem bestimmten Namen finden kann, generiert sie einen Protokolleintrag mit dem Wert eventType vonRuleNotFound.

RuleNotFound Beispiel für einen Logeintrag


{
    "timestamp": "2017-10-04 19:25:46.070",
    "logLevel": "ERROR",
    "traceId": "30aa7ccc-1d23-0b97-aa7b-76196d83537e",
    "accountId": "123456789012",
    "status": "Failure",
    "eventType": "RuleNotFound",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "topicName": "$aws/rules/example_rule",
    "ruleName": "example_rule",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "reason": "RuleNotFound",
    "details": "Rule example_rule not found"
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten RuleNotFound Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
Details: Eine kurze Erläuterung des Fehlers.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
Grund: Die Zeichenfolge "RuleNotFound“.
ruleName: Der Name der Regel, die nicht gefunden werden konnte.
topicName: Der Name des Themas, das veröffentlicht wurde.

StartingRuleExecution Log-Eintrag

Wenn die AWS IoT Regel-Engine beginnt, eine Regelaktion auszulösen, generiert sie einen Protokolleintrag mit dem Wert eventType vonStartingRuleExecution.

StartingRuleExecution Beispiel für einen Logeintrag


{
    "timestamp": "2017-08-10 16:32:46.002",
    "logLevel": "DEBUG",
    "traceId": "30aa7ccc-1d23-0b97-aa7b-76196d83537e",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "StartingRuleExecution",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "topicName": "rules/test",
    "ruleName": "JSONLogsRule",
    "ruleAction": "RepublishAction",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167"
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten rule- Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
principalId: Die ID des Prinzipals, der die Anforderung stellt.
ruleAction: Der Name der ausgelösten Aktion.
ruleName: Der Name der übereinstimmenden Regel.
topicName: Der Name des abonnierten Themas.

Auftrag-Protokolleinträge

Der AWS IoT Job-Service generiert Protokolleinträge für die folgenden Ereignisse. Protokolleinträge werden generiert, wenn eine MQTT- oder HTTP-Anforderung vom Gerät empfangen wird.

Themen

DescribeJobExecution Log-Eintrag
GetPendingJobExecution Log-Eintrag
ReportFinalJobExecutionCount Log-Eintrag
StartNextPendingJobExecution Log-Eintrag
UpdateJobExecution Log-Eintrag

DescribeJobExecution Log-Eintrag

Der AWS IoT Jobs-Dienst generiert einen Protokolleintrag mit einem eventType vonDescribeJobExecution, wenn der Dienst eine Anforderung zur Beschreibung einer Auftragsausführung erhält.

DescribeJobExecution Beispiel für einen Protokolleintrag


{
    "timestamp": "2017-08-10 19:13:22.841",
    "logLevel": "DEBUG",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "DescribeJobExecution",
    "protocol": "MQTT",
    "clientId": "thingOne",
    "jobId": "002",
    "topicName": "$aws/things/thingOne/jobs/002/get",
    "clientToken": "myToken",
    "details": "The request status is SUCCESS."
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten GetJobExecution Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
clientToken: Ein eindeutiger Bezeichner, bei dem die Groß- und Kleinschreibung beachtet werden muss, um die Idempotenz der Anforderung sicherzustellen. Weitere Informationen finden Sie unter So wird Idempotenz sichergestellt.
Details: Weitere Informationen über den Jobs-Service.
jobId: Die Auftrags-ID für die Auftragsausführung.
Protokoll: Das für die Anforderung verwendete Protokoll. Gültige Werte sind MQTT oder HTTP.
topicName: Das für die Anforderung verwendete Thema.

GetPendingJobExecution Log-Eintrag

Der AWS IoT Jobs-Dienst generiert einen Protokolleintrag mit einem eventType oderGetPendingJobExecution, wenn der Dienst eine Anforderung zur Auftragsausführung erhält.

GetPendingJobExecution Beispiel für einen Protokolleintrag


{
    "timestamp": "2018-06-13 17:45:17.197",
    "logLevel": "DEBUG",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "GetPendingJobExecution",
    "protocol": "MQTT",
    "clientId": "299966ad-54de-40b4-99d3-4fc8b52da0c5",
    "topicName": "$aws/things/299966ad-54de-40b4-99d3-4fc8b52da0c5/jobs/get",
    "clientToken": "24b9a741-15a7-44fc-bd3c-1ff2e34e5e82",
    "details": "The request status is SUCCESS."
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten GetPendingJobExecution Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
clientToken: Ein eindeutiger Bezeichner, bei dem die Groß- und Kleinschreibung beachtet werden muss, um die Idempotenz der Anforderung sicherzustellen. Weitere Informationen finden Sie unter So wird Idempotenz sichergestellt.
Details: Weitere Informationen über den Jobs-Service.
Protokoll: Das für die Anforderung verwendete Protokoll. Gültige Werte sind MQTT oder HTTP.
topicName: Der Name des abonnierten Themas.

ReportFinalJobExecutionCount Log-Eintrag

Der AWS IoT Jobs-Dienst generiert einen Protokolleintrag mit einem entryType oderReportFinalJobExecutionCount, wenn ein Job abgeschlossen ist.

ReportFinalJobExecutionCount Beispiel für einen Logeintrag


{
    "timestamp": "2017-08-10 19:44:16.776",
    "logLevel": "INFO",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "ReportFinalJobExecutionCount",
    "jobId": "002",
    "details": "Job 002 completed. QUEUED job execution count: 0 IN_PROGRESS job execution count: 0 FAILED job execution count: 0 SUCCEEDED job execution count: 1 CANCELED job execution count: 0 REJECTED job execution count: 0 REMOVED job execution count: 0"
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten ReportFinalJobExecutionCount Protokolleinträge die folgenden Attribute:

Details: Weitere Informationen über den Jobs-Service.
jobId: Die Auftrags-ID für die Auftragsausführung.

StartNextPendingJobExecution Log-Eintrag

Wenn der AWS IoT Jobs-Dienst eine Anforderung erhält, die nächste ausstehende Auftragsausführung zu starten, generiert er einen Protokolleintrag mit dem Wert eventType vonStartNextPendingJobExecution.

StartNextPendingJobExecution Beispiel für einen Protokolleintrag


{
    "timestamp": "2018-06-13 17:49:51.036",
    "logLevel": "DEBUG",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "StartNextPendingJobExecution",
    "protocol": "MQTT",
    "clientId": "95c47808-b1ca-4794-bc68-a588d6d9216c",
    "topicName": "$aws/things/95c47808-b1ca-4794-bc68-a588d6d9216c/jobs/start-next",
    "clientToken": "bd7447c4-3a05-49f4-8517-dd89b2c68d94",
    "details": "The request status is SUCCESS."
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten StartNextPendingJobExecution Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
clientToken: Ein eindeutiger Bezeichner, bei dem die Groß- und Kleinschreibung beachtet werden muss, um die Idempotenz der Anforderung sicherzustellen. Weitere Informationen finden Sie unter So wird Idempotenz sichergestellt.
Details: Weitere Informationen über den Jobs-Service.
Protokoll: Das für die Anforderung verwendete Protokoll. Gültige Werte sind MQTT oder HTTP.
topicName: Das für die Anforderung verwendete Thema.

UpdateJobExecution Log-Eintrag

Der AWS IoT Jobs-Dienst generiert einen Protokolleintrag mit einem eventType oderUpdateJobExecution, wenn der Dienst eine Anforderung zur Aktualisierung einer Auftragsausführung erhält.

UpdateJobExecution Beispiel für einen Protokolleintrag


{
    "timestamp": "2017-08-10 19:25:14.758",
    "logLevel": "DEBUG",
    "accountId": "123456789012",
    "status": "Success",
    "eventType": "UpdateJobExecution",
    "protocol": "MQTT",
    "clientId": "thingOne",
    "jobId": "002",
    "topicName": "$aws/things/thingOne/jobs/002/update",
    "clientToken": "myClientToken",
    "versionNumber": "1",
    "details": "The destination status is IN_PROGRESS. The request status is SUCCESS."
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten UpdateJobExecution Protokolleinträge die folgenden Attribute:

clientId: Die ID des Clients, der die Anforderung stellt.
clientToken: Ein eindeutiger Bezeichner, bei dem die Groß- und Kleinschreibung beachtet werden muss, um die Idempotenz der Anforderung sicherzustellen. Weitere Informationen finden Sie unter So wird Idempotenz sichergestellt.
Details: Weitere Informationen über den Jobs-Service.
jobId: Die Auftrags-ID für die Auftragsausführung.
Protokoll: Das für die Anforderung verwendete Protokoll. Gültige Werte sind MQTT oder HTTP.
topicName: Das für die Anforderung verwendete Thema.
versionNumber: Die Version der Auftragsausführung.

Protokolleinträge für Gerätebereitstellung

Der AWS IoT Device Provisioning-Dienst generiert Protokolle für die folgenden Ereignisse.

Themen

GetDeviceCredentials Protokolleintrag
ProvisionDevice Eintrag protokollieren

GetDeviceCredentials Protokolleintrag

Der AWS IoT Device Provisioning-Dienst generiert einen Protokolleintrag mit einem eventType oder, GetDeviceCredential wenn ein Client anruftGetDeviceCredential.

GetDeviceCredentials Beispiel für einen Protokolleintrag


{
  "timestamp" : "2019-02-20 20:31:22.932",
  "logLevel" : "INFO",
  "traceId" : "8d9c016f-6cc7-441e-8909-7ee3d5563405",
  "accountId" : "123456789101",
  "status" : "Success",
  "eventType" : "GetDeviceCredentials",
  "deviceCertificateId" : "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "details" : "Additional details about this log."
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten GetDeviceCredentials Protokolleinträge die folgenden Attribute:

Details: Eine kurze Erläuterung des Fehlers.
Gerät CertificateId: Die ID des Gerätezertifikats.

ProvisionDevice Eintrag protokollieren

Der AWS IoT Device Provisioning-Dienst generiert einen Protokolleintrag mit einem eventType oder, ProvisionDevice wenn ein Client anruftProvisionDevice.

ProvisionDevice Beispiel für einen Protokolleintrag


{
  "timestamp" : "2019-02-20 20:31:22.932",
  "logLevel" : "INFO",
  "traceId" : "8d9c016f-6cc7-441e-8909-7ee3d5563405",
  "accountId" : "123456789101",
  "status" : "Success",
  "eventType" : "ProvisionDevice",
  "provisioningTemplateName" : "myTemplate",
  "deviceCertificateId" : "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "details" : "Additional details about this log."
 }

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten ProvisionDevice Protokolleinträge die folgenden Attribute:

Details: Eine kurze Erläuterung des Fehlers.
Gerät CertificateId: Die ID des Gerätezertifikats.
Bereitstellung TemplateName: Der Name der Bereitstellungsvorlage.

Protokolleinträge „Dynamische Objektgruppen“

AWS IoT Dynamische Dinggruppen generieren Protokolle für das folgende Ereignis.

Themen

AddThingToDynamicThingGroupsFailed Log-Eintrag

AddThingToDynamicThingGroupsFailed Log-Eintrag

Wenn AWS IoT den angegebenen dynamischen Gruppen nichts hinzugefügt werden konnte, wird ein Logeintrag mit dem Wert eventType von generiertAddThingToDynamicThingGroupsFailed. Dies geschieht, wenn ein Objekt die Kriterien für die Mitgliedschaft in der dynamischen Objektgruppe erfüllt, es aber der dynamischen Gruppe nicht hinzugefügt werden konnte oder es aus der dynamischen Gruppe entfernt wurde. Dies kann aus folgenden Gründen passieren:

Das Objekt gehört bereits der maximalen Anzahl von Gruppen an.
Mithilfe der Option --override-dynamic-groups wurde das Objekt zu einer statischen Objektgruppe hinzugefügt. Es wurde aus einer dynamischen Objektgruppe entfernt, um dies möglich zu machen.

Weitere Informationen finden Sie unter Dynamische Objektgruppen – Einschränkungen und Konflikte.

AddThingToDynamicThingGroupsFailed Beispiel für einen Logeintrag

In diesem Beispiel ist der Protokolleintrag für einen Fehler AddThingToDynamicThingGroupsFailed zu sehen. In diesem Beispiel TestThing erfüllte es die Kriterien, um zu den unter aufgeführten dynamischen Dinggruppen zu gehörendynamicThingGroupNames, konnte aber nicht zu diesen dynamischen Gruppen hinzugefügt werden, wie unter beschriebenreason.


{
 "timestamp": "2020-03-16 22:24:43.804",
 "logLevel": "ERROR",
 "traceId": "70b1f2f5-d95e-f897-9dcc-31e68c3e1a30",
 "accountId": "57EXAMPLE833",
 "status": "Failure",
 "eventType": "AddThingToDynamicThingGroupsFailed",
 "thingName": "TestThing",
 "dynamicThingGroupNames": [
  "DynamicThingGroup11",
  "DynamicThingGroup12",
  "DynamicThingGroup13",
  "DynamicThingGroup14"
 ],
 "reason": "The thing failed to be added to the given dynamic thing group(s) because the thing already belongs to the maximum allowed number of groups."
}

Zusätzlich zu den Allgemeine CloudWatch Log-Attribute enthalten AddThingToDynamicThingGroupsFailed Protokolleinträge die folgenden Attribute:

dynamisch ThingGroupNames: Ein Array der dynamischen Objektgruppen, denen das Objekt nicht hinzugefügt werden konnte.
Grund: Der Grund, warum das Objekt nicht zu den dynamischen Objektgruppen hinzugefügt werden konnte.
thingName: Der Name des Objekts, das keiner dynamischen Objektgruppe hinzugefügt werden konnte.

Protokolleinträge für die Flottenindizierung

AWS IoT Die Flottenindizierung generiert Protokolleinträge für die folgenden Ereignisse.

Themen

NamedShadowCountForDynamicGroupQueryLimitExceeded Protokolleintrag

NamedShadowCountForDynamicGroupQueryLimitExceeded Protokolleintrag

Für Abfragebegriffe, die nicht datenquellenspezifisch sind, werden in dynamischen Gruppen maximal 25 benannte Schatten pro Objekt verarbeitet. Wird dieses Limit für ein Objekt überschritten, wird der Ereignistyp NamedShadowCountForDynamicGroupQueryLimitExceeded ausgegeben.

NamedShadowCountForDynamicGroupQueryLimitExceeded Beispiel für einen Protokolleintrag

In diesem Beispiel ist der Protokolleintrag für einen Fehler NamedShadowCountForDynamicGroupQueryLimitExceeded zu sehen. In diesem Beispiel können Ergebnisse, die ausschließlich auf Werten DynamicGroup basieren, ungenau sein, wie im Feld reason beschrieben.


{
"timestamp": "2020-03-16 22:24:43.804",
"logLevel": "ERROR",
"traceId": "70b1f2f5-d95e-f897-9dcc-31e68c3e1a30",
"accountId": "571032923833",
"status": "Failure",
"eventType": "NamedShadowCountForDynamicGroupQueryLimitExceeded",
"thingName": "TestThing",
"reason": "A maximum of 25 named shadows per thing are processed for non-data source specific query terms in dynamic groups."
}

Allgemeine CloudWatch Log-Attribute

Alle CloudWatch Log-Logeinträge enthalten die folgenden Attribute:

accountId: Ihre AWS-Konto ID.
eventType: Der Ereignistyp, für den das Protokoll generiert wurde. Der Wert des Ereignistyps hängt vom Ereignis ab, das den Protokolleintrag generiert hat. Jede Beschreibung des Protokolleintrags enthält den Wert von eventType für diesen Protokolleintrag.
logLevel: Die verwendete Protokollierungsebene. Weitere Informationen finden Sie unter Protokollstufen.
Status: Der Status der Anforderung.
Zeitstempel: Der UNIX-Zeitstempel für den Zeitpunkt, an dem der Client eine Verbindung zum AWS IoT -Message Broker hergestellt hat.
traceId: Eine zufällig erstellte Kennung, die verwendet werden kann, um alle Protokolle für eine bestimmte Anforderung zu korrelieren.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Überwachen AWS IoT mithilfe von Protokollen CloudWatch

Laden Sie geräteseitige Protokolle auf Amazon hoch CloudWatch

CloudWatch Protokolle AWS IoT Einträge protokollieren

Themen

Message Broker-Protokolleinträge

Themen

Protokolleintrag „Connect“

Beispiel für den Protokolleintrag „Connect“

Protokolleintrag „Disconnect“

Beispiel für den Protokolleintrag „Disconnect“

Ping-Logeintrag

Wichtig

Beispiel für einen Ping-Logeintrag (erfolgreich)

Beispiel für einen Ping-Logeintrag (Fehler)

Connection.AuthNError Log-Eintrag

Wichtig

Anmerkung

Connection.AuthNError Beispiel für einen Logeintrag

Connection.AuthNError Fehlercodes

DeleteConnection Log-Eintrag

DeleteConnection Beispiel für einen Logeintrag

GetRetainedMessage Log-Eintrag

GetRetainedMessage Beispiel für einen Logeintrag

ListRetainedMessage Log-Eintrag

ListRetainedMessage Beispiel für einen Logeintrag

ListSubscriptions Log-Eintrag

ListSubscriptions Beispiel für einen Logeintrag

GetConnection Log-Eintrag

GetConnection Beispiel für einen Logeintrag

Publish-In Log-Eintrag

Publish-In Beispiel für einen Logeintrag

Publish-Out Log-Eintrag

Publish-Out Beispiel für einen Protokolleintrag

Protokolleintrag in der Warteschlange

Beispiel für einen Eintrag in das Fehlerprotokoll eines Servers in der Warteschlange

Serverfehler

Beispiel für einen Eintrag in einem Erfolgsprotokoll in der Warteschlange

Beispiel für einen gedrosselten Protokolleintrag in der Warteschlange

Beim Einstellen einer Offline-Nachricht in die Warteschlange gedrosselt

Protokolleintrag „Subscribe“

Beispiel für den Protokolleintrag in MQTT-3-Subscribe

Beispiel für den Protokolleintrag in MQTT-5-Subscribe

Protokolleintrag abbestellen

Beispiel für einen MQTT-Logeintrag zum Abbestellen

SendDirectMessage Log-Eintrag

SendDirectMessage Beispiel für einen Erfolgsprotokolleintrag

SendDirectMessage Beispiel für einen Fehlerprotokolleintrag

Ursachencodes

OCSP-Protokolleinträge des Serverzertifikats

Themen

RetrieveOCSPStapleData Log-Eintrag

RetrieveOCSPStapleData Beispiele für Protokolleinträge

RetrieveOCSPStapleData Protokolleintrag für private Endpunkte

RetrieveOCSPStapleData Beispiele für Protokolleinträge für private Endpunkte

Protokolleinträge „Geräteschatten“

Themen

DeleteThingShadow Protokolleintrag

DeleteThingShadow Beispiel für einen Protokolleintrag

GetThingShadow Eintrag protokollieren

GetThingShadow Beispiel für einen Protokolleintrag

UpdateThingShadow Eintrag protokollieren

UpdateThingShadow Beispiel für einen Protokolleintrag

Protokolleinträge zur Regel-Engine

Themen

FunctionExecution Log-Eintrag

FunctionExecution Beispiel für einen Logeintrag

RuleExecution Log-Eintrag

RuleExecution Beispiel für einen Logeintrag

RuleExecution Beispiel für einen Batch-Logeintrag

RuleMatch Protokolleintrag

RuleMatch Beispiel für einen Logeintrag

RuleEvaluation gedrosselter Protokolleintrag

RuleEvaluation Beispiel für einen gedrosselten Protokolleintrag

RuleExecutionThrottled Log-Eintrag

RuleExecutionThrottled Beispiel für einen Protokolleintrag

RuleNotFound Log-Eintrag

RuleNotFound Beispiel für einen Logeintrag

StartingRuleExecution Log-Eintrag

StartingRuleExecution Beispiel für einen Logeintrag

Auftrag-Protokolleinträge

Themen

DescribeJobExecution Log-Eintrag

`Serverfehler`

`Beim Einstellen einer Offline-Nachricht in die Warteschlange gedrosselt`