Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
CloudWatch Registros AWS IoT entradas de registro
Cada componente de AWS IoT genera sus propias entradas de registro. Cada entrada de registro tiene un eventType que especifica la operación que provocó que se genere la entrada de registro. En esta sección se describen las entradas de registro generadas por los siguientes componentes de AWS IoT
.
Temas
Entradas de registro del agente de mensajes
El agente de AWS IoT mensajes genera entradas de registro para los siguientes eventos:
Temas
Entrada de registro Connect
El intermediario de AWS IoT mensajes genera una entrada de registro con un valor eventType de Connect cuando se conecta un cliente MQTT.
Ejemplo de entrada de registro Connect
{ "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 }
Además de esoAtributos comunes CloudWatch de los registros, las entradas de Connect registro contienen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- protocol
-
El protocolo utilizado para realizar la solicitud. Los valores válidos son
MQTToHTTP. - sourceIp
-
La dirección IP en la que se originó la solicitud.
- sourcePort
-
El puerto en el que se originó la solicitud.
Entrada de registro Disconnect
El intermediario de AWS IoT mensajes genera una entrada de registro con un valor eventType de Disconnect cuando un cliente MQTT se desconecta.
Ejemplo de entrada de registro Disconnect
{ "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" }
Además delAtributos comunes CloudWatch de los registros, las entradas del Disconnect registro contienen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- protocol
-
El protocolo utilizado para realizar la solicitud. Los valores válidos son
MQTToHTTP. - sourceIp
-
La dirección IP en la que se originó la solicitud.
- sourcePort
-
El puerto en el que se originó la solicitud.
- razón
-
La razón por la que el cliente se está desconectando.
- details
-
Una breve explicación del error.
- disconnectReason
-
La razón por la que el cliente se está desconectando.
Entrada de registro de ping
El intermediario de AWS IoT mensajes genera una entrada de registro con un valor eventType de Ping cuando procesa un PINGREQ de MQTT de un cliente conectado y envía el PINGRESP correspondiente. Se emite una sola entrada de registro por cada operación de ping.
importante
Las entradas del registro de ping son opcionales y están deshabilitadas de forma predeterminada. El umbral de emisión coincide con el resultado de cada entrada: las entradas exitosas se emiten en el DEBUG nivel y las entradas fallidas se emiten en el ERROR nivel. Como resultado, verás las entradas de error de Ping siempre que el nivel de evento o Resource-specific anulación que se aplica a la conexión esté establecido en ERROR o en un nivel más detallado (WARN,, oDEBUG)INFO, pero las entradas de ping exitoso solo se publican cuando ese nivel está establecido en. DEBUG Para configurar estas opciones, consulte y. Configure la cuenta e inicie sesión Event-level AWS IoT (CLI) Configure las Resource-specific anulaciones en AWS IoT (CLI)
En caso de éxito, el logLevel es DEBUG y el status esSuccess. En caso de error (por ejemplo, cuando la conexión del cliente finaliza antes de que se pueda enviar el PINGRESP), el logLevel es ERROR y el status es. Failure
Ejemplo de entrada en el registro de ping (éxito)
{ "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 }
Ejemplo de entrada en un registro de ping (error)
{ "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" }
Además de Atributos comunes CloudWatch de los registros, las entradas de registro Ping incluyen los siguientes atributos:
- protocol
-
El protocolo utilizado para realizar la solicitud. Este valor siempre es
MQTT. - latencia
-
El tiempo en milisegundos entre la recepción del PINGREQ y el envío del PINGRESP. Este campo solo está presente cuando es.
statusSuccess - Solicitar marca de tiempo
-
La marca de tiempo en la que se AWS IoT Core recibió el PINGREQ del cliente.
- Marca de tiempo de respuesta
-
La marca de tiempo en la que se AWS IoT Core envió el PINGRESP al cliente. Este campo solo está presente cuando es.
statusSuccess - clientId
-
El ID del cliente que realiza la solicitud.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- sourceIp
-
La dirección IP en la que se originó la solicitud.
- sourcePort
-
El puerto en el que se originó la solicitud.
- razón
-
El motivo del error de la operación Ping. Este campo solo está presente cuando
statusesFailure. - details
-
Una breve explicación del error. Este campo solo está presente cuando
statusesFailure.
Connection.AuthNError entrada de registro
El agente de AWS IoT mensajes genera una entrada de registro con un valor eventType de Connection.AuthNError cuando se rechaza un intento de conexión de un cliente debido a un error de autenticación. El logLevel para esta entrada de registro es siempre ERROR y el status es siempreFailure. Esta entrada de registro corresponde a la Connection.AuthNError CloudWatch métrica.
importante
Connection.AuthNErrorlas entradas de registro son opcionales y están deshabilitadas de forma predeterminada. Se emiten a nivel de ERROR registro, por lo que una entrada de Connection.AuthNError registro solo se publica cuando el nivel de evento o Resource-specific anulación que se aplica a la conexión está establecido en ERROR o a un nivel más detallado (,, o). WARN INFO DEBUG Para configurar estas opciones, consulte y. Configure la cuenta e inicie sesión Event-level AWS IoT (CLI) Configure las Resource-specific anulaciones en AWS IoT (CLI)
nota
Esta entrada de registro se publica para el Cuenta de AWS propietario de la indicación del nombre del servidor (SNI) proporcionada en el protocolo de enlace TLS. Si el cliente no proporciona un SNI o el SNI no se puede resolver en una cuenta, no se emite ninguna entrada de registro ni métrica.
Connection.AuthNError ejemplo 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" }
Además de Atributos comunes CloudWatch de los registros, las entradas de registro Connection.AuthNError incluyen los siguientes atributos:
- protocol
-
El protocolo utilizado para realizar la solicitud. Los valores válidos son
MQTToHTTP. - Tipo de autenticación
-
El tipo de autenticación utilizado para el intento de conexión. Los valores válidos son
AWS_X509,AWS_SIGV4,CUSTOM_AUTHyCUSTOM_AUTH_X509. - clientId
-
El identificador del cliente que realiza la solicitud, si está disponible.
- principalId
-
El identificador del principal que hace la solicitud, si está disponible.
- sourceIp
-
La dirección IP en la que se originó la solicitud.
- sourcePort
-
El puerto en el que se originó la solicitud.
- targetIp
-
La dirección IP de destino de la conexión. Es posible que este campo no esté presente en todas las entradas de registro.
- TargetPort
-
El puerto de destino de la conexión.
- servidor NameIndication
-
El nombre de host de la extensión de indicación de nombre de servidor TLS (SNI) proporcionado por el cliente.
- razón
-
El motivo por el que falló la autenticación del cliente. Consulte Connection.AuthNError códigos de error para obtener una lista de los valores posibles.
- details
-
Una breve descripción del error de autenticación.
Connection.AuthNError códigos de error
En la tabla siguiente se enumeran los códigos de reason error y los details mensajes correspondientes que pueden aparecer en una entrada de Connection.AuthNError registro. Es posible que se agreguen códigos de error adicionales en el futuro.
| Código de error | Mensaje de error |
|---|---|
CUSTOM_AUTHORIZER_LAMBDA_EXECUTION_ERROR |
Fallo al invocar Lambda del autorizador personalizado |
CUSTOM_AUTHORIZER_NOT_FOUND |
No se pudo encontrar el autorizador personalizado |
CUSTOM_AUTHORIZER_PARAMETER_INVALID |
El parámetro de autenticación personalizado no es válido |
DEVICE_CERTIFICATE_INACTIVE |
El certificado del dispositivo no está activo |
DEVICE_CERTIFICATE_NOT_REGISTERED |
El certificado del dispositivo no está registrado |
DEVICE_CERTIFICATE_REVOKED |
El certificado del dispositivo está revocado |
DOMAIN_CONFIGURATION_DISABLED |
La configuración de dominio para la indicación de nombre de servidor (SNI) proporcionada está deshabilitada |
DOMAIN_CONFIGURATION_INVALID |
El tipo de punto final en la configuración del dominio no es válido |
INTERNAL_SERVER_ERROR |
Error del servidor interno |
NOT_AUTHENTICATED |
No se pudieron autenticar las credenciales proporcionadas |
SECURITY_TOKEN_EXPIRED |
El token de seguridad ha caducado |
SECURITY_TOKEN_INVALID |
El token de seguridad incluido en la solicitud no es válido |
SECURITY_TOKEN_SIGNATURE_MISMATCH |
La firma de la solicitud no coincide con la firma proporcionada |
SNI_MISUSED |
El cliente usó un SNI que no está asociado a esta cuenta |
DeleteConnection entrada de registro
El intermediario de AWS IoT mensajes genera una entrada de registro con un valor eventType de DeleteConnection cuando se elimina la conexión de un cliente MQTT.
DeleteConnection ejemplo 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 }
Además deAtributos comunes CloudWatch de los registros, las entradas de DeleteConnection registro contienen los siguientes atributos:
- clientId
-
El identificador del cliente que se desconectará.
- principalId
-
El ID de la entidad principal que realiza la solicitud. Para obtener más información sobre cómo identificar la entidad principal mediante el ID de la entidad principal, consulte Comparación de identidades y credenciales de IAM en la Guía del usuario de IAM.
- protocol
-
El protocolo utilizado para realizar la solicitud. El valor válido es
HTTP. - sourceIp
-
La dirección IP en la que se originó la solicitud.
- sourcePort
-
El puerto en el que se originó la solicitud.
GetRetainedMessage entrada de registro
El intermediario de AWS IoT mensajes genera una entrada de registro con un eventType valor de GetRetainedMessage cuándo GetRetainedMessage se llama.
GetRetainedMessage ejemplo 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" }
Además deAtributos comunes CloudWatch de los registros, las entradas de GetRetainedMessage registro contienen los siguientes atributos:
- último ModifiedDate
-
La fecha y la hora de la época, en milisegundos, en la que se almacenó el mensaje retenido. AWS IoT
- protocol
-
El protocolo utilizado para realizar la solicitud. Valor válido:
HTTP. - qos
-
El nivel de calidad de servicio (QoS) utilizado en la solicitud de publicación. Los valores válidos son
0o1. - topicName
-
El nombre del tema suscrito.
ListRetainedMessage entrada de registro
El intermediario de AWS IoT mensajes genera una entrada de registro con un eventType valor de ListRetainedMessage cuándo ListRetainedMessages se llama.
ListRetainedMessage ejemplo 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" }
Además delAtributos comunes CloudWatch de los registros, las entradas de ListRetainedMessage registro contienen el siguiente atributo:
- protocol
-
El protocolo utilizado para realizar la solicitud. Valor válido:
HTTP.
ListSubscriptions entrada de registro
El agente de AWS IoT mensajes genera una entrada de registro con una eventType de ListSubscriptions cuando se recibe una solicitud para listar las suscripciones de los clientes.
ListSubscriptions ejemplo 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 }
Además de Atributos comunes CloudWatch de los registros, las entradas de registro ListSubscriptions incluyen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- protocol
-
El protocolo utilizado para realizar la solicitud. Valor válido:
HTTP. - sourceIp
-
La dirección IP en la que se originó la solicitud.
- sourcePort
-
El puerto en el que se originó la solicitud.
- maxResults
-
El número máximo de resultados solicitados.
GetConnection entrada de registro
El intermediario de AWS IoT mensajes genera una entrada de registro con una eventType de GetConnection cuando se recibe una solicitud para obtener información de conexión.
GetConnection ejemplo 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 }
Además de Atributos comunes CloudWatch de los registros, las entradas de registro GetConnection incluyen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- protocol
-
El protocolo utilizado para realizar la solicitud. Valor válido:
HTTP. - sourceIp
-
La dirección IP en la que se originó la solicitud de API.
- sourcePort
-
El puerto en el que se originó la solicitud de API.
Publish-In entrada de registro
Cuando el intermediario de AWS IoT mensajes recibe un mensaje de MQTT, genera una entrada de registro con un eventType dePublish-In.
Publish-In ejemplo 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" }
Además deAtributos comunes CloudWatch de los registros, las entradas de Publish-In registro contienen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- protocol
-
El protocolo utilizado para realizar la solicitud. Los valores válidos son
MQTToHTTP. - retain
-
El atributo que se usa cuando un mensaje tiene la marca RETAIN establecida con un valor de
True. Si el mensaje no tiene la marca RETAIN establecida, este atributo no aparece en la entrada de registro. Para obtener más información, consulte Mensajes retenidos de MQTT . - sourceIp
-
La dirección IP en la que se originó la solicitud.
- sourcePort
-
El puerto en el que se originó la solicitud.
- topicName
-
El nombre del tema suscrito.
Publish-Out entrada de registro
Cuando el agente de mensajes publica un mensaje MQTT, genera una entrada de registro con un eventType de Publish-Out.
Publish-Out ejemplo 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 }
Además deAtributos comunes CloudWatch de los registros, las entradas de Publish-Out registro contienen los siguientes atributos:
- clientId
-
El ID del cliente suscrito que recibe mensajes sobre ese tema de MQTT.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- protocol
-
El protocolo utilizado para realizar la solicitud. Los valores válidos son
MQTToHTTP. - sourceIp
-
La dirección IP en la que se originó la solicitud.
- sourcePort
-
El puerto en el que se originó la solicitud.
- topicName
-
El nombre del tema suscrito.
Entrada de registro en cola
Cuando se desconecta un dispositivo con una sesión persistente, el agente de mensajes MQTT almacena los mensajes del dispositivo y AWS IoT genera entradas de registro con un tipo de evento de. Queued Para obtener más información sobre las sesiones persistentes de MQTT, consulte. Sesiones persistentes de MQTT
Ejemplo de entrada de registro de error del servidor en cola
{ "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" }
Además de estoAtributos comunes CloudWatch de los registros, las entradas del registro de errores Queued del servidor contienen los siguientes atributos:
- clientId
-
El ID del cliente al que se pone el mensaje en cola.
- details
-
Error del servidorUn error del servidor ha impedido que se almacene el mensaje.
- protocol
-
El protocolo utilizado para realizar la solicitud. El valor será siempre
MQTT. - qos
-
El nivel de calidad de servicio (QoS) de la solicitud. El valor siempre será 1 porque los mensajes con una QoS de 0 no se almacenan.
- topicName
-
El nombre del tema suscrito.
Ejemplo de entrada de registro de éxito en cola
{ "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" }
Además delAtributos comunes CloudWatch de los registros, las entradas del registro de Queued éxito contienen los siguientes atributos:
- clientId
-
El ID del cliente al que se pone el mensaje en cola.
- protocol
-
El protocolo utilizado para realizar la solicitud. El valor será siempre
MQTT. - qos
-
El nivel de calidad de servicio (QoS) de la solicitud. El valor siempre será 1 porque los mensajes con una QoS de 0 no se almacenan.
- topicName
-
El nombre del tema suscrito.
Ejemplo de entrada de registro limitada en cola
{ "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" }
Además de losAtributos comunes CloudWatch de los registros, las entradas de Queued registro limitadas contienen los siguientes atributos:
- clientId
-
El ID del cliente al que se pone el mensaje en cola.
- details
-
Limitado mientras se ponía en cola el mensaje sin conexiónEl cliente superó el límite
Queued messages per second per account, por lo que el mensaje no se almacenó. - protocol
-
El protocolo utilizado para realizar la solicitud. El valor será siempre
MQTT. - qos
-
El nivel de calidad de servicio (QoS) de la solicitud. El valor siempre será 1 porque los mensajes con una QoS de 0 no se almacenan.
- topicName
-
El nombre del tema suscrito.
Entrada de registro de suscripción
El intermediario de AWS IoT mensajes genera una entrada de registro con un identificador Subscribe cuando un eventType cliente MQTT se suscribe a un tema.
Ejemplo de entrada de registro de suscripción de 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 }
Además delAtributos comunes CloudWatch de los registros, las entradas de Subscribe registro contienen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- protocol
-
El protocolo utilizado para realizar la solicitud. El valor será siempre
MQTT. - sourceIp
-
La dirección IP en la que se originó la solicitud.
- sourcePort
-
El puerto en el que se originó la solicitud.
- topicName
-
El nombre del tema suscrito.
Ejemplo de entrada de registro de suscripción de 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 }
En el caso de las operaciones de suscripción de MQTT 5, además del Atributos comunes CloudWatch de los registros y los atributos de entrada de registro de suscripción de MQTT 3, las entradas de registro Subscribe de MQTT 5 contienen el siguiente atributo:
- subscriptions
-
Una lista de asignaciones entre los temas solicitados en la solicitud de suscripción y el código de motivo individual de MQTT 5. Para obtener más información, consulte Códigos de motivo de MQTT.
Entrada de registro Unsubscribe
El intermediario de AWS IoT mensajes genera una entrada de registro con un valor eventType de Unsubscribe cuando un cliente de MQTT cancela la suscripción a un tema de MQTT.
Ejemplo de entrada de registro de cancelación de suscripción de 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 }
Además del, las entradas de Atributos comunes CloudWatch de los registros Unsubscribe registro contienen los siguientes atributos:
- protocol
-
El protocolo utilizado para realizar la solicitud. El valor será siempre
MQTT. - clientId
-
El ID del cliente que realiza la solicitud.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- sourceIp
-
La dirección IP en la que se originó la solicitud.
- sourcePort
-
El puerto en el que se originó la solicitud.
SendDirectMessage entrada de registro
El agente de AWS IoT mensajes genera una entrada de registro con una eventType de SendDirectMessage cuando se realiza una solicitud a la SendDirectMessage API.
AWS IoT Core registra los SendDirectMessage eventos en CloudWatch Logs cuando se habilita el registro de IoT. Para obtener más información sobre la configuración del registro, consulteConfiguración AWS IoT registrar.
SendDirectMessage ejemplo de entrada en un registro de éxito
{ "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 ejemplo de entrada en el registro de errores
{ "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 }
Además de Atributos comunes CloudWatch de los registros, las entradas de registro SendDirectMessage incluyen los siguientes atributos:
- clientId
-
El identificador del cliente que recibe el mensaje directo.
- topicName
-
El tema sobre el que se envió el mensaje.
- protocol
-
El protocolo utilizado para realizar la solicitud. Valor válido:
HTTP. - confirmación
-
Si se solicitó la confirmación de entrega. Los valores válidos son
trueofalse. - timeout
-
Tiempo máximo, en segundos, de espera para recibir una confirmación de entrega del cliente receptor. Solo está presente cuando
confirmationestátrue. - razón
-
El código de motivo del error.
- details
-
Una breve explicación del error.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- sourceIp
-
La dirección IP en la que se originó la solicitud.
- sourcePort
-
El puerto en el que se originó la solicitud.
Códigos de motivo
Los siguientes códigos de motivo y detalles aparecerán en las entradas del registro de errores:
| Motivo | Details |
|---|---|
MALFORMED_CLIENTID |
Este identificador de cliente no es válido. Los ID de cliente no deben superar los 128 caracteres y no pueden empezar por el signo de dólar ($). Introduce un ID de cliente diferente |
INVALID_TOPIC |
Este tema no es válido. El tamaño de los temas debe estar dentro de los 256 bytes, contener menos de 9 partes y no comenzar con el signo de dólar ($) |
INVALID_TIMEOUT_PARAMETER |
El valor de tiempo de espera no es válido. Debe ser un número entero comprendido entre 1 y 15 |
INVALID_CONFIRMATION_PARAMETER |
Valor de confirmación no válido. Debe ser «verdadero» o «falso» |
RECEIVE_AUTHORIZATION_FAILURE |
No se pudo autorizar al cliente de destino. Verifique que su política otorgue los permisos necesarios |
TARGET_CLIENT_ID_NOT_FOUND |
No se encuentra el ID de cliente. Compruebe que el cliente está conectado e inténtelo de nuevo |
TARGET_CLIENT_NOT_CONNECTED |
El ID del cliente de destino no está conectado, pero tiene una sesión persistente activa |
SEND_DIRECT_MESSAGE_THROTTLED |
La solicitud se ha denegado porque se ha superado la velocidad de solicitudes de envío de mensajes directos |
RECEIVE_SESSION_THROTTLED |
La solicitud se rechazó porque la velocidad de solicitudes superó la cantidad de solicitudes de publicación salientes por segundo por conexión |
RECEIVER_MAX_UNACKED_QOS1_EXCEEDED |
El cliente receptor ha alcanzado el número máximo de mensajes de QoS 1 no confirmados |
DELIVERY_CONFIRMATION_TIMEOUT |
La confirmación de entrega no se recibió dentro del período de tiempo de espera especificado |
DELIVERY_CONFIRMATION_SENDER_DISCONNECT |
El remitente se desconectó antes de recibir la confirmación de entrega |
CLIENT_ENDPOINT_NOT_WRITABLE |
No se puede escribir en el punto final del cliente receptor |
INTERNAL_SERVER_ERROR |
Error del servidor interno |
Entradas de registro de OCSP de certificados de servidor
AWS IoT Core genera entradas de registro para el siguiente evento:
Temas
RetrieveOCSPStapleData entrada de registro
AWS IoT Core genera una entrada de registro con un valor eventType de RetrieveOCSPStapleData cuando el servidor recupera los datos básicos del OCSP.
RetrieveOCSPStapleData ejemplos de entradas de registro
Lo que sigue es una entrada de registro de Success de ejemplo.
{ "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" } }
Lo que sigue es una entrada de registro de Failure de ejemplo.
{ "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 la RetrieveOCSPStaple operación, además deAtributos comunes CloudWatch de los registros, las entradas de registro contienen los siguientes atributos:
- razón
-
Es el motivo por el que la operación falla.
- dominio ConfigName
-
Es el nombre de la configuración del dominio.
- connectionDetails
-
Es una explicación breve de los detalles de la conexión.
-
http StatusCode
Códigos de estado de HTTP que devuelve el respondedor de OCSP en respuesta a la solicitud del cliente realizada al servidor.
-
ocsp ResponderUri
El URI del respondedor OCSP que se AWS IoT Core obtiene del certificado del servidor.
-
sourceIp
La dirección IP de origen del AWS IoT Core servidor.
-
targetIp
Es la dirección IP de destino del respondedor de OCSP.
-
- ocsp RequestDetails
-
Detalles de la solicitud de OCSP.
-
requesterName
El identificador del AWS IoT Core servidor que envía una solicitud al respondedor OCSP.
-
solicitud CertId
Es el ID del certificado de la solicitud. Este es el ID del certificado para el que se solicita la respuesta del OCSP.
-
- ocsp ResponseDetails
-
Son los detalles de la respuesta del OCSP.
-
respuesta CertId
Es el ID del certificado de la respuesta del OCSP.
-
ocsp ResponseStatus
Es el estado de la respuesta del OCSP.
-
certStatus
El estado del certificado.
-
firma
Es la firma que una entidad de confianza aplica a la respuesta.
-
esto UpdateTime
Es el momento en el que se sabe que el estado que se indica es correcto.
-
siguiente UpdateTime
Es la hora a la que estará disponible la información más reciente sobre el estado del certificado.
-
producido AtTime
Es la hora en la que el respondedor del OCSP firmó esta respuesta.
-
grapado DataPayloadSize
Es el tamaño de la carga útil de los datos asociados.
-
RetrieveOCSPStapleData entrada de registro para terminales privados
AWS IoT Core genera una entrada de registro con un valor eventType de RetrieveOCSPStapleData cuando el servidor recupera los datos básicos del OCSP.
RetrieveOCSPStapleData ejemplos de entradas de registro para puntos finales privados
Lo que sigue es una entrada de registro de Success de ejemplo.
{ "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" } }
Lo que sigue es una entrada de registro de Failure de ejemplo.
{ "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 la RetrieveOCSPStaple operación, además de los atributos Atributos comunes CloudWatch de los registros y los atributos de la entrada de RetrieveOCSPStapleData registro, las entradas de registro de los puntos finales privados contienen los siguientes atributos:
- lambdaDetails
-
Detalles de la función de Lambda.
-
lambdaArn
El ARN de la función de Lambda.
-
sourceArn
El ARN de la configuración del dominio.
-
- autorizado ResponderArn
-
El ARN del respondedor del autorizador, si hay uno configurado en la configuración del dominio.
Entradas de registro de sombre de dispositivo
El servicio AWS IoT Device Shadow genera entradas de registro para los siguientes eventos:
Temas
DeleteThingShadow entrada de registro
El servicio de sombra de dispositivo genera una entrada de registro con un eventType de DeleteThingShadow cuando se recibe una solicitud de eliminación de la sombra de un dispositivo.
DeleteThingShadow ejemplo 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" }
Además deAtributos comunes CloudWatch de los registros, las entradas de DeleteThingShadow registro contienen los siguientes atributos:
- dispositivo ShadowName
-
Nombre de la sombra que se va a actualizar.
- protocol
-
El protocolo utilizado para realizar la solicitud. Los valores válidos son
MQTToHTTP. - topicName
-
El nombre del tema en el que se publicó la solicitud.
GetThingShadow entrada de registro
El servicio de sombra de dispositivo genera una entrada de registro con un eventType de GetThingShadow cuando se recibe una solicitud de obtención para una sombra.
GetThingShadow ejemplo 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" }
Además deAtributos comunes CloudWatch de los registros, las entradas de GetThingShadow registro contienen los siguientes atributos:
- dispositivo ShadowName
-
El nombre de la sombra solicitada.
- protocol
-
El protocolo utilizado para realizar la solicitud. Los valores válidos son
MQTToHTTP. - topicName
-
El nombre del tema en el que se publicó la solicitud.
UpdateThingShadow entrada de registro
El servicio de sombra de dispositivo genera una entrada de registro con un eventType de UpdateThingShadow cuando se recibe una solicitud de actualización de la sombra de un dispositivo.
UpdateThingShadow ejemplo 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" }
Además deAtributos comunes CloudWatch de los registros, las entradas de UpdateThingShadow registro contienen los siguientes atributos:
- dispositivo ShadowName
-
Nombre de la sombra que se va a actualizar.
- protocol
-
El protocolo utilizado para realizar la solicitud. Los valores válidos son
MQTToHTTP. - topicName
-
El nombre del tema en el que se publicó la solicitud.
Entradas del registro del motor de reglas
El motor de AWS IoT reglas genera registros para los siguientes eventos:
Temas
FunctionExecution entrada de registro
El motor de reglas genera una entrada de registro con un eventType de FunctionExecution cuando la consulta SQL de una regla llama a una función externa. Se llama a una función externa cuando la acción de una regla hace una solicitud HTTP a AWS IoT otro servicio web (por ejemplo, al llamar a get_thing_shadow omachinelearning_predict).
FunctionExecution ejemplo 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" }
Además deAtributos comunes CloudWatch de los registros, las entradas de FunctionExecution registro contienen los siguientes atributos:
- clientId
-
N/Apara registrosFunctionExecution. - principalId
-
El ID de la entidad principal que realiza la solicitud.
- recursos
-
Un conjunto de recursos utilizados por las acciones de la regla.
- ruleName
-
El nombre de la regla que coincide.
- topicName
-
El nombre del tema suscrito.
RuleExecution entrada de registro
Cuando el motor de AWS IoT reglas activa la acción de una regla, genera una entrada de RuleExecution registro.
RuleExecution ejemplo 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 con un ejemplo de entrada de registro por lotes
{ "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 } }
Además de Atributos comunes CloudWatch de los registros, las entradas de registro RuleExecution incluyen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- recursos
-
Un conjunto de recursos utilizados por las acciones de la regla.
- ruleAction
-
El nombre de la acción activada.
- ruleName
-
El nombre de la regla que coincide.
- topicName
-
El nombre del tema suscrito.
RuleMatch entrada de registro
El motor de AWS IoT reglas genera una entrada de registro con un valor eventType de RuleMatch cuando el intermediario de mensajes recibe un mensaje que coincide con una regla.
RuleMatch ejemplo 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" }
Además deAtributos comunes CloudWatch de los registros, las entradas de RuleMatch registro contienen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- ruleName
-
El nombre de la regla que coincide.
- topicName
-
El nombre del tema suscrito.
RuleEvaluation entrada de registro limitada
Cuando AWS IoT Rules Engine limita la evaluación de una regla según el límite de evaluaciones de reglas por segundo por cuenta, genera una entrada de registro con un eventType de RuleEvaluation y un motivo como. Throttled
RuleEvaluation ejemplo de entrada de registro limitada
{ "timestamp": "2024-11-13 07:32:27.856", "logLevel": "ERROR", "traceId": "82995222-049b-ee5c-0cd4-15635f052ed3", "accountId": "123456789012", "status": "Failure", "eventType": "RuleEvaluation", "clientId": "57b3b41a-c726-44ab-bcd4-2cc1c2cc4295", "topicName": "N/A", "ruleName": "N/A", "principalId": "N/A", "reason": "Throttled", "details": "Exceeded Rule Evaluations per second per account limit" }
Además de Atributos comunes CloudWatch de los registros, las entradas de registro RuleEvaluation incluyen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- details
-
Una breve explicación del error.
- principalId
-
El ID de la entidad principal que realiza la solicitud. Siempre N/A para esta entrada de registro.
- razón
-
La cadena «Throttled».
- ruleName
-
El nombre de la regla. Siempre N/A para esta entrada de registro.
- topicName
-
El nombre del tema publicado. Siempre N/A para esta entrada de registro.
RuleExecutionThrottled entrada de registro
Cuando el motor de reglas limita la evaluación de una regla debido a un comportamiento malintencionado, como un exceso de solicitudes básicas de ingestión y publicación para reglas inexistentes, el AWS IoT motor de reglas genera una entrada de registro con un valor de. eventType RuleExecutionThrottled
RuleExecutionThrottled ejemplo 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" }
Además deAtributos comunes CloudWatch de los registros, las entradas de RuleExecutionThrottled registro contienen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- details
-
Una breve explicación del error.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- razón
-
La cadena "RuleExecutionThrottled».
- ruleName
-
El nombre de la regla que se debe activar.
- topicName
-
El nombre del tema publicado.
RuleNotFound entrada de registro
Cuando el motor de AWS IoT reglas no puede encontrar una regla con un nombre determinado, genera una entrada de registro con un eventType deRuleNotFound.
RuleNotFound ejemplo 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" }
Además deAtributos comunes CloudWatch de los registros, las entradas de RuleNotFound registro contienen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- details
-
Una breve explicación del error.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- razón
-
La cadena "RuleNotFound».
- ruleName
-
El nombre de la regla que no se pudo encontrar.
- topicName
-
El nombre del tema publicado.
StartingRuleExecution entrada de registro
Cuando el motor de AWS IoT reglas comienza a activar la acción de una regla, genera una entrada de registro con un eventType deStartingRuleExecution.
StartingRuleExecution ejemplo 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" }
Además deAtributos comunes CloudWatch de los registros, las entradas de rule- registro contienen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- principalId
-
El ID de la entidad principal que realiza la solicitud.
- ruleAction
-
El nombre de la acción activada.
- ruleName
-
El nombre de la regla que coincide.
- topicName
-
El nombre del tema suscrito.
Entradas del registro de Job
El servicio de AWS IoT tareas genera entradas de registro para los siguientes eventos. Las entradas de registro se generan cuando se recibe una solicitud de MQTT o HTTP procedente del dispositivo.
Temas
DescribeJobExecution entrada de registro
El servicio de AWS IoT trabajos genera una entrada de registro con un eventType valor de DescribeJobExecution cuando el servicio recibe una solicitud para describir la ejecución de un trabajo.
DescribeJobExecution ejemplo 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." }
Además deAtributos comunes CloudWatch de los registros, las entradas de GetJobExecution registro contienen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- clientToken
-
Identificador único con distinción entre mayúsculas y minúsculas que permite garantizar la idempotencia de la solicitud. Para obtener más información, consulte How to Ensure Idempotency.
- details
-
Información adicional del servicio Jobs.
- jobId
-
El ID de trabajo para la ejecución de trabajos.
- protocol
-
El protocolo utilizado para realizar la solicitud. Los valores válidos son
MQTToHTTP. - topicName
-
El tema utilizado para realizar la solicitud.
GetPendingJobExecution entrada de registro
El servicio AWS IoT de trabajos genera una entrada de registro con un valor eventType de GetPendingJobExecution cuando el servicio recibe una solicitud de ejecución de un trabajo.
GetPendingJobExecution ejemplo 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." }
Además deAtributos comunes CloudWatch de los registros, las entradas de GetPendingJobExecution registro contienen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- clientToken
-
Identificador único con distinción entre mayúsculas y minúsculas que permite garantizar la idempotencia de la solicitud. Para obtener más información, consulte How to Ensure Idempotency.
- details
-
Información adicional del servicio Jobs.
- protocol
-
El protocolo utilizado para realizar la solicitud. Los valores válidos son
MQTToHTTP. - topicName
-
El nombre del tema suscrito.
ReportFinalJobExecutionCount entrada de registro
El servicio de AWS IoT trabajos genera una entrada de registro con un entryType signo de ReportFinalJobExecutionCount cuando se completa un trabajo.
ReportFinalJobExecutionCount ejemplo 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" }
Además deAtributos comunes CloudWatch de los registros, las entradas de ReportFinalJobExecutionCount registro contienen los siguientes atributos:
- details
-
Información adicional del servicio Jobs.
- jobId
-
El ID de trabajo para la ejecución de trabajos.
StartNextPendingJobExecution entrada de registro
Cuando recibe una solicitud para iniciar la siguiente ejecución de trabajo pendiente, el servicio de AWS IoT trabajos genera una entrada de registro con un valor eventType deStartNextPendingJobExecution.
StartNextPendingJobExecution ejemplo 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." }
Además deAtributos comunes CloudWatch de los registros, las entradas de StartNextPendingJobExecution registro contienen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- clientToken
-
Identificador único con distinción entre mayúsculas y minúsculas que permite garantizar la idempotencia de la solicitud. Para obtener más información, consulte How to Ensure Idempotency.
- details
-
Información adicional del servicio Jobs.
- protocol
-
El protocolo utilizado para realizar la solicitud. Los valores válidos son
MQTToHTTP. - topicName
-
El tema utilizado para realizar la solicitud.
UpdateJobExecution entrada de registro
El servicio de AWS IoT trabajos genera una entrada de registro con un eventType valor de UpdateJobExecution cuando el servicio recibe una solicitud para actualizar la ejecución de un trabajo.
UpdateJobExecution ejemplo 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." }
Además deAtributos comunes CloudWatch de los registros, las entradas de UpdateJobExecution registro contienen los siguientes atributos:
- clientId
-
El ID del cliente que realiza la solicitud.
- clientToken
-
Identificador único con distinción entre mayúsculas y minúsculas que permite garantizar la idempotencia de la solicitud. Para obtener más información, consulte How to Ensure Idempotency.
- details
-
Información adicional del servicio Jobs.
- jobId
-
El ID de trabajo para la ejecución de trabajos.
- protocol
-
El protocolo utilizado para realizar la solicitud. Los valores válidos son
MQTToHTTP. - topicName
-
El tema utilizado para realizar la solicitud.
- versionNumber
-
La versión de la ejecución de trabajos.
Entradas de registro de aprovisionamiento de dispositivos
El servicio de aprovisionamiento de AWS IoT dispositivos genera registros para los siguientes eventos.
GetDeviceCredentials entrada de registro
El servicio de aprovisionamiento de AWS IoT dispositivos genera una entrada de registro con un eventType valor de GetDeviceCredential cuando un cliente llamaGetDeviceCredential.
GetDeviceCredentials ejemplo 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." }
Además deAtributos comunes CloudWatch de los registros, las entradas de GetDeviceCredentials registro contienen los siguientes atributos:
- details
-
Una breve explicación del error.
- dispositivo CertificateId
-
El ID del certificado del dispositivo.
ProvisionDevice entrada de registro
El servicio de aprovisionamiento de AWS IoT dispositivos genera una entrada de registro con un eventType valor de ProvisionDevice cuando un cliente llamaProvisionDevice.
ProvisionDevice ejemplo 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." }
Además deAtributos comunes CloudWatch de los registros, las entradas de ProvisionDevice registro contienen los siguientes atributos:
- details
-
Una breve explicación del error.
- dispositivo CertificateId
-
El ID del certificado del dispositivo.
- aprovisionamiento TemplateName
-
El nombre de la plantilla de aprovisionamiento.
Entradas de registro de grupo de objetos dinámicos
AWS IoT Los grupos de cosas dinámicos generan registros para el siguiente evento.
AddThingToDynamicThingGroupsFailed entrada de registro
Cuando AWS IoT no puede agregar algo a los grupos dinámicos especificados, genera una entrada de registro con un eventType deAddThingToDynamicThingGroupsFailed. Esto ocurre cuando un objeto cumplía los criterios para estar en el grupo de objetos dinámico, pero no se pudo agregar a este grupo o se eliminó de él. Esto puede suceder por los motivos siguientes:
-
El objeto ya es miembro del número máximo de grupos.
-
Se utilizó la opción --override-dynamic-groups para agregar el objeto a un grupo de objetos estático. Se eliminó de un grupo de objetos dinámico para hacerlo posible.
Para obtener más información, consulte este artículo sobre las limitaciones y conflictos de los grupos de objetos dinámicos.
AddThingToDynamicThingGroupsFailed ejemplo de entrada de registro
En este ejemplo, se muestra la entrada de registro de un error AddThingToDynamicThingGroupsFailed. En este ejemplo, TestThing cumplía los criterios para figurar en los grupos de cosas dinámicas de la listadynamicThingGroupNames, pero no pudo añadirse a esos grupos dinámicos, tal y como se describe enreason.
{ "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." }
Además delAtributos comunes CloudWatch de los registros, las entradas de AddThingToDynamicThingGroupsFailed registro contienen los siguientes atributos:
- dinámico ThingGroupNames
-
Matriz de los grupos de objetos dinámicos a los que no pudo agregarse el objeto.
- razón
-
Razón por la cual el objeto no pudo agregarse a los grupos dinámicos.
- thingName
-
Nombre del objeto que no pudo agregarse a un grupo de objetos dinámico.
Entradas de registro de indexación de flotas
AWS IoT la indexación de flotas genera entradas de registro para los siguientes eventos.
NamedShadowCountForDynamicGroupQueryLimitExceeded entrada de registro
Se procesan un máximo de 25 sombras con nombre por objeto para los términos de consulta que no son específicos del origen de datos en los grupos dinámicos. Cuando se supere este límite para un objeto, se emitirá el tipo de evento NamedShadowCountForDynamicGroupQueryLimitExceeded.
NamedShadowCountForDynamicGroupQueryLimitExceeded ejemplo de entrada de registro
En este ejemplo, se muestra la entrada de registro de un error NamedShadowCountForDynamicGroupQueryLimitExceeded. En este ejemplo, los resultados DynamicGroup basados en todos los valores pueden ser imprecisos, como se describe en el 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." }
Atributos comunes CloudWatch de los registros
Todas CloudWatch las entradas del registro incluyen los siguientes atributos:
- accountId
-
Tu Cuenta de AWS ID.
- eventType
-
El tipo de evento para el que se generó el registro. El valor del tipo de evento depende del evento que generó la entrada de registro. Cada descripción de entrada de registro incluye el valor de
eventTypepara esa entrada de registro. - logLevel
-
El nivel de registro que se está utilizando. Para obtener más información, consulte Niveles de registro .
- status
-
El estado de la solicitud.
- timestamp
-
La marca de tiempo UTC legible para el ser humano de cuando el cliente se conectó al agente de mensajes de AWS IoT .
- traceId
-
Un identificador generado aleatoriamente que puede utilizarse para correlacionar todos los registros para una solicitud específica.