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á.
CloudWatch Registra entradas AWS IoT 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
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 do CloudWatch Atributos de registros comuns, as entradas de log Connect
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
ouHTTP
. - 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 do CloudWatch Atributos de registros comuns, as entradas de log Disconnect
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
ouHTTP
. - 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.
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 do CloudWatch Atributos de registros comuns, as entradas de log GetRetainedMessage
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
ou1
. - 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 do CloudWatch Atributos de registros comuns, as entradas de log ListRetainedMessage
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
Quando o agente de AWS IoT mensagens recebe uma mensagem MQTT, ele gera uma entrada de registro com um eventType
dePublish-In
.
Exemplo de entrada de log de publicação de entrada
{ "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, as entradas de log Publish-In
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
ouHTTP
. - 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 ter 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.
Entrada de log de publicação de saída
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
{ "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, as entradas de log Publish-Out
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
ouHTTP
. - 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 as sessões permanentes do MQTT, consulte Sessõ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 do CloudWatch Atributos de registros comuns, as entradas de log de erro do servidor Queued
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
{ "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, as entradas com êxito de log Queued
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 do CloudWatch Atributos de registros comuns, as entradas de log Queued
retidas 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
, 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
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
{ "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, as entradas de log Subscribe
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
ouHTTP
. - 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
{ "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.
Entradas de log OCSP do certificado do servidor
AWS IoT Core gera entradas de registro para o seguinte evento:
Recuperar entrada de registro OCSP StapleData
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 de registro do RetrieveOCSP StapleData
A seguir está um exemplo de entrada de registro deSuccess
.
{ "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 registro deFailure
.
{ "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, as entradas de registro contêm os seguintes atributos:
- razão
-
O motivo pelo qual a operação falha.
- domínio ConfigName
-
O nome da configuração do seu domínio.
- Detalhes da conexão
-
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.
-
Dica de destino
O endereço IP de destino do respondente OCSP.
-
- ocsp RequestDetails
-
Detalhes da solicitação OCSP.
-
Nome do solicitante
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.
-
Status do certificado
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 em ou antes da qual 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.
-
Tamanho DataPayload grampeado
O tamanho da carga útil dos dados grampeados.
-
Entradas de log da sombra do dispositivo
O serviço AWS IoT Device Shadow gera entradas de registro para os seguintes eventos:
Tópicos
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 do CloudWatch Atributos de registros comuns, as entradas de log DeleteThingShadow
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
ouHTTP
. - 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 do CloudWatch Atributos de registros comuns, as entradas de log GetThingShadow
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
ouHTTP
. - 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 do CloudWatch Atributos de registros comuns, as entradas de log UpdateThingShadow
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
ouHTTP
. - 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
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 do CloudWatch Atributos de registros comuns, as entradas de log FunctionExecution
contêm os seguintes atributos:
- clientId
-
N/A
para logsFunctionExecution
. - 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" }
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 do CloudWatch Atributos de registros comuns, as entradas de log RuleMatch
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": "RuleMessageThrottled", "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, as entradas de log RuleExecutionThrottled
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.
- razão
-
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 do CloudWatch Atributos de registros comuns, as entradas de log RuleNotFound
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.
- razão
-
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 do CloudWatch Atributos de registros comuns, as entradas de log rule-
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
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 do CloudWatch Atributos de registros comuns, as entradas de log GetJobExecution
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
ouHTTP
. - 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 do CloudWatch Atributos de registros comuns, as entradas de log GetPendingJobExecution
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
ouHTTP
. - 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 do CloudWatch Atributos de registros comuns, as entradas de log ReportFinalJobExecutionCount
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 do CloudWatch Atributos de registros comuns, as entradas de log StartNextPendingJobExecution
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
ouHTTP
. - 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 do CloudWatch Atributos de registros comuns, as entradas de log UpdateJobExecution
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
ouHTTP
. - 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.
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
GetDeviceExemplo de entrada de registro de credenciais
{ "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, as entradas de log GetDeviceCredentials
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 do CloudWatch Atributos de registros comuns, as entradas de log ProvisionDevice
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.
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 do CloudWatch Atributos de registros comuns, as entradas de log AddThingToDynamicThingGroupsFailed
contêm os seguintes atributos:
- ThingGroupNomes dinâmicos
-
Uma matriz dos grupos de objetos dinâmicas aos quais o objeto não foi adicionada.
- razão
-
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.
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 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 ter mais informações, consulte Níveis de log.
- 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.