

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Monitore AWS IoT usando CloudWatch registros
<a name="cloud-watch-logs"></a>

Quando o [AWS IoT registro está ativado](configure-logging.md), AWS IoT envia eventos de progresso sobre cada mensagem à medida que ela passa de seus dispositivos por meio do agente de mensagens e do mecanismo de regras. No [CloudWatch console](https://console.aws.amazon.com/cloudwatch), CloudWatch os registros aparecem em um grupo de **AWSIotregistros chamado Registros**. 

Para obter mais informações sobre CloudWatch registros, consulte [CloudWatch Registros](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html). Para obter informações sobre AWS IoT CloudWatch os registros compatíveis, consulte[CloudWatch Registra entradas AWS IoT de registro](cwl-format.md).

## Visualizando AWS IoT registros no CloudWatch console
<a name="viewing-logs"></a>

**nota**  
O grupo de `AWSIotLogsV2` registros não estará visível no CloudWatch console até:  
Você ativou o login AWS IoT. Para obter mais informações sobre como ativar o login AWS IoT, consulte [Configurar o AWS IoT registro](configure-logging.md) 
Algumas entradas de registro foram gravadas por AWS IoT operações.

**Para ver seus AWS IoT registros no CloudWatch console**

1.  Navegue para [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). No painel de navegação, escolha a opção **Grupos de logs**. 

1. Na caixa de texto **Filtro**, digite **AWSIotLogsV2** e, depois, pressione Enter.

1. Clique duas vezes no grupo de logs `AWSIotLogsV2`.

1. Escolha **Pesquisar tudo**. Uma lista completa dos AWS IoT registros gerados para sua conta é exibida.

1. Escolha o ícone de expansão para ver um fluxo individual.

Você também pode inserir uma consulta na caixa de texto **Filtrar eventos**. Estas são algumas consultas interessantes para experimentar:
+  `{ $.logLevel = "INFO" }` 

   Encontre todos os logs que têm um nível de log de `INFO`. 
+  `{ $.status = "Success" }` 

   Encontre todos os logs que têm um status de `Success`. 
+  `{ $.status = "Success" && $.eventType = "GetThingShadow" }` 

   Encontre todos os logs que têm um status de `Success` e um tipo de evento de `GetThingShadow`. 

Para obter mais informações sobre a criação de expressões de filtro, consulte [Consultas de CloudWatch registros](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html). 

# CloudWatch Registra entradas AWS IoT de registro
<a name="cwl-format"></a>

Cada componente do AWS IoT gera suas próprias entradas de registro. Cada entrada de log tem um `eventType` que especifica a operação que fez com que a entrada de log fosse gerada. Esta seção descreve as entradas de log geradas pelos seguintes componentes da AWS IoT .

**Topics**
+ [

## Entradas de log do agente de mensagens
](#message-broker-logs)
+ [

## Entradas de log OCSP do certificado do servidor
](#server-ocsp-logs)
+ [

## Entradas de log da sombra do dispositivo
](#device-shadow-logs)
+ [

## Entradas de log do mecanismo de regras
](#rule-engine-logs)
+ [

## Entradas de log de tarefas
](#job-logs)
+ [

## Entradas de log de provisionamento de dispositivos
](#provision-logs)
+ [

## Entradas de log de grupo dinâmico de objetos
](#dynamic-group-logs)
+ [

## Entradas de log de indexação de frota
](#fleet-indexing-logs)
+ [

## CloudWatch Atributos de registros comuns
](#cwl-common-attributes)

## Entradas de log do agente de mensagens
<a name="message-broker-logs"></a>

O agente de AWS IoT mensagens gera entradas de registro para os seguintes eventos:

**Topics**
+ [

### Entrada de log de conexão
](#log-mb-connect)
+ [

### Entrada de log de desconexão
](#log-mb-disconnect)
+ [

### DeleteConnection entrada de registro
](#log-mb-delete-connection)
+ [

### GetRetainedMessage entrada de registro
](#log-mb-get-retain)
+ [

### ListRetainedMessage entrada de registro
](#log-mb-list-retain)
+ [

### Entrada de log de publicação de entrada
](#log-mb-publish-in)
+ [

### Entrada de log de publicação de saída
](#log-mb-publish-out)
+ [

### Entrada de log em fila
](#log-mb-queued)
+ [

### Entrada de log de assinatura
](#log-mb-subscribe)
+ [

### Entrada de log de cancelamento de assinatura
](#log-mb-unsubscribe)

### Entrada de log de conexão
<a name="log-mb-connect"></a>

O agente de AWS IoT mensagens gera uma entrada de registro com um `eventType` of `Connect` quando um cliente MQTT se conecta.

#### Exemplo de entrada de log de conexão
<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
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `Connect` registro contêm os seguintes atributos:

clientId  
O ID do cliente que está fazendo a solicitação.

principalId  
O ID da entidade principal que está fazendo a solicitação.

protocolo  
O protocolo usado para fazer a solicitação. Os valores válidos são `MQTT` ou `HTTP`. 

sourceIp  
O endereço IP no qual a solicitação foi originada.

sourcePort  
A porta em que a solicitação foi originada.

### Entrada de log de desconexão
<a name="log-mb-disconnect"></a>

O agente de AWS IoT mensagens gera uma entrada de registro com um `eventType` of `Disconnect` quando um cliente MQTT se desconecta.

#### Exemplo de entrada de log de desconexão
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `Disconnect` registro contêm os seguintes atributos:

clientId  
O ID do cliente que está fazendo a solicitação.

principalId  
O ID da entidade principal que está fazendo a solicitação.

protocolo  
O protocolo usado para fazer a solicitação. Os valores válidos são `MQTT` ou `HTTP`. 

sourceIp  
O endereço IP no qual a solicitação foi originada.

sourcePort  
A porta em que a solicitação foi originada.

razão  
A razão pela qual o cliente está se desconectando.

detalhes  
Uma breve explicação do erro.

disconnectReason  
A razão pela qual o cliente está se desconectando.

### DeleteConnection entrada de registro
<a name="log-mb-delete-connection"></a>

O agente de AWS IoT mensagens gera uma entrada de registro com um `eventType` de `DeleteConnection` quando uma conexão do cliente MQTT é excluída.

#### DeleteConnection exemplo de entrada de registro
<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
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `DeleteConnection` registro contêm os seguintes atributos:

clientId  
O ID do cliente que será desconectado.

principalId  
O ID da entidade principal que está fazendo a solicitação. Para ter informações sobre como identificar a entidade principal usando o ID da entidade principal, consulte [Comparar identidades e credenciais do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_identity-management.html) do *Guia usuário do IAM*. 

protocolo  
O protocolo usado para fazer a solicitação. O valor válido é `HTTP`. 

sourceIp  
O endereço IP no qual a solicitação foi originada.

sourcePort  
A porta em que a solicitação foi originada.

### GetRetainedMessage entrada de registro
<a name="log-mb-get-retain"></a>

O agente de AWS IoT mensagens gera uma entrada de registro com um `eventType` de `GetRetainedMessage` quando [https://docs.aws.amazon.com//iot/latest/developerguide/API_iotdata_GetRetainedMessage.html](https://docs.aws.amazon.com//iot/latest/developerguide/API_iotdata_GetRetainedMessage.html)é chamado.

#### GetRetainedMessage exemplo de entrada de registro
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `GetRetainedMessage` registro contêm os seguintes atributos:

lastModifiedDate  
A data e a hora da Epoch, em milissegundos, em que a mensagem retida foi armazenada por. AWS IoT

protocolo  
O protocolo usado para fazer a solicitação. Valor válido: `HTTP`. 

qos  
O nível Qualidade de Serviço (QoS) usado na solicitação de publicação. Os valores válidos são `0` ou `1`. 

topicName  
O nome do tópico que você assinou. 

### ListRetainedMessage entrada de registro
<a name="log-mb-list-retain"></a>

O agente de AWS IoT mensagens gera uma entrada de registro com um `eventType` de `ListRetainedMessage` quando [/iot/latest/developerguide/API_iotdata_ListRetainedMessages.html](/iot/latest/developerguide/API_iotdata_ListRetainedMessages.html)é chamado.

#### ListRetainedMessage exemplo de entrada de registro
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `ListRetainedMessage` registro contêm o seguinte atributo:

protocolo  
O protocolo usado para fazer a solicitação. Valor válido: `HTTP`. 

### Entrada de log de publicação de entrada
<a name="log-mb-publish-in"></a>

Quando o agente de AWS IoT mensagens recebe uma mensagem MQTT, ele gera uma entrada de registro com um `eventType` de`Publish-In`. 

#### Exemplo de entrada de log de publicação de entrada
<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"
    }
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `Publish-In` registro contêm os seguintes atributos:

clientId  
O ID do cliente que está fazendo a solicitação.

principalId  
O ID da entidade principal que está fazendo a solicitação.

protocolo  
O protocolo usado para fazer a solicitação. Os valores válidos são `MQTT` ou `HTTP`. 

reter  
O atributo usado quando uma mensagem tem o sinalizador Reter definido com um valor de `True`. Se a mensagem não tiver o sinalizador Reter definido, esse atributo não aparecerá na entrada do log. Para obter mais informações, consulte [Mensagens retidas do MQTT](mqtt.md#mqtt-retain).

sourceIp  
O endereço IP no qual a solicitação foi originada.

sourcePort  
A porta em que a solicitação foi originada.

topicName  
O nome do tópico que você assinou. 

### Entrada de log de publicação de saída
<a name="log-mb-publish-out"></a>

Quando o agente de mensagens publica uma mensagem MQTT, ele gera um log com um `eventType` de `Publish-Out`. 

#### Exemplo de entrada de log de publicação de saída
<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
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `Publish-Out` registro contêm os seguintes atributos:

clientId  
O ID do cliente assinante que recebe mensagens sobre esse tópico do MQTT.

principalId  
O ID da entidade principal que está fazendo a solicitação.

protocolo  
O protocolo usado para fazer a solicitação. Os valores válidos são `MQTT` ou `HTTP`. 

sourceIp  
O endereço IP no qual a solicitação foi originada.

sourcePort  
A porta em que a solicitação foi originada.

topicName  
O nome do tópico que você assinou. 

### Entrada de log em fila
<a name="log-mb-queued"></a>

Quando um dispositivo com uma sessão persistente é desconectado, o agente de mensagens MQTT armazena as mensagens do dispositivo e AWS IoT gera entradas de registro com um EventType de. `Queued` Para obter mais informações sobre sessões persistentes do MQTT, consulte[Sessões persistentes do MQTT](mqtt.md#mqtt-persistent-sessions).

#### Exemplo de entrada de log de erros do servidor em fila
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas do registro de erros do `Queued` servidor contêm os seguintes atributos:

clientId  
O ID do cliente para o qual a mensagem está na fila.

detalhes  
**`Server Error`**  
Um erro no servidor impediu que a mensagem fosse armazenada.

protocolo  
O protocolo usado para fazer a solicitação. O valor sempre será `MQTT`. 

qos  
O nível de qualidade do serviço (QoS) da solicitação. O valor sempre será 1 porque as mensagens com QoS de 0 não são armazenadas.

topicName  
O nome do tópico que você assinou.

#### Exemplo de entrada de log de sucesso em fila
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas do registro de `Queued` sucesso contêm os seguintes atributos:

clientId  
O ID do cliente para o qual a mensagem está na fila.

protocolo  
O protocolo usado para fazer a solicitação. O valor sempre será `MQTT`. 

qos  
O nível de qualidade do serviço (QoS) da solicitação. O valor sempre será 1 porque as mensagens com QoS de 0 não são armazenadas.

topicName  
O nome do tópico que você assinou.

#### Exemplo de entrada de log mantida em fila
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de registro `Queued` limitadas contêm os seguintes atributos:

clientId  
O ID do cliente para o qual a mensagem está na fila.

detalhes  
**`Throttled while queueing offline message`**  
O cliente excedeu o limite de ` [Queued messages per second per account](https://docs.aws.amazon.com//general/latest/gr/iot-core.html#genref_queued_messages_per_second_per_account) `, então a mensagem não foi armazenada.

protocolo  
O protocolo usado para fazer a solicitação. O valor sempre será `MQTT`. 

qos  
O nível de qualidade do serviço (QoS) da solicitação. O valor sempre será 1 porque as mensagens com QoS de 0 não são armazenadas.

topicName  
O nome do tópico que você assinou.

### Entrada de log de assinatura
<a name="log-mb-subscribe"></a>

O agente de AWS IoT mensagens gera uma entrada de registro com um `eventType` de `Subscribe` quando um cliente MQTT se inscreve em um tópico.

#### Exemplo de entrada de log de assinatura MQTT 3
<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
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `Subscribe` registro contêm os seguintes atributos:

clientId  
O ID do cliente que está fazendo a solicitação.

principalId  
O ID da entidade principal que está fazendo a solicitação.

protocolo  
O protocolo usado para fazer a solicitação. O valor sempre será `MQTT`. 

sourceIp  
O endereço IP no qual a solicitação foi originada.

sourcePort  
A porta em que a solicitação foi originada.

topicName  
O nome do tópico que você assinou. 

#### Exemplo de entrada de log de assinatura MQTT 5
<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
}
```

Para operações de assinatura do MQTT 5, além do [CloudWatch Atributos de registros comuns](#cwl-common-attributes) e dos [atributos de entrada de log e de assinatura do MQTT 3](#log-mb-connect.example.subscribe), as entradas de log do MQTT 5 `Subscribe` contêm o seguinte atributo: 

assinaturas  
Uma lista de mapeamentos entre os tópicos solicitados na solicitação de assinatura e o código de motivo individual do MQTT 5. Para obter mais informações, consulte [Códigos de motivo do MQTT](https://docs.aws.amazon.com//iot/latest/developerguide/mqtt.html#mqtt5-reason-codes). 

### Entrada de log de cancelamento de assinatura
<a name="log-mb-unsubscribe"></a>

O agente de AWS IoT mensagens gera uma entrada de registro com um `eventType` de `Unsubscribe` quando um cliente MQTT cancela a assinatura de um tópico do MQTT.

#### Exemplo de entrada de log de cancelamento de assinatura MQTT
<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
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `Unsubscribe` registro contêm os seguintes atributos:

protocolo  
O protocolo usado para fazer a solicitação. O valor sempre será `MQTT`. 

clientId  
O ID do cliente que está fazendo a solicitação.

principalId  
O ID da entidade principal que está fazendo a solicitação.

sourceIp  
O endereço IP no qual a solicitação foi originada.

sourcePort  
A porta em que a solicitação foi originada.

## Entradas de log OCSP do certificado do servidor
<a name="server-ocsp-logs"></a>

AWS IoT Core gera entradas de registro para o seguinte evento:

**Topics**
+ [

### Recuperar entrada do registro OCSPStaple de dados
](#log-retrieve-ocsp-staple)
+ [

### Recuperar entrada OCSPStaple de registro de dados para endpoints privados
](#log-retrieve-ocsp-staple-private-endpoint)

### Recuperar entrada do registro OCSPStaple de dados
<a name="log-retrieve-ocsp-staple"></a>

AWS IoT Core gera uma entrada de registro com um `eventType` of `RetrieveOCSPStapleData` quando o servidor recupera os dados básicos do OCSP.

#### Exemplos de entrada OCSPStaple de registro de dados
<a name="log-retrieve-ocsp-staple.example"></a>

A seguir está um exemplo de entrada de log de `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"
	}
}
```

A seguir está um exemplo de entrada de log de `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"
	}
}
```

Para a `RetrieveOCSPStaple` operação, além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de registro contêm os seguintes atributos:

reason  
A razão pela qual a operação falha.

domainConfigName  
O nome da configuração do domínio.

connectionDetails  
Uma breve explicação dos detalhes da conexão.  
+ httpStatusCode

  Códigos de status HTTP que são retornados pelo respondente OCSP em resposta à solicitação do cliente feita ao servidor.
+ ocspResponderUri

  O URI do respondente OCSP que AWS IoT Core obtém do certificado do servidor.
+ sourceIp

  O endereço IP de origem do AWS IoT Core servidor.
+ targetIp

  O endereço IP de destino do agente de resposta OCSP.

ocspRequestDetails  
Detalhes da solicitação OCSP.  
+ requesterName

  O identificador do AWS IoT Core servidor que envia uma solicitação ao respondente OCSP.
+ requestCertId

  O ID do certificado da solicitação. Esse é o ID do certificado para o qual a resposta OCSP está sendo solicitada.

ocspResponseDetails  
Detalhes da resposta do OCSP.  
+ responseCertId

  O ID do certificado da resposta OCSP. 
+ ocspResponseStatus

  O status da resposta do OCSP.
+ certStatus

  O status do certificado.
+ assinatura

  A assinatura aplicada à resposta por uma entidade confiável.
+ thisUpdateTime

  A hora em que se sabe que o status indicado está correto.
+ nextUpdateTime

  A hora igual ou anterior àquela em que as informações mais recentes estarão disponíveis sobre o status do certificado.
+ producedAtTime

  A hora em que o respondente OCSP assinou essa resposta.
+ stapledDataPayloadTamanho

  O tamanho da carga útil dos dados associados.

### Recuperar entrada OCSPStaple de registro de dados para endpoints privados
<a name="log-retrieve-ocsp-staple-private-endpoint"></a>

AWS IoT Core gera uma entrada de registro com um `eventType` of `RetrieveOCSPStapleData` quando o servidor recupera os dados básicos do OCSP.

#### Recupere exemplos de entrada OCSPStaple de registro de dados para endpoints privados
<a name="log-retrieve-ocsp-staple-private-endpoint.example"></a>

A seguir está um exemplo de entrada de log de `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"
	}
}
```

A seguir está um exemplo de entrada de log de `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"
	}
}
```

Para a `RetrieveOCSPStaple` operação, além dos atributos [CloudWatch Atributos de registros comuns](#cwl-common-attributes) e na [entrada de registro Recuperar OCSPStaple dados](https://docs.aws.amazon.com//iot/latest/developerguide/cwl-format.html#log-retrieve-ocsp-staple), as entradas de registro para endpoints privados contêm os seguintes atributos:

lambdaDetails  
Detalhes da função do Lambda.  
+ lambdaArn

  O ARN da função Lambda.
+ sourceArn

  O ARN da configuração do domínio.

authorizedResponderArn  
O ARN do respondente autorizador, se houver um definido na configuração do domínio.

## Entradas de log da sombra do dispositivo
<a name="device-shadow-logs"></a>

O serviço AWS IoT Device Shadow gera entradas de registro para os seguintes eventos:

**Topics**
+ [

### DeleteThingShadow entrada de registro
](#log-shadow-delete-thing-shadow)
+ [

### GetThingShadow entrada de registro
](#log-shadow-get-thing-shadow)
+ [

### UpdateThingShadow entrada de registro
](#log-shadow-update-thing-shadow)

### DeleteThingShadow entrada de registro
<a name="log-shadow-delete-thing-shadow"></a>

O serviço sombra do dispositivo gera uma entrada de log com um `eventType` de `DeleteThingShadow` quando uma solicitação para excluir a sombra de um dispositivo é recebida.

#### DeleteThingShadow exemplo de entrada de registro
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `DeleteThingShadow` registro contêm os seguintes atributos:

deviceShadowName  
O nome da sombra a ser atualizada.

protocolo  
O protocolo usado para fazer a solicitação. Os valores válidos são `MQTT` ou `HTTP`. 

topicName  
O nome do tópico no qual a solicitação foi publicada. 

### GetThingShadow entrada de registro
<a name="log-shadow-get-thing-shadow"></a>

O serviço Sombra do dispositivo gera uma entrada de log com um `eventType` de `GetThingShadow` quando uma solicitação para obter uma sombra é recebida.

#### GetThingShadow exemplo de entrada de registro
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `GetThingShadow` registro contêm os seguintes atributos:

deviceShadowName  
O nome da sombra solicitada.

protocolo  
O protocolo usado para fazer a solicitação. Os valores válidos são `MQTT` ou `HTTP`. 

topicName  
O nome do tópico no qual a solicitação foi publicada. 

### UpdateThingShadow entrada de registro
<a name="log-shadow-update-thing-shadow"></a>

O serviço Sombra do dispositivo gera uma entrada de log com um `eventType` de `UpdateThingShadow` quando uma solicitação para atualizar a sombra de um dispositivo é recebida.

#### UpdateThingShadow exemplo de entrada de registro
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `UpdateThingShadow` registro contêm os seguintes atributos:

deviceShadowName  
O nome da sombra a ser atualizada.

protocolo  
O protocolo usado para fazer a solicitação. Os valores válidos são `MQTT` ou `HTTP`. 

topicName  
O nome do tópico no qual a solicitação foi publicada. 

## Entradas de log do mecanismo de regras
<a name="rule-engine-logs"></a>

O mecanismo de AWS IoT regras gera registros para os seguintes eventos:

**Topics**
+ [

### FunctionExecution entrada de registro
](#log-rules-fn-exec)
+ [

### RuleExecution entrada de registro
](#log-rules-rule-ex)
+ [

### RuleMatch entrada de registro
](#log-rules-rule-match)
+ [

### RuleExecutionThrottled entrada de registro
](#log-rules-rule-msg-throttled)
+ [

### RuleNotFound entrada de registro
](#log-rules-rule-not-found)
+ [

### StartingRuleExecution entrada de registro
](#log-rules-start-rule-ex)

### FunctionExecution entrada de registro
<a name="log-rules-fn-exec"></a>

O mecanismo de regras gera uma entrada de log com um `eventType` de `FunctionExecution` quando uma consulta SQL de uma regra chama uma função externa. Uma função externa é chamada quando a ação de uma regra faz uma solicitação HTTP para AWS IoT ou outro serviço da Web (por exemplo, chamando `get_thing_shadow` ou`machinelearning_predict`). 

#### FunctionExecution exemplo de entrada de registro
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `FunctionExecution` registro contêm os seguintes atributos:

clientId  
 `N/A` para logs `FunctionExecution`.

principalId  
O ID da entidade principal que está fazendo a solicitação.

recursos  
Uma coleção de recursos usados pelas ações da regra.

ruleName  
O nome da regra correspondente.

topicName  
O nome do tópico que você assinou. 

### RuleExecution entrada de registro
<a name="log-rules-rule-ex"></a>

Quando o mecanismo de AWS IoT regras aciona a ação de uma regra, ele gera uma entrada de `RuleExecution` registro.

#### RuleExecution exemplo de entrada de registro
<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 com exemplo de entrada de registro em lote
<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
    }
}
```

Além do [CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de log `RuleExecution` contêm os seguintes atributos:

clientId  
O ID do cliente que está fazendo a solicitação.

principalId  
O ID da entidade principal que está fazendo a solicitação.

recursos  
Uma coleção de recursos usados pelas ações da regra.

ruleAction  
O nome da ação disparada.

ruleName  
O nome da regra correspondente.

topicName  
O nome do tópico que você assinou. 

### RuleMatch entrada de registro
<a name="log-rules-rule-match"></a>

O mecanismo de AWS IoT regras gera uma entrada de registro com um `eventType` de `RuleMatch` quando o agente de mensagens recebe uma mensagem que corresponde a uma regra.

#### RuleMatch exemplo de entrada de registro
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `RuleMatch` registro contêm os seguintes atributos:

clientId  
O ID do cliente que está fazendo a solicitação.

principalId  
O ID da entidade principal que está fazendo a solicitação.

ruleName  
O nome da regra correspondente.

topicName  
O nome do tópico que você assinou. 

### RuleExecutionThrottled entrada de registro
<a name="log-rules-rule-msg-throttled"></a>

Quando uma execução é limitada, o mecanismo de AWS IoT regras gera uma entrada de registro com um `eventType` de. `RuleExecutionThrottled` 

#### RuleExecutionThrottled exemplo de entrada de registro
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `RuleExecutionThrottled` registro contêm os seguintes atributos:

clientId  
O ID do cliente que está fazendo a solicitação.

detalhes  
Uma breve explicação do erro.

principalId  
O ID da entidade principal que está fazendo a solicitação.

reason  
A string "RuleExecutionThrottled”.

ruleName  
O nome da regra a ser acionada.

topicName  
O nome do tópico publicado.

### RuleNotFound entrada de registro
<a name="log-rules-rule-not-found"></a>

Quando o mecanismo de AWS IoT regras não consegue encontrar uma regra com um determinado nome, ele gera uma entrada de registro com um `eventType` de`RuleNotFound`. 

#### RuleNotFound exemplo de entrada de registro
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `RuleNotFound` registro contêm os seguintes atributos:

clientId  
O ID do cliente que está fazendo a solicitação.

detalhes  
Uma breve explicação do erro.

principalId  
O ID da entidade principal que está fazendo a solicitação.

reason  
A string "RuleNotFound”.

ruleName  
O nome da regra que não pôde ser encontrada.

topicName  
O nome do tópico publicado.

### StartingRuleExecution entrada de registro
<a name="log-rules-start-rule-ex"></a>

Quando o mecanismo de AWS IoT regras começa a acionar a ação de uma regra, ele gera uma entrada de registro com um `eventType` de`StartingRuleExecution`. 

#### StartingRuleExecution exemplo de entrada de registro
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `rule-` registro contêm os seguintes atributos:

clientId  
O ID do cliente que está fazendo a solicitação.

principalId  
O ID da entidade principal que está fazendo a solicitação.

ruleAction  
O nome da ação disparada.

ruleName  
O nome da regra correspondente.

topicName  
O nome do tópico que você assinou. 

## Entradas de log de tarefas
<a name="job-logs"></a>

O serviço AWS IoT Job gera entradas de registro para os seguintes eventos. As entradas de log são geradas quando uma solicitação HTTP ou MQTT é recebida do dispositivo.

**Topics**
+ [

### DescribeJobExecution entrada de registro
](#log-job-describe-job-ex)
+ [

### GetPendingJobExecution entrada de registro
](#log-job-get-pending-job-ex)
+ [

### ReportFinalJobExecutionCount entrada de registro
](#log-job-report-final-job-ex-count)
+ [

### StartNextPendingJobExecution entrada de registro
](#log-job-start-next-pending-job-ex)
+ [

### UpdateJobExecution entrada de registro
](#log-job-update-job-ex)

### DescribeJobExecution entrada de registro
<a name="log-job-describe-job-ex"></a>

O serviço AWS IoT Jobs gera uma entrada de registro com um `eventType` de `DescribeJobExecution` quando o serviço recebe uma solicitação para descrever a execução de um trabalho.

#### DescribeJobExecution exemplo de entrada de registro
<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."
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `GetJobExecution` registro contêm os seguintes atributos:

clientId  
O ID do cliente que está fazendo a solicitação.

clientToken  
Um identificador exclusivo e que diferencia maiúsculas e minúsculas, para garantir a idempotência da solicitação. Para obter mais informações, consulte [Como garantir a idempotência](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html). 

detalhes  
Outras informações do serviço Tarefas.

jobId  
O ID da tarefa para a execução do tarefa.

protocolo  
O protocolo usado para fazer a solicitação. Os valores válidos são `MQTT` ou `HTTP`. 

topicName  
O tópico usado para fazer a solicitação. 

### GetPendingJobExecution entrada de registro
<a name="log-job-get-pending-job-ex"></a>

O serviço AWS IoT Jobs gera uma entrada de registro com um `eventType` de `GetPendingJobExecution` quando o serviço recebe uma solicitação de execução de trabalho.

#### GetPendingJobExecution exemplo de entrada de registro
<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."
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `GetPendingJobExecution` registro contêm os seguintes atributos:

clientId  
O ID do cliente que está fazendo a solicitação.

clientToken  
Um identificador exclusivo e que diferencia maiúsculas e minúsculas, para garantir a idempotência da solicitação. Para obter mais informações, consulte [Como garantir a idempotência](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html). 

detalhes  
Outras informações do serviço Jobs.

protocolo  
O protocolo usado para fazer a solicitação. Os valores válidos são `MQTT` ou `HTTP`. 

topicName  
O nome do tópico que você assinou. 

### ReportFinalJobExecutionCount entrada de registro
<a name="log-job-report-final-job-ex-count"></a>

O serviço AWS IoT Jobs gera uma entrada de registro com um `entryType` de `ReportFinalJobExecutionCount` quando um trabalho é concluído.

#### ReportFinalJobExecutionCount exemplo de entrada de registro
<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"
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `ReportFinalJobExecutionCount` registro contêm os seguintes atributos:

detalhes  
Outras informações do serviço Tarefas.

jobId  
O ID da tarefa para a execução do tarefa.

### StartNextPendingJobExecution entrada de registro
<a name="log-job-start-next-pending-job-ex"></a>

Quando recebe uma solicitação para iniciar a próxima execução do trabalho pendente, o serviço AWS IoT Jobs gera uma entrada de registro com um `eventType` de`StartNextPendingJobExecution`. 

#### StartNextPendingJobExecution exemplo de entrada de registro
<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."
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `StartNextPendingJobExecution` registro contêm os seguintes atributos:

clientId  
O ID do cliente que está fazendo a solicitação.

clientToken  
Um identificador exclusivo e que diferencia maiúsculas e minúsculas, para garantir a idempotência da solicitação. Para obter mais informações, consulte [Como garantir a idempotência](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html). 

detalhes  
Outras informações do serviço Jobs.

protocolo  
O protocolo usado para fazer a solicitação. Os valores válidos são `MQTT` ou `HTTP`. 

topicName  
O tópico usado para fazer a solicitação. 

### UpdateJobExecution entrada de registro
<a name="log-job-update-job-ex"></a>

O serviço AWS IoT Jobs gera uma entrada de registro com um `eventType` de `UpdateJobExecution` quando o serviço recebe uma solicitação para atualizar a execução de um trabalho.

#### UpdateJobExecution exemplo de entrada de registro
<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."
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `UpdateJobExecution` registro contêm os seguintes atributos:

clientId  
O ID do cliente que está fazendo a solicitação.

clientToken  
Um identificador exclusivo e que diferencia maiúsculas e minúsculas, para garantir a idempotência da solicitação. Para obter mais informações, consulte [Como garantir a idempotência](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html). 

detalhes  
Outras informações do serviço Tarefas.

jobId  
O ID da tarefa para a execução do tarefa.

protocolo  
O protocolo usado para fazer a solicitação. Os valores válidos são `MQTT` ou `HTTP`. 

topicName  
O tópico usado para fazer a solicitação. 

versionNumber  
A versão da execução da tarefa.

## Entradas de log de provisionamento de dispositivos
<a name="provision-logs"></a>

O serviço de provisionamento de AWS IoT dispositivos gera registros para os seguintes eventos. 

**Topics**
+ [

### GetDeviceCredentials entrada de registro
](#log-provision-get-device-credentials)
+ [

### ProvisionDevice entrada de registro
](#log-provision-provision-device)

### GetDeviceCredentials entrada de registro
<a name="log-provision-get-device-credentials"></a>

O serviço de provisionamento de AWS IoT dispositivos gera uma entrada de registro com um `eventType` de `GetDeviceCredential` quando um cliente liga. `GetDeviceCredential` 



#### GetDeviceCredentials exemplo de entrada de registro
<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."
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `GetDeviceCredentials` registro contêm os seguintes atributos:

detalhes  
Uma breve explicação do erro.

deviceCertificateId  
O ID do certificado do dispositivo.

### ProvisionDevice entrada de registro
<a name="log-provision-provision-device"></a>

O serviço de provisionamento de AWS IoT dispositivos gera uma entrada de registro com um `eventType` de `ProvisionDevice` quando um cliente liga. `ProvisionDevice` 

#### ProvisionDevice exemplo de entrada de registro
<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."
 }
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `ProvisionDevice` registro contêm os seguintes atributos:

detalhes  
Uma breve explicação do erro.

deviceCertificateId  
O ID do certificado do dispositivo.

provisioningTemplateName  
O nome do modelo de provisionamento.

## Entradas de log de grupo dinâmico de objetos
<a name="dynamic-group-logs"></a>

AWS IoT Os Dynamic Thing Groups geram registros para o seguinte evento.

**Topics**
+ [

### AddThingToDynamicThingGroupsFailed entrada de registro
](#log-dynthing-add-thing-to-dynamic-thing-groups-failed)

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

Quando não AWS IoT foi possível adicionar algo aos grupos dinâmicos especificados, ele gera uma entrada de registro com um `eventType` de`AddThingToDynamicThingGroupsFailed`. Isso acontece quando um objeto atendia aos critérios para estar no grupo dinâmico e, no entanto, não pôde ser adicionada ao grupo dinâmico ou foi removida do grupo dinâmico. Isso pode acontecer em função de:
+ A objeto já pertence ao número máximo de grupos.
+ A opção **--override-dynamic-groups** foi usada para adicionar o objeto a um grupo de objetos estáticas. Foi removido de um grupo dinâmico de objetos para tornar isso possível.

Para obter mais informações, consulte [Limitações e conflitos de grupo de objetos dinâmicas](dynamic-thing-groups.md#dynamic-thing-group-limitations). 

#### AddThingToDynamicThingGroupsFailed exemplo de entrada de registro
<a name="log-dynthing-add-thing-to-dynamic-thing-groups-failed.example"></a>

Este exemplo mostra a entrada de log de um erro `AddThingToDynamicThingGroupsFailed`. Neste exemplo, *TestThing*atendeu aos critérios para estar nos grupos de coisas dinâmicas listados em`dynamicThingGroupNames`, mas não pôde ser adicionado a esses grupos dinâmicos, conforme descrito em`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."
}
```

Além do[CloudWatch Atributos de registros comuns](#cwl-common-attributes), as entradas de `AddThingToDynamicThingGroupsFailed` registro contêm os seguintes atributos:

dynamicThingGroupNomes  
Uma matriz dos grupos de objetos dinâmicas aos quais o objeto não foi adicionada.

reason  
A razão pela qual o objeto não foi adicionada aos grupos de objetos dinâmicas.

thingName  
O nome do objeto que não foi adicionada a um grupo de objetos dinâmicas.

## Entradas de log de indexação de frota
<a name="fleet-indexing-logs"></a>

AWS IoT a indexação da frota gera entradas de registro para os seguintes eventos.

**Topics**
+ [

### NamedShadowCountForDynamicGroupQueryLimitExceeded entrada de registro
](#log-named-shadow-dynamic-group)

### NamedShadowCountForDynamicGroupQueryLimitExceeded entrada de registro
<a name="log-named-shadow-dynamic-group"></a>

No máximo 25 sombras nomeadas por objeto são processadas para termos de consulta que não são específicos da fonte de dados em grupos dinâmicos. Quando esse limite é violado para algo, o tipo de evento `NamedShadowCountForDynamicGroupQueryLimitExceeded` será emitido.

#### NamedShadowCountForDynamicGroupQueryLimitExceeded exemplo de entrada de registro
<a name="log-named-shadow-dynamic-group.example"></a>

Este exemplo mostra a entrada de log de um erro `NamedShadowCountForDynamicGroupQueryLimitExceeded`. Neste exemplo, os `DynamicGroup` resultados baseados em todos os valores podem ser imprecisos, conforme descrito no campo `reason`.

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

## CloudWatch Atributos de registros comuns
<a name="cwl-common-attributes"></a>

Todas as entradas de registro de CloudWatch registros incluem os seguintes atributos:

accountId  
Sua Conta da AWS identidade.

eventType  
O tipo de evento para o qual o log foi gerado. O valor do tipo de evento depende do evento que gerou a entrada de log. Cada descrição de entrada de log inclui o valor de `eventType` para essa entrada de log.

logLevel  
O nível de log que está sendo usado. Para obter mais informações, consulte [Níveis de logs](configure-logging.md#log-level).

status  
O status da solicitação.

timestamp  
A data e hora do UNIX legíveis de quando o cliente se conectou ao agente de mensagens da AWS IoT .

traceId  
Um identificador gerado aleatoriamente que pode ser usado para correlacionar todos os logs para uma solicitação específica.