CloudWatch Protokolliert, AWS IoT Protokolleinträge. - AWS IoT Core
Message Broker-ProtokolleinträgeOCSP-Protokolleinträge für ServerzertifikateProtokolleinträge „Geräteschatten“Protokolleinträge zur Regel-EngineAuftrag-ProtokolleinträgeProtokolleinträge für GerätebereitstellungProtokolleinträge „Dynamische Objektgruppen“Protokolleinträge für die FlottenindizierungAllgemeine CloudWatch Log-Attribute

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.

CloudWatch Protokolliert, AWS IoT Protokolleinträge.

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.

Message Broker-Protokolleinträge

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

Protokolleintrag „Connect“

Der AWS IoT Message Broker generiert einen Logeintrag mit einem eventType of, 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
}

Neben Allgemeine CloudWatch Log-Attribute enthalten Connect-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.

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 eventType of, Disconnect wenn ein 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"
}

Neben Allgemeine CloudWatch Log-Attribute enthalten Disconnect-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.

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.

GetRetainedMessage Protokolleintrag

Der AWS IoT Message Broker generiert einen Logeintrag mit der Angabe eventTypeGetRetainedMessage, wann er aufgerufen GetRetainedMessagewird.

GetRetainedMessage 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": "GetRetainedMessage", 
    "protocol": "HTTP",
    "topicName": "a/b/c",
    "qos": "1",
    "lastModifiedDate": "2017-08-07 18:47:56.664"
}

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

zuletzt ModifiedDate

Das Datum und die Uhrzeit der Epoche in Millisekunden, von der die gespeicherte 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 Eintrag protokollieren

Der AWS IoT Message Broker generiert einen Logeintrag mit der Angabe eventTypeListRetainedMessage, wann er aufgerufen ListRetainedMessageswird.

ListRetainedMessage 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": "ListRetainedMessage", 
    "protocol": "HTTP"
}

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

Protokoll

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

Protokolleintrag „Publish-in“

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

Beispiel für den Protokolleintrag „Publish-in“

{
        "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"
    }

Neben 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.

Protokolleintrag „Publish-Out“

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

Beispiel für den Protokolleintrag „Publish-Out“

{
    "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
}

Neben 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 von. Queued Weitere Informationen 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"
}

Neben Allgemeine CloudWatch Log-Attribute enthalten Queued Server-Fehler-Protokolleinträge die folgenden Attribute:

clientId

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

Details
Server Error

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"
}

Neben Allgemeine CloudWatch Log-Attribute enthalten Queued erfolgreiche Protokolleinträ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"
}

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

clientId

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

Details
Throttled while queueing offline message

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.

Protokolleintrag „Subscribe“

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

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

{
    "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
}

Neben Allgemeine CloudWatch Log-Attribute enthalten Subscribe-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.

sourceIp

Die IP-Adresse, von der die Anforderung stammt.

sourcePort

Der Port, von dem die Anforderung stammt.

topicName

Der Name des abonnierten Themas.

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

{
	"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.

OCSP-Protokolleinträge für Serverzertifikate

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

Rufen Sie den OCSP-Protokolleintrag StapleData ab

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

Beispiele für OCSP-Logeinträge abrufen StapleData

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",
	"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 ProtokolleintragFailure.

{
	"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.

Verbindungsdetails

Eine kurze Erklärung 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

    Der OCSP-Responder-URI, der vom 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

Einzelheiten 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

Einzelheiten 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 wurde.

  • 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.

  • geheftete Größe DataPayload

    Die Nutzdatengröße der gehefteten Daten.

Protokolleinträge „Geräteschatten“

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

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"
}

Neben 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"
}

Neben 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"
}

Neben 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:

FunctionExecution Protokolleintrag

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 Protokolleintrag

{
    "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"
}

Neben 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 Protokolleintrag

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

RuleExecution Beispiel für einen Protokolleintrag

{
    "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"
}

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 Protokolleintrag mit dem Zeichen eventType vonRuleMatch, wenn der Message Broker eine Nachricht empfängt, die einer Regel entspricht.

RuleMatch Beispiel für einen Protokolleintrag

{
    "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"
}

Neben 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.

RuleExecutionThrottled Protokolleintrag

Wenn eine Ausführung gedrosselt wird, 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": "RuleMessageThrottled",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "topicName": "$aws/rules/example_rule",
    "ruleName": "example_rule",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "reason": "RuleExecutionThrottled",
    "details": "Exection of Rule example_rule throttled"
}

Neben 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 Eintrag protokollieren

Wenn die AWS IoT Regelengine eine Regel mit einem bestimmten Namen nicht finden kann, generiert sie einen Protokolleintrag mit dem Wert eventType vonRuleNotFound.

RuleNotFound 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": "RuleNotFound",
    "clientId": "abf27092886e49a8a5c1922749736453",
    "topicName": "$aws/rules/example_rule",
    "ruleName": "example_rule",
    "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
    "reason": "RuleNotFound",
    "details": "Rule example_rule not found"
}

Neben 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 Eintrag protokollieren

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

StartingRuleExecution Beispiel für einen Protokolleintrag

{
    "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"
}

Neben 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.

DescribeJobExecution Protokolleintrag

Der AWS IoT Jobs-Service generiert einen Protokolleintrag mit eventType der Angabe vonDescribeJobExecution, wenn der Dienst eine Anfrage zur Beschreibung einer Jobausfü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."
}

Neben 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 Protokolleintrag

Der AWS IoT Jobs-Dienst generiert einen Protokolleintrag mit der Angabe „eventTypeVon“GetPendingJobExecution, wenn der Dienst eine Anfrage 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."
}

Neben 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 Protokolleintrag

Der AWS IoT Jobs-Dienst generiert einen Protokolleintrag mit der Angabe „entryTypeVon“ReportFinalJobExecutionCount, wenn ein Job abgeschlossen ist.

ReportFinalJobExecutionCount Beispiel für einen Protokolleintrag

{
    "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"
}

Neben 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 Protokolleintrag

Wenn der AWS IoT Jobs-Service eine Anforderung zum Starten der nächsten ausstehenden Auftragsausführung erhält, 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."
}

Neben 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 Protokolleintrag

Der AWS IoT Jobs-Dienst generiert einen Protokolleintrag mit eventType der Angabe vonUpdateJobExecution, wenn der Dienst eine Anforderung zur Aktualisierung einer Jobausfü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."
}

Neben 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.

GetDeviceCredentials Protokolleintrag

Der AWS IoT Device Provisioning-Dienst generiert einen Protokolleintrag mit der Angabe „Von“GetDeviceCredential, wenn ein Client anruftGetDeviceCredential. eventType

GetDeviceBeispiel für einen Logeintrag mit Anmeldeinformationen

{
  "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."
}

Neben 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 der Angabe „Von“ProvisionDevice, wenn ein Client anruftProvisionDevice. eventType

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."
 }

Neben 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.

AddThingToDynamicThingGroupsFailed Protokolleintrag

Wenn AWS IoT den angegebenen dynamischen Gruppen nichts hinzugefügt werden konnte, wird ein Protokolleintrag 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 Protokolleintrag

In diesem Beispiel ist der Protokolleintrag für einen Fehler AddThingToDynamicThingGroupsFailed zu sehen. In diesem Beispiel wurden die Kriterien für die Aufnahme in die unter aufgeführten dynamischen Dinggruppen TestThingerfülltdynamicThingGroupNames, es 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."
}

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

dynamische ThingGroup Namen

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 Bei der Flottenindizierung werden Protokolleinträge für die folgenden Ereignisse generiert.

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-Log-Einträ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.