Entradas de log do agente de mensagens Entradas de log OCSP do certificado do servidor Entradas de log da sombra do dispositivo Entradas de log do mecanismo de regras Entradas de log de tarefas Entradas de log de provisionamento de dispositivos Entradas de log de grupo dinâmico de objetos Entradas de log de indexação de frota CloudWatch Atributos de registros comuns

CloudWatch Registros AWS IoT entradas de registro

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 .

Tópicos

Entradas de log do agente de mensagens
Entradas de log OCSP do certificado do servidor
Entradas de log da sombra do dispositivo
Entradas de log do mecanismo de regras
Entradas de log de tarefas
Entradas de log de provisionamento de dispositivos
Entradas de log de grupo dinâmico de objetos
Entradas de log de indexação de frota
CloudWatch Atributos de registros comuns

Entradas de log do agente de mensagens

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

Tópicos

Entrada de log de conexão
Entrada de log de desconexão
Entrada do log de ping
Connection.AuthNError entrada de registro
DeleteConnection entrada de registro
GetRetainedMessage entrada de registro
ListRetainedMessage entrada de registro
ListSubscriptions entrada de registro
GetConnection entrada de registro
Publish-In entrada de registro
Publish-Out entrada de registro
Entrada de log em fila
Entrada de log de assinatura
Entrada de log de cancelamento de assinatura
SendDirectMessage entrada de registro

Entrada de log de conexão

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


{
    "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 doCloudWatch Atributos de registros comuns, 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

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


{
    "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 doCloudWatch Atributos de registros comuns, 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.

Entrada do log de ping

O agente de AWS IoT mensagens gera uma entrada de registro com um eventType of Ping quando processa um MQTT PINGREQ de um cliente conectado e envia o PINGRESP correspondente. Uma única entrada de registro é emitida por operação de ping.

Importante

As entradas do log de ping são opcionais e desativadas por padrão. O limite de emissão corresponde ao resultado por entrada: as entradas de sucesso são emitidas no DEBUG nível e as entradas de falha são emitidas no nível. ERROR Como resultado, você verá entradas de falha de Ping sempre que o nível do evento ou a Resource-specific substituição que se aplica à conexão estiver definido como ERROR ou em um nível mais detalhado (WARN,, ouDEBUG)INFO, mas as entradas de sucesso do Ping serão publicadas somente quando esse nível estiver definido como. DEBUG Para definir essas configurações, consulte Configurar conta e Event-level fazer login AWS IoT (CLI) Configurar Resource-specific substituições em AWS IoT (CLI) e.

No sucesso, o logLevel é DEBUG e o status éSuccess. Em caso de falha (por exemplo, quando a conexão do cliente é encerrada antes que o PINGRESP possa ser enviado), o logLevel é ERROR e o é. status Failure

Exemplo de entrada de log de ping (sucesso)


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

Exemplo de entrada de log de ping (falha)


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

Além do CloudWatch Atributos de registros comuns, as entradas de log Ping contêm os seguintes atributos:

protocolo: O protocolo usado para fazer a solicitação. O valor é sempre MQTT.
latência: O tempo em milissegundos entre o recebimento do PINGREQ e o envio do PINGRESP. Esse campo está presente somente quando o status éSuccess.
Carimbo de data/hora da solicitação: A data e hora em que AWS IoT Core recebi o PINGREQ do cliente.
Timestamp de resposta: O carimbo de data/hora quando o PINGRESP AWS IoT Core foi enviado ao cliente. Esse campo está presente somente quando o status éSuccess.
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.
razão: O motivo da falha na operação Ping. Esse campo está presente somente quando o status éFailure.
detalhes: Uma breve explicação do erro. Esse campo está presente somente quando o status éFailure.

Connection.AuthNError entrada de registro

O agente de AWS IoT mensagens gera uma entrada de registro com um eventType de Connection.AuthNError quando uma tentativa de conexão do cliente é rejeitada devido a uma falha de autenticação. O logLevel para esta entrada de registro é sempre ERROR e o status é sempreFailure. Essa entrada de registro corresponde à Connection.AuthNError CloudWatchmétrica.

Importante

Connection.AuthNErroras entradas de registro são opcionais e desativadas por padrão. Eles são emitidos no nível do ERROR registro, portanto, uma entrada de Connection.AuthNError registro é publicada somente quando o nível do evento ou a Resource-specific substituição que se aplica à conexão é definido como ERROR ou em um nível mais detalhado (, ou). WARN INFO DEBUG Para definir essas configurações, consulte Configurar conta e Event-level fazer login AWS IoT (CLI) Configurar Resource-specific substituições em AWS IoT (CLI) e.

nota

Essa entrada de registro é publicada para o Conta da AWS proprietário da Indicação de Nome do Servidor (SNI) fornecida no handshake TLS. Se o cliente não fornecer um SNI ou o SNI não puder ser resolvido em uma conta, nenhuma entrada de registro ou métrica será emitida.

Connection.AuthNError exemplo de entrada de registro


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

Além do CloudWatch Atributos de registros comuns, as entradas de log Connection.AuthNError contêm os seguintes atributos:

protocolo: O protocolo usado para fazer a solicitação. Os valores válidos são MQTT ou HTTP.
Tipo de autenticação: O tipo de autenticação usado para a tentativa de conexão. Os valores válidos são AWS_X509, AWS_SIGV4, CUSTOM_AUTH e CUSTOM_AUTH_X509.
clientId: O ID do cliente que fez a solicitação, se disponível.
principalId: O ID do diretor que fez a solicitação, se disponível.
sourceIp: O endereço IP no qual a solicitação foi originada.
sourcePort: A porta em que a solicitação foi originada.
targetIp: O endereço IP de destino da conexão. Esse campo pode não estar presente em todas as entradas de registro.
Porta de destino: A porta de destino da conexão.
servidor NameIndication: O nome do host da extensão TLS Server Name Indication (SNI) fornecido pelo cliente.
reason: O motivo pelo qual a autenticação do cliente falhou. Consulte Connection.AuthNError códigos de erro para obter uma lista de valores possíveis.
detalhes: Uma breve descrição da falha na autenticação.

Connection.AuthNError códigos de erro

A tabela a seguir lista os códigos de reason erro e as details mensagens correspondentes que podem aparecer em uma entrada de Connection.AuthNError registro. Códigos de erro adicionais podem ser adicionados no futuro.

Código de erro	Mensagem de erro
`CUSTOM_AUTHORIZER_LAMBDA_EXECUTION_ERROR`	Falha na invocação Lambda do autorizador personalizado
`CUSTOM_AUTHORIZER_NOT_FOUND`	Não foi possível encontrar o autorizador personalizado
`CUSTOM_AUTHORIZER_PARAMETER_INVALID`	O parâmetro de autenticação personalizado é inválido
`DEVICE_CERTIFICATE_INACTIVE`	O certificado do dispositivo não está ativo
`DEVICE_CERTIFICATE_NOT_REGISTERED`	O certificado do dispositivo não está registrado
`DEVICE_CERTIFICATE_REVOKED`	O certificado do dispositivo foi revogado
`DOMAIN_CONFIGURATION_DISABLED`	A configuração do domínio para a Indicação de Nome do Servidor (SNI) fornecida está desativada
`DOMAIN_CONFIGURATION_INVALID`	O tipo de endpoint na configuração do domínio é inválido
`INTERNAL_SERVER_ERROR`	Erro interno do servidor
`NOT_AUTHENTICATED`	As credenciais fornecidas não puderam ser autenticadas
`SECURITY_TOKEN_EXPIRED`	O token de segurança expirou
`SECURITY_TOKEN_INVALID`	O token de segurança incluído na solicitação é inválido
`SECURITY_TOKEN_SIGNATURE_MISMATCH`	A assinatura da solicitação não corresponde à assinatura fornecida
`SNI_MISUSED`	O cliente usou um SNI que não está associado a essa conta

DeleteConnection entrada de registro

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


{
    "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 doCloudWatch Atributos de registros comuns, 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 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

O agente de AWS IoT mensagens gera uma entrada de registro com um eventType de GetRetainedMessage quando GetRetainedMessageé chamado.

GetRetainedMessage exemplo de entrada de registro


{
    "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 doCloudWatch Atributos de registros comuns, as entradas de GetRetainedMessage registro contêm os seguintes atributos:

último ModifiedDate: 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

O agente de AWS IoT mensagens gera uma entrada de registro com um eventType de ListRetainedMessage quando ListRetainedMessagesé chamado.

ListRetainedMessage exemplo de entrada de registro


{
    "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 doCloudWatch Atributos de registros comuns, as entradas de ListRetainedMessage registro contêm o seguinte atributo:

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

ListSubscriptions entrada de registro

O agente de AWS IoT mensagens gera uma entrada de registro com um eventType de ListSubscriptions quando uma solicitação para listar assinaturas de clientes é recebida.

ListSubscriptions exemplo de entrada de registro


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

Além do CloudWatch Atributos de registros comuns, as entradas de log ListSubscriptions 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. 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.
maxResults: O número máximo de resultados solicitados.

GetConnection entrada de registro

O agente de AWS IoT mensagens gera uma entrada de registro com um eventType de GetConnection quando uma solicitação para obter informações de conexão é recebida.

GetConnection exemplo de entrada de registro


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

Além do CloudWatch Atributos de registros comuns, as entradas de log GetConnection 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. Valor válido: HTTP.
sourceIp: O endereço IP de origem da solicitação de API.
sourcePort: A porta na qual a solicitação de API foi originada.

Publish-In entrada de registro

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

Publish-In exemplo de entrada de registro


{
        "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 doCloudWatch Atributos de registros comuns, 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.
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.

Publish-Out entrada de registro

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

Publish-Out exemplo de entrada de registro


{
    "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 doCloudWatch Atributos de registros comuns, 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

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, consulteSessões persistentes do MQTT.

Exemplo de entrada de log de erros do servidor em fila


{
    "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 doCloudWatch Atributos de registros comuns, 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: Erro do servidor

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


{
    "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 doCloudWatch Atributos de registros comuns, 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


{
    "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 doCloudWatch Atributos de registros comuns, 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: Limitado ao enfileirar mensagens off-line

O cliente excedeu o limite de 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.

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.


{
    "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 doCloudWatch Atributos de registros comuns, 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.


{
	"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 e dos atributos de entrada de log e de assinatura do MQTT 3, 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.

Entrada de log de cancelamento de assinatura

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


{
    "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 doCloudWatch Atributos de registros comuns, 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.

SendDirectMessage entrada de registro

O agente de AWS IoT mensagens gera uma entrada de registro com um eventType de SendDirectMessage quando uma solicitação de SendDirectMessage API é feita.

AWS IoT Core registra SendDirectMessage eventos em CloudWatch Logs quando você ativa o registro de IoT. Para obter mais informações sobre como configurar o registro em log, consulteConfigurar AWS IoT registro em log.

SendDirectMessage exemplo de entrada de registro de sucesso


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

SendDirectMessage exemplo de entrada de registro de falhas


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

Além do CloudWatch Atributos de registros comuns, as entradas de log SendDirectMessage contêm os seguintes atributos:

clientId: O ID do cliente que está recebendo a mensagem direta.
topicName: O tópico no qual a mensagem foi enviada.
protocolo: O protocolo usado para fazer a solicitação. Valor válido: HTTP.
confirmação: Se a confirmação da entrega foi solicitada. Os valores válidos são true ou false.
timeout: Tempo máximo, em segundos, para aguardar uma confirmação de entrega do cliente destinatário. Presente somente quando confirmation estátrue.
reason: O código do motivo da falha.
detalhes: Uma breve explicação do erro.
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.

Códigos de motivo

Os seguintes códigos de motivo e detalhes aparecerão nas entradas do registro de falhas:

SendDirectMessage códigos de motivo
Motivo	Detalhes
`MALFORMED_CLIENTID`	Esse ID de cliente não é válido. Os IDs do cliente não devem exceder 128 caracteres e não podem começar com um cifrão ($). Insira um ID de cliente diferente
`INVALID_TOPIC`	Esse tópico não é válido. O tamanho dos tópicos precisa estar dentro de 256 bytes, deve conter menos de 9 partes e não deve começar com um cifrão ($)
`INVALID_TIMEOUT_PARAMETER`	Valor de tempo limite inválido. Deve ser um número inteiro entre 1 e 15
`INVALID_CONFIRMATION_PARAMETER`	Valor de confirmação inválido. Deve ser 'verdadeiro' ou 'falso'
`RECEIVE_AUTHORIZATION_FAILURE`	Falha na autorização do cliente de destino. Verifique se sua política concede as permissões necessárias
`TARGET_CLIENT_ID_NOT_FOUND`	O ID do cliente não foi encontrado. Verifique se o cliente está conectado e tente novamente
`TARGET_CLIENT_NOT_CONNECTED`	O ID do cliente de destino não está conectado, mas tem uma sessão persistente ativa
`SEND_DIRECT_MESSAGE_THROTTLED`	A solicitação foi negada devido ao envio de mensagem direta. A taxa de solicitação foi excedida
`RECEIVE_SESSION_THROTTLED`	A solicitação foi negada porque a taxa de solicitações excedeu as solicitações de publicação de saída por segundo por conexão.
`RECEIVER_MAX_UNACKED_QOS1_EXCEEDED`	O cliente receptor atingiu o número máximo de mensagens de QoS 1 não confirmadas
`DELIVERY_CONFIRMATION_TIMEOUT`	A confirmação de entrega não foi recebida dentro do período de tempo limite especificado
`DELIVERY_CONFIRMATION_SENDER_DISCONNECT`	O remetente se desconectou antes do recebimento da confirmação da entrega
`CLIENT_ENDPOINT_NOT_WRITABLE`	O endpoint do cliente receptor não é gravável
`INTERNAL_SERVER_ERROR`	Erro interno do servidor

Entradas de log OCSP do certificado do servidor

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

Tópicos

RetrieveOCSPStapleData entrada de registro
RetrieveOCSPStapleData entrada de registro para endpoints privados

RetrieveOCSPStapleData entrada de registro

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

RetrieveOCSPStapleData exemplos de entrada de registro

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 doCloudWatch Atributos de registros comuns, as entradas de registro contêm os seguintes atributos:

reason

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

domínio ConfigName

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

connectionDetails

Uma breve explicação dos detalhes da conexão.

http StatusCode

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

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.

ocsp RequestDetails

Detalhes da solicitação OCSP.

requesterName

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

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

ocsp ResponseDetails

Detalhes da resposta do OCSP.

resposta CertId

O ID do certificado da resposta OCSP.
ocsp ResponseStatus

O status da resposta do OCSP.
certStatus

O status do certificado.
assinatura

A assinatura aplicada à resposta por uma entidade confiável.
isso UpdateTime

A hora em que se sabe que o status indicado está correto.
próximo UpdateTime

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

A hora em que o respondente OCSP assinou essa resposta.
grampeado DataPayloadSize

O tamanho da carga útil dos dados associados.

RetrieveOCSPStapleData entrada de registro para endpoints privados

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

RetrieveOCSPStapleData exemplos de entrada de registro para endpoints privados

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 e na entrada de RetrieveOCSPStapleData registro, 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.

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

Entradas de log da sombra do dispositivo

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

DeleteThingShadow entrada de registro

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


{
    "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 doCloudWatch Atributos de registros comuns, as entradas de DeleteThingShadow registro contêm os seguintes atributos:

dispositivo ShadowName: 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

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


{
    "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 doCloudWatch Atributos de registros comuns, as entradas de GetThingShadow registro contêm os seguintes atributos:

dispositivo ShadowName: 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

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


{
    "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 doCloudWatch Atributos de registros comuns, as entradas de UpdateThingShadow registro contêm os seguintes atributos:

dispositivo ShadowName: 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

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

Tópicos

FunctionExecution entrada de registro
RuleExecution entrada de registro
RuleMatch entrada de registro
RuleExecutionThrottled entrada de registro
RuleNotFound entrada de registro
StartingRuleExecution entrada de registro

FunctionExecution entrada de registro

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 oumachinelearning_predict).

FunctionExecution exemplo de entrada de registro


{
    "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 doCloudWatch Atributos de registros comuns, 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

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


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


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

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


{
    "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 doCloudWatch Atributos de registros comuns, 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

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


{
    "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 doCloudWatch Atributos de registros comuns, 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

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

RuleNotFound exemplo de entrada de registro


{
    "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 doCloudWatch Atributos de registros comuns, 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

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

StartingRuleExecution exemplo de entrada de registro


{
    "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 doCloudWatch Atributos de registros comuns, 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

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.

Tópicos

DescribeJobExecution entrada de registro
GetPendingJobExecution entrada de registro
ReportFinalJobExecutionCount entrada de registro
StartNextPendingJobExecution entrada de registro
UpdateJobExecution entrada de registro

DescribeJobExecution entrada de registro

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


{
    "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 doCloudWatch Atributos de registros comuns, 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.
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

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


{
    "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 doCloudWatch Atributos de registros comuns, 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.
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

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


{
    "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 doCloudWatch Atributos de registros comuns, 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

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

StartNextPendingJobExecution exemplo de entrada de registro


{
    "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 doCloudWatch Atributos de registros comuns, 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.
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

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


{
    "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 doCloudWatch Atributos de registros comuns, 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.
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

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

Tópicos

GetDeviceCredentials entrada de registro
ProvisionDevice entrada de registro

GetDeviceCredentials entrada de registro

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


{
  "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 doCloudWatch Atributos de registros comuns, as entradas de GetDeviceCredentials registro contêm os seguintes atributos:

detalhes: Uma breve explicação do erro.
dispositivo CertificateId: O ID do certificado do dispositivo.

ProvisionDevice entrada de registro

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


{
  "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 doCloudWatch Atributos de registros comuns, as entradas de ProvisionDevice registro contêm os seguintes atributos:

detalhes: Uma breve explicação do erro.
dispositivo CertificateId: O ID do certificado do dispositivo.
provisionamento TemplateName: O nome do modelo de provisionamento.

Entradas de log de grupo dinâmico de objetos

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

Tópicos

AddThingToDynamicThingGroupsFailed entrada de registro

AddThingToDynamicThingGroupsFailed entrada de registro

Quando não AWS IoT foi possível adicionar algo aos grupos dinâmicos especificados, ele gera uma entrada de registro com um eventType deAddThingToDynamicThingGroupsFailed. 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.

AddThingToDynamicThingGroupsFailed exemplo de entrada de registro

Este exemplo mostra a entrada de log de um erro AddThingToDynamicThingGroupsFailed. Neste exemplo, TestThingatendeu aos critérios para estar nos grupos de coisas dinâmicas listados emdynamicThingGroupNames, mas não pôde ser adicionado a esses grupos dinâmicos, conforme descrito emreason.


{
 "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 doCloudWatch Atributos de registros comuns, as entradas de AddThingToDynamicThingGroupsFailed registro contêm os seguintes atributos:

dinâmico ThingGroupNames: 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

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

Tópicos

NamedShadowCountForDynamicGroupQueryLimitExceeded entrada de registro

NamedShadowCountForDynamicGroupQueryLimitExceeded entrada de registro

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

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

Todas as entradas de registro de CloudWatch registros incluem esses 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.
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.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Monitorar AWS IoT usando CloudWatch registros

Faça upload de registros do lado do dispositivo para a Amazon CloudWatch

CloudWatch Registros AWS IoT entradas de registro

Tópicos

Entradas de log do agente de mensagens

Tópicos

Entrada de log de conexão

Exemplo de entrada de log de conexão

Entrada de log de desconexão

Exemplo de entrada de log de desconexão

Entrada do log de ping

Importante

Exemplo de entrada de log de ping (sucesso)

Exemplo de entrada de log de ping (falha)

Connection.AuthNError entrada de registro

Importante

nota

Connection.AuthNError exemplo de entrada de registro

Connection.AuthNError códigos de erro

DeleteConnection entrada de registro

DeleteConnection exemplo de entrada de registro

GetRetainedMessage entrada de registro

GetRetainedMessage exemplo de entrada de registro

ListRetainedMessage entrada de registro

ListRetainedMessage exemplo de entrada de registro

ListSubscriptions entrada de registro

ListSubscriptions exemplo de entrada de registro

GetConnection entrada de registro

GetConnection exemplo de entrada de registro

Publish-In entrada de registro

Publish-In exemplo de entrada de registro

Publish-Out entrada de registro

Publish-Out exemplo de entrada de registro

Entrada de log em fila

Exemplo de entrada de log de erros do servidor em fila

Erro do servidor

Exemplo de entrada de log de sucesso em fila

Exemplo de entrada de log mantida em fila

Limitado ao enfileirar mensagens off-line

Entrada de log de assinatura

Exemplo de entrada de log de assinatura MQTT 3

Exemplo de entrada de log de assinatura MQTT 5

Entrada de log de cancelamento de assinatura

Exemplo de entrada de log de cancelamento de assinatura MQTT

SendDirectMessage entrada de registro

SendDirectMessage exemplo de entrada de registro de sucesso

SendDirectMessage exemplo de entrada de registro de falhas

Códigos de motivo

Entradas de log OCSP do certificado do servidor

Tópicos

RetrieveOCSPStapleData entrada de registro

RetrieveOCSPStapleData exemplos de entrada de registro

RetrieveOCSPStapleData entrada de registro para endpoints privados

RetrieveOCSPStapleData exemplos de entrada de registro para endpoints privados

Entradas de log da sombra do dispositivo

Tópicos

DeleteThingShadow entrada de registro

DeleteThingShadow exemplo de entrada de registro

GetThingShadow entrada de registro

GetThingShadow exemplo de entrada de registro

UpdateThingShadow entrada de registro

UpdateThingShadow exemplo de entrada de registro

Entradas de log do mecanismo de regras

Tópicos

FunctionExecution entrada de registro

FunctionExecution exemplo de entrada de registro

RuleExecution entrada de registro

RuleExecution exemplo de entrada de registro

RuleExecution com exemplo de entrada de registro em lote

RuleMatch entrada de registro

RuleMatch exemplo de entrada de registro

RuleExecutionThrottled entrada de registro

RuleExecutionThrottled exemplo de entrada de registro

RuleNotFound entrada de registro

RuleNotFound exemplo de entrada de registro

StartingRuleExecution entrada de registro

StartingRuleExecution exemplo de entrada de registro

Entradas de log de tarefas

Tópicos

DescribeJobExecution entrada de registro

DescribeJobExecution exemplo de entrada de registro

GetPendingJobExecution entrada de registro

`Erro do servidor`

`Limitado ao enfileirar mensagens off-line`