

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
<a name="cwl-format"></a>

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.

**Topics**
+ [Message Broker-Protokolleinträge](#message-broker-logs)
+ [OCSP-Protokolleinträge für Serverzertifikate](#server-ocsp-logs)
+ [Protokolleinträge „Geräteschatten“](#device-shadow-logs)
+ [Protokolleinträge zur Regel-Engine](#rule-engine-logs)
+ [Auftrag-Protokolleinträge](#job-logs)
+ [Protokolleinträge für Gerätebereitstellung](#provision-logs)
+ [Protokolleinträge „Dynamische Objektgruppen“](#dynamic-group-logs)
+ [Protokolleinträge für die Flottenindizierung](#fleet-indexing-logs)
+ [Allgemeine CloudWatch Log-Attribute](#cwl-common-attributes)

## Message Broker-Protokolleinträge
<a name="message-broker-logs"></a>

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

**Topics**
+ [Protokolleintrag „Connect“](#log-mb-connect)
+ [Protokolleintrag „Disconnect“](#log-mb-disconnect)
+ [DeleteConnection Protokolleintrag](#log-mb-delete-connection)
+ [GetRetainedMessage Protokolleintrag](#log-mb-get-retain)
+ [ListRetainedMessage Eintrag protokollieren](#log-mb-list-retain)
+ [Protokolleintrag „Publish-in“](#log-mb-publish-in)
+ [Protokolleintrag „Publish-Out“](#log-mb-publish-out)
+ [Protokolleintrag in der Warteschlange](#log-mb-queued)
+ [Protokolleintrag „Subscribe“](#log-mb-subscribe)
+ [Protokolleintrag abbestellen](#log-mb-unsubscribe)

### Protokolleintrag „Connect“
<a name="log-mb-connect"></a>

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“
<a name="log-mb-connect.example"></a>

```
{
    "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 enthalten [Allgemeine CloudWatch Log-Attribute](#cwl-common-attributes) die `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“
<a name="log-mb-disconnect"></a>

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“
<a name="log-mb-disconnect.example"></a>

```
{
    "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 enthalten [Allgemeine CloudWatch Log-Attribute](#cwl-common-attributes) die `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.

### DeleteConnection Protokolleintrag
<a name="log-mb-delete-connection"></a>

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

#### DeleteConnection Beispiel für einen Logeintrag
<a name="log-mb-delete-connection.example"></a>

```
{
    "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](#cwl-common-attributes) enthalten `DeleteConnection` Protokolleinträge die folgenden Attribute:

clientId  
Die ID des Clients, zu dem die Verbindung unterbrochen wird.

principalId  
Die ID des Prinzipals, der die Anforderung stellt. Informationen zur Identifizierung des Prinzipals anhand der Prinzipal-ID finden Sie unter [Vergleichen von IAM-Identitäten und Anmeldeinformationen](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_identity-management.html) im *IAM-Benutzerhandbuch*. 

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 Protokolleintrag
<a name="log-mb-get-retain"></a>

Der AWS IoT Message Broker generiert einen Logeintrag mit der Angabe `eventType``GetRetainedMessage`, wann er aufgerufen [https://docs.aws.amazon.com//iot/latest/developerguide/API_iotdata_GetRetainedMessage.html](https://docs.aws.amazon.com//iot/latest/developerguide/API_iotdata_GetRetainedMessage.html)wird.

#### GetRetainedMessage Beispiel für einen Protokolleintrag
<a name="log-mb-get-retain-example"></a>

```
{
    "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](#cwl-common-attributes) enthalten `GetRetainedMessage` Protokolleinträge die folgenden Attribute:

lastModifiedDate  
Das Datum und die Uhrzeit der Epoche in Millisekunden, zu 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
<a name="log-mb-list-retain"></a>

Der AWS IoT Message Broker generiert einen Logeintrag mit der Angabe `eventType``ListRetainedMessage`, wann er aufgerufen [/iot/latest/developerguide/API_iotdata_ListRetainedMessages.html](/iot/latest/developerguide/API_iotdata_ListRetainedMessages.html)wird.

#### ListRetainedMessage Beispiel für einen Protokolleintrag
<a name="log-mb-list-retain-example"></a>

```
{
    "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 dem [Allgemeine CloudWatch Log-Attribute](#cwl-common-attributes) enthalten `ListRetainedMessage` Protokolleinträge das folgende Attribut:

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

### Protokolleintrag „Publish-in“
<a name="log-mb-publish-in"></a>

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

#### Beispiel für den Protokolleintrag „Publish-in“
<a name="log-mb-publish-in.example"></a>

```
{
        "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 enthalten [Allgemeine CloudWatch Log-Attribute](#cwl-common-attributes) die `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](mqtt.md#mqtt-retain).

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“
<a name="log-mb-publish-out"></a>

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“
<a name="log-mb-publish-out.example"></a>

```
{
    "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](#cwl-common-attributes) 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
<a name="log-mb-queued"></a>

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 Hinweise zu persistenten MQTT-Sitzungen finden Sie unter. [Persistente MQTT-Sitzungen](mqtt.md#mqtt-persistent-sessions)

#### Beispiel für einen Eintrag in das Fehlerprotokoll eines Servers in der Warteschlange
<a name="log-mb-queued.server-error.example"></a>

```
{
    "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 enthalten [Allgemeine CloudWatch Log-Attribute](#cwl-common-attributes) die Einträge im `Queued` Serverfehlerprotokoll 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
<a name="log-mb-queued.success.example"></a>

```
{
    "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 enthalten [Allgemeine CloudWatch Log-Attribute](#cwl-common-attributes) die Einträge im `Queued` Erfolgsprotokoll 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
<a name="log-mb-queued.throttled.example"></a>

```
{
    "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](#cwl-common-attributes) `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](https://docs.aws.amazon.com//general/latest/gr/iot-core.html#genref_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“
<a name="log-mb-subscribe"></a>

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
<a name="log-mb-connect.example.subscribe"></a>

```
{
    "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 enthalten [Allgemeine CloudWatch Log-Attribute](#cwl-common-attributes) die `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. 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. 

#### Beispiel für den Protokolleintrag in MQTT-5-Subscribe
<a name="log-mb-connect.example.subscribe.mqtt5"></a>

```
{
	"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](#cwl-common-attributes) und den [MQTT 3-Subscribe-Protokolleintragsattributen das folgende Attribut](#log-mb-connect.example.subscribe): `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](https://docs.aws.amazon.com//iot/latest/developerguide/mqtt.html#mqtt5-reason-codes). 

### Protokolleintrag abbestellen
<a name="log-mb-unsubscribe"></a>

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

#### Beispiel für einen MQTT-Abmelde-Logeintrag
<a name="log-mb-connect.example.unsubscribe"></a>

```
{
    "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](#cwl-common-attributes) enthalten `Unsubscribe` Protokolleinträ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.

## OCSP-Protokolleinträge für Serverzertifikate
<a name="server-ocsp-logs"></a>

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

**Topics**
+ [OCSPStapleDatenprotokolleintrag abrufen](#log-retrieve-ocsp-staple)
+ [OCSPStapleDatenprotokolleintrag für private Endpunkte abrufen](#log-retrieve-ocsp-staple-private-endpoint)

### OCSPStapleDatenprotokolleintrag abrufen
<a name="log-retrieve-ocsp-staple"></a>

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

#### Beispiele für OCSPStaple Datenprotokolleinträge abrufen
<a name="log-retrieve-ocsp-staple.example"></a>

Im Folgenden finden Sie ein Beispiel für einen Protokolleintrag`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 Protokolleintrag`Failure`. 

```
{
	"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](#cwl-common-attributes) Protokolleinträge zusätzlich zu den die folgenden Attribute:

Grund  
Der Grund, warum der Vorgang fehlschlägt.

domainConfigName  
Der Name Ihrer Domain-Konfiguration.

Verbindungsdetails  
Eine kurze Erklärung der Verbindungsdetails.  
+ httpStatusCode

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

  Die OCSP-Responder-URI, die vom Serverzertifikat AWS IoT Core abgerufen wird.
+ sourceIp

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

  Die Ziel-IP-Adresse des OCSP-Responders.

ocspRequestDetails  
Details der OCSP-Anfrage.  
+ Name des Anforderers

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

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

ocspResponseDetails  
Details der OCSP-Antwort.  
+ responseCertId

  Die Zertifikat-ID der OCSP-Antwort. 
+ ocspResponseStatus

  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.
+ thisUpdateTime

  Der Zeitpunkt, zu dem der angezeigte Status bekanntermaßen korrekt ist.
+ nextUpdateTime

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

  Der Zeitpunkt, zu dem der OCSP-Responder diese Antwort signiert hat.
+ stapledDataPayloadGröße

  Die Nutzdatengröße der gehefteten Daten.

### OCSPStapleDatenprotokolleintrag für private Endpunkte abrufen
<a name="log-retrieve-ocsp-staple-private-endpoint"></a>

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

#### Rufen Sie Beispiele OCSPStaple für Datenprotokolleinträge für private Endpunkte ab
<a name="log-retrieve-ocsp-staple-private-endpoint.example"></a>

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`Failure`. 

```
{
	"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 Protokolleinträge für private Endgeräte zusätzlich zu den Attributen [Allgemeine CloudWatch Log-Attribute](#cwl-common-attributes) und den Attributen im [Protokolleintrag „OCSPStapleDaten abrufen](https://docs.aws.amazon.com//iot/latest/developerguide/cwl-format.html#log-retrieve-ocsp-staple)“ die folgenden Attribute:

Lambda-Details  
Einzelheiten der Lambda-Funktion.  
+ LambdaWarn

  ARN der Lambda-Funktion.
+ Quelle: RN

  Der ARN der Domänenkonfiguration.

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

## Protokolleinträge „Geräteschatten“
<a name="device-shadow-logs"></a>

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

**Topics**
+ [DeleteThingShadow Protokolleintrag](#log-shadow-delete-thing-shadow)
+ [GetThingShadow Protokolleintrag](#log-shadow-get-thing-shadow)
+ [UpdateThingShadow Protokolleintrag](#log-shadow-update-thing-shadow)

### DeleteThingShadow Protokolleintrag
<a name="log-shadow-delete-thing-shadow"></a>

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
<a name="log-shadow-delete-thing-shadow.example"></a>

```
{
    "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](#cwl-common-attributes) enthalten `DeleteThingShadow` Protokolleinträge die folgenden Attribute:

deviceShadowName  
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 Protokolleintrag
<a name="log-shadow-get-thing-shadow"></a>

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
<a name="log-shadow-get-thing-shadow.example"></a>

```
{
    "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](#cwl-common-attributes) enthalten `GetThingShadow` Protokolleinträge die folgenden Attribute:

deviceShadowName  
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 Protokolleintrag
<a name="log-shadow-update-thing-shadow"></a>

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
<a name="log-shadow-update-thing-shadow.example"></a>

```
{
    "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](#cwl-common-attributes) enthalten `UpdateThingShadow` Protokolleinträge die folgenden Attribute:

deviceShadowName  
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
<a name="rule-engine-logs"></a>

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

**Topics**
+ [FunctionExecution Protokolleintrag](#log-rules-fn-exec)
+ [RuleExecution Protokolleintrag](#log-rules-rule-ex)
+ [RuleMatch Protokolleintrag](#log-rules-rule-match)
+ [RuleExecutionThrottled Protokolleintrag](#log-rules-rule-msg-throttled)
+ [RuleNotFound Eintrag protokollieren](#log-rules-rule-not-found)
+ [StartingRuleExecution Eintrag protokollieren](#log-rules-start-rule-ex)

### FunctionExecution Protokolleintrag
<a name="log-rules-fn-exec"></a>

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` oder`machinelearning_predict`). 

#### FunctionExecution Beispiel für einen Protokolleintrag
<a name="log-rules-fn-exec.example"></a>

```
{
    "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](#cwl-common-attributes) 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
<a name="log-rules-rule-ex"></a>

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

#### RuleExecution Beispiel für einen Protokolleintrag
<a name="log-rules-rule-ex.example"></a>

```
{
    "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 mit Beispiel für einen Batching-Protokolleintrag
<a name="log-rules-rule-ex-batching.example"></a>

```
{
    "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](#cwl-common-attributes) 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
<a name="log-rules-rule-match"></a>

Die AWS IoT Regel-Engine generiert einen Protokolleintrag mit dem Zeichen `eventType` von`RuleMatch`, wenn der Message Broker eine Nachricht empfängt, die einer Regel entspricht.

#### RuleMatch Beispiel für einen Protokolleintrag
<a name="log-rules-rule-match.example"></a>

```
{
    "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](#cwl-common-attributes) 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
<a name="log-rules-rule-msg-throttled"></a>

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
<a name="log-rules-rule-msg-throttled.example"></a>

```
{
    "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](#cwl-common-attributes) 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
<a name="log-rules-rule-not-found"></a>

Wenn das AWS IoT Regelmodul eine Regel mit einem bestimmten Namen nicht finden kann, generiert es einen Protokolleintrag mit dem Wert `eventType` von`RuleNotFound`. 

#### RuleNotFound Beispiel für einen Protokolleintrag
<a name="log-rules-rule-not-found.example"></a>

```
{
    "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](#cwl-common-attributes) 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
<a name="log-rules-start-rule-ex"></a>

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

#### StartingRuleExecution Beispiel für einen Protokolleintrag
<a name="log-rules-start-rule-ex.example"></a>

```
{
    "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](#cwl-common-attributes) 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
<a name="job-logs"></a>

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.

**Topics**
+ [DescribeJobExecution Protokolleintrag](#log-job-describe-job-ex)
+ [GetPendingJobExecution Protokolleintrag](#log-job-get-pending-job-ex)
+ [ReportFinalJobExecutionCount Protokolleintrag](#log-job-report-final-job-ex-count)
+ [StartNextPendingJobExecution Protokolleintrag](#log-job-start-next-pending-job-ex)
+ [UpdateJobExecution Protokolleintrag](#log-job-update-job-ex)

### DescribeJobExecution Protokolleintrag
<a name="log-job-describe-job-ex"></a>

Der AWS IoT Jobs-Service generiert einen Protokolleintrag mit `eventType` der Angabe von`DescribeJobExecution`, wenn der Dienst eine Anfrage zur Beschreibung einer Jobausführung erhält.

#### DescribeJobExecution Beispiel für einen Protokolleintrag
<a name="log-job-describe-job-ex.example"></a>

```
{
    "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](#cwl-common-attributes) 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](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html). 

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
<a name="log-job-get-pending-job-ex"></a>

Der AWS IoT Jobs-Dienst generiert einen Protokolleintrag mit der Angabe „`eventType`Von“`GetPendingJobExecution`, wenn der Dienst eine Anfrage zur Auftragsausführung erhält.

#### GetPendingJobExecution Beispiel für einen Protokolleintrag
<a name="log-job-get-pending-job-ex.example"></a>

```
{
    "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](#cwl-common-attributes) 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](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html). 

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
<a name="log-job-report-final-job-ex-count"></a>

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

#### ReportFinalJobExecutionCount Beispiel für einen Protokolleintrag
<a name="log-job-report-final-job-ex-count.example"></a>

```
{
    "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](#cwl-common-attributes) 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
<a name="log-job-start-next-pending-job-ex"></a>

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` von`StartNextPendingJobExecution`. 

#### StartNextPendingJobExecution Beispiel für einen Protokolleintrag
<a name="log-job-start-next-pending-job-ex.example"></a>

```
{
    "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](#cwl-common-attributes) 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](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html). 

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
<a name="log-job-update-job-ex"></a>

Der AWS IoT Jobs-Dienst generiert einen Protokolleintrag mit `eventType` der Angabe von`UpdateJobExecution`, wenn der Dienst eine Anforderung zur Aktualisierung einer Jobausführung erhält.

#### UpdateJobExecution Beispiel für einen Protokolleintrag
<a name="log-job-update-job-ex.example"></a>

```
{
    "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](#cwl-common-attributes) 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](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html). 

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
<a name="provision-logs"></a>

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

**Topics**
+ [GetDeviceCredentials Protokolleintrag](#log-provision-get-device-credentials)
+ [ProvisionDevice Protokolleintrag](#log-provision-provision-device)

### GetDeviceCredentials Protokolleintrag
<a name="log-provision-get-device-credentials"></a>

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



#### GetDeviceCredentials Beispiel für einen Protokolleintrag
<a name="log-provision-get-device-credentials.example"></a>

```
{
  "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](#cwl-common-attributes) enthalten `GetDeviceCredentials` Protokolleinträge die folgenden Attribute:

Details  
Eine kurze Erläuterung des Fehlers.

deviceCertificateId  
Die ID des Gerätezertifikats.

### ProvisionDevice Protokolleintrag
<a name="log-provision-provision-device"></a>

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

#### ProvisionDevice Beispiel für einen Protokolleintrag
<a name="log-provision-provision-device.example"></a>

```
{
  "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](#cwl-common-attributes) enthalten `ProvisionDevice` Protokolleinträge die folgenden Attribute:

Details  
Eine kurze Erläuterung des Fehlers.

deviceCertificateId  
Die ID des Gerätezertifikats.

provisioningTemplateName  
Der Name der Bereitstellungsvorlage.

## Protokolleinträge „Dynamische Objektgruppen“
<a name="dynamic-group-logs"></a>

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

**Topics**
+ [AddThingToDynamicThingGroupsFailed Protokolleintrag](#log-dynthing-add-thing-to-dynamic-thing-groups-failed)

### AddThingToDynamicThingGroupsFailed Protokolleintrag
<a name="log-dynthing-add-thing-to-dynamic-thing-groups-failed"></a>

Wenn AWS IoT den angegebenen dynamischen Gruppen nichts hinzugefügt werden konnte, wird ein Protokolleintrag mit dem Wert `eventType` von generiert`AddThingToDynamicThingGroupsFailed`. 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](dynamic-thing-groups.md#dynamic-thing-group-limitations). 

#### AddThingToDynamicThingGroupsFailed Beispiel für einen Protokolleintrag
<a name="log-dynthing-add-thing-to-dynamic-thing-groups-failed.example"></a>

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 *TestThing*erfüllt`dynamicThingGroupNames`, es konnte aber nicht zu diesen dynamischen Gruppen hinzugefügt werden, wie unter beschrieben`reason`. 

```
{
 "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](#cwl-common-attributes) enthalten `AddThingToDynamicThingGroupsFailed` Protokolleinträge die folgenden Attribute:

dynamicThingGroupNamen  
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
<a name="fleet-indexing-logs"></a>

AWS IoT Bei der Flottenindizierung werden Protokolleinträge für die folgenden Ereignisse generiert.

**Topics**
+ [NamedShadowCountForDynamicGroupQueryLimitExceeded Protokolleintrag](#log-named-shadow-dynamic-group)

### NamedShadowCountForDynamicGroupQueryLimitExceeded Protokolleintrag
<a name="log-named-shadow-dynamic-group"></a>

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
<a name="log-named-shadow-dynamic-group.example"></a>

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
<a name="cwl-common-attributes"></a>

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](configure-logging.md#log-level).

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.