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á.
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
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
de Connect
quando um MQTT cliente 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
de Disconnect
quando um MQTT cliente 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:
- lastModifiedDate
-
A data e a hora da Epoch, em milissegundos, em que a mensagem retida foi armazenada por. AWS IoT
- protocolo
-
O protocolo usado para fazer a solicitação. Valor válido:
HTTP
. - qos
-
O nível Qualidade de Serviço (QoS) usado na solicitação de publicação. Os valores válidos são
0
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 MQTT mensagem, 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 RETAIN sinalizador definido com um valor de
True
. Se a mensagem não tiver o RETAIN sinalizador definido, esse atributo não aparecerá na entrada do registro. 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.
Entrada de log de publicação de saída
Quando o agente de mensagens publica uma MQTT mensagem, ele gera uma entrada de registro com um de eventType
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 inscrito que recebe mensagens sobre esse MQTT tópico.
- 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 MQTT mensagens armazena as mensagens do dispositivo e AWS IoT gera entradas de registro com um eventType deQueued
. Para obter mais informações sobre sessões MQTT persistentes, 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 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 MQTT cliente se inscreve em um tópico.
MQTT3 Exemplo de entrada de registro de assinatura
{
"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. 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.
MQTT5 Exemplo de entrada de registro de assinatura
{
"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 MQTT 5 operações de inscrição, além dos atributos de entrada de registro de assinatura CloudWatch Atributos de registros comuns e MQTT 3, MQTT 5 entradas de Subscribe
registro contêm o seguinte atributo:
- assinaturas
-
Uma lista de mapeamentos entre os tópicos solicitados na solicitação de assinatura e o código individual de MQTT 5 motivos. Para obter mais informações, consulte os códigos de MQTT motivo.
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 MQTT cliente cancela a assinatura de um MQTT tópico.
MQTTexemplo de entrada de registro de cancelamento de assinatura
{
"timestamp": "2024-08-20 22:53:32.844",
"logLevel": "INFO",
"traceId": "db6bd09a-2c3f-1cd2-27cc-fd6b1ce03b58",
"accountId": "123456789012",
"status": "Success",
"eventType": "Unsubscribe",
"protocol": "MQTT",
"clientId": "abf27092886e49a8a5c1922749736453",
"principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167",
"sourceIp": "205.251.233.181",
"sourcePort": 13490
}
Além do CloudWatch Atributos de registros comuns, as entradas de log Unsubscribe
contêm os seguintes atributos:
- protocolo
-
O protocolo usado para fazer a solicitação. O valor sempre será
MQTT
. - clientId
-
O ID do cliente que está fazendo a solicitação.
- principalId
-
O ID da entidade principal que está fazendo a solicitação.
- sourceIp
-
O endereço IP no qual a solicitação foi originada.
- sourcePort
-
A porta em que a solicitação foi originada.
Entradas de OCSP registro de certificados do servidor
AWS IoT Core gera entradas de registro para o seguinte evento:
Tópicos
R Entrada do registro de etrieveOCSPStaple dados
AWS IoT Core gera uma entrada de registro com um eventType
of RetrieveOCSPStapleData
quando o servidor recupera os dados OCSP básicos.
R Exemplos de entrada de registro de etrieveOCSPStaple dados
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 operação RetrieveOCSPStaple
, além de CloudWatch Atributos de registros comuns, as entradas de log contêm os seguintes atributos:
- reason
-
A razão pela qual a operação falha.
- domainConfigName
-
O nome da configuração do domínio.
- connectionDetails
-
Uma breve explicação dos detalhes da conexão.
-
httpStatusCode
HTTPcódigos de status que são retornados pelo OCSP respondente em resposta à solicitação do cliente feita ao servidor.
-
ocspResponderUri
O OCSP respondente URI 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 OCSP respondente.
-
- ocspRequestDetails
-
Detalhes da OCSP solicitação.
-
requesterName
O identificador do AWS IoT Core servidor que envia uma solicitação ao OCSP respondente.
-
requestCertId
O ID do certificado da solicitação. Esse é o ID do certificado para o qual a OCSP resposta está sendo solicitada.
-
- ocspResponseDetails
-
Detalhes da OCSP resposta.
-
responseCertId
O ID do certificado da OCSP resposta.
-
ocspResponseStatus
O status da OCSP resposta.
-
certStatus
O status do certificado.
-
assinatura
A assinatura aplicada à resposta por uma entidade confiável.
-
thisUpdateTime
A hora em que se sabe que o status indicado está correto.
-
nextUpdateTime
A hora igual ou anterior àquela em que as informações mais recentes estarão disponíveis sobre o status do certificado.
-
producedAtTime
A hora em que o OCSP respondente assinou essa resposta.
-
stapledDataPayloadTamanho
O tamanho da carga útil dos dados associados.
-
R Entrada etrieveOCSPStaple de registro de dados para endpoints privados
AWS IoT Core gera uma entrada de registro com um eventType
of RetrieveOCSPStapleData
quando o servidor recupera os dados OCSP básicos.
R Exemplos de entrada de registro de etrieveOCSPStaple dados 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 registro de etrieveOCSPStaple dados R, as entradas de registro para endpoints privados contêm os seguintes atributos:
- lambdaDetails
-
Detalhes da função Lambda.
-
lambdaArn
O ARN da função Lambda.
-
sourceArn
A configuração ARN do domínio.
-
- authorizedResponderArn
-
O ARN do respondente autorizador, se houver um configurado 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:
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:
- deviceShadowName
-
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:
- deviceShadowName
-
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:
- deviceShadowName
-
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 registro com um eventType
de FunctionExecution
quando a SQL consulta de uma regra chama uma função externa. Uma função externa é chamada quando a ação de uma regra faz uma HTTP solicitação 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.
- 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 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.
- 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 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 registro são geradas quando uma HTTP solicitação MQTT or é 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
Exemplo de entrada de log do GetDeviceCredentials
{
"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.
- deviceCertificateId
-
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.
- deviceCertificateId
-
O ID do certificado do dispositivo.
- provisioningTemplateName
-
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:
- dynamicThingGroupNomes
-
Uma matriz dos grupos de objetos dinâmicas aos quais o objeto não foi adicionada.
- reason
-
A razão pela qual o objeto não foi adicionada aos grupos de objetos dinâmicas.
- thingName
-
O nome do objeto que não foi adicionada a um grupo de objetos dinâmicas.
Entradas de log de indexação de frota
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 obter mais informações, consulte Níveis de log.
- status
-
O status da solicitação.
- timestamp
-
O UTC carimbo de data/hora legível por humanos de quando o cliente se conectou ao agente de mensagens. AWS IoT
- traceId
-
Um identificador gerado aleatoriamente que pode ser usado para correlacionar todos os logs para uma solicitação específica.