View a markdown version of this page

CloudWatch Registros AWS IoT entradas de registro - AWS IoT Core

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 .

Entradas de registro del agente de mensajes

El AWS IoT el agente de mensajes genera entradas de registro para los siguientes eventos:

Entrada de registro Connect

El AWS IoT el agente de mensajes genera una entrada de registro con un eventType de Connect cuando se conecta un cliente MQTT.

Ejemplo de entrada en el registro de éxito de una conexión

{ "timestamp": "2017-08-10 15:37:23.476", "logLevel": "INFO", "traceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "accountId": "111122223333", "status": "Success", "eventType": "Connect", "protocol": "MQTT", "clientId": "abf27092886e49a8a5c1922749736453", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "203.0.113.11", "sourcePort": 13490 }

Ejemplo de entrada en el registro de errores de conexión

{ "timestamp": "2026-07-09 23:26:48.827", "logLevel": "ERROR", "traceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "accountId": "111122223333", "status": "Failure", "eventType": "Connect", "protocol": "MQTT", "clientId": "device-12345", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "203.0.113.1", "sourcePort": 11238, "reason": "throttled", "details": "Exceeded Connect requests per second per account limit" }

Además del Común CloudWatch Registra los atributos ,Connect las entradas de 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 MQTT o HTTP.

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 de la Connect fallo de operación. Este campo solo está presente cuando el status es Failure. Los valores válidos son throttled, client_id_throttled o INTERNAL_SERVER_ERROR.

details

Una breve explicación del error. Este campo solo está presente cuando el status es Failure.

Códigos de motivo

Los siguientes códigos de motivo y detalles aparecen en Connect entradas del registro de errores.

Motivo Details
throttled Se ha superado el límite de solicitudes de conexión por segundo por cuenta
client_id_throttled Se ha superado el límite de solicitudes de Connect por segundo por ID de cliente

Entrada de registro Disconnect

El AWS IoT el agente de mensajes genera una entrada de registro con un 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 del Común CloudWatch Registra los atributos ,Disconnect las entradas de 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 MQTT o HTTP.

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

La AWS IoT el agente de mensajes genera una entrada de registro con un eventType de Ping cuando procesa un PINGREQ de MQTT desde 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 DEBUG las entradas de nivel y error se emiten en el ERROR nivel. Como resultado, verá las entradas de error de Ping siempre que se encuentre en el nivel de evento o Resource-specific la anulación que se aplica a la conexión está establecida en ERROR o un nivel más detallado (WARN, INFO, o DEBUG), pero las entradas de éxito de Ping solo se publican cuando ese nivel está establecido en DEBUG. Para configurar estos ajustes, consulte Configure la cuenta y Event-level iniciar sesión AWS IoT (CLI) y Configurar Resource-specific anula en AWS IoT (CLI).

En caso de éxito, el logLevel es DEBUG y el status es Success. 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 Común CloudWatch Registra los atributos, 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 el status es Success.

Solicitar marca de tiempo

La marca de tiempo cuando AWS IoT Core recibió el PINGREQ del cliente.

Marca de tiempo de respuesta

La marca de tiempo cuando AWS IoT Core envió el PINGRESP al cliente. Este campo solo está presente cuando el status es Success.

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 el status es Failure.

details

Una breve explicación del error. Este campo solo está presente cuando el status es Failure.

Connection.AuthNError entrada de registro

El AWS IoT el agente de mensajes genera una entrada de registro con un 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 siempre Failure. Esta entrada de registro corresponde a la Connection.AuthNError CloudWatch métrica.

importante

Connection.AuthNError las entradas de registro son opcionales y están deshabilitadas de forma predeterminada. Se emiten en el ERROR nivel de registro, por lo que a Connection.AuthNError la entrada de registro se publica solo cuando el nivel de evento o Resource-specific la anulación que se aplica a la conexión está establecida en ERROR o un nivel más detallado (WARN, INFO, o DEBUG). Para configurar estos ajustes, consulte Configure la cuenta y Event-level iniciar sesión AWS IoT (CLI) y Configurar Resource-specific anula en AWS IoT (CLI).

nota

Esta entrada de registro se publica en el Cuenta de AWS que posee 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 Común CloudWatch Registra los atributos, las entradas de registro Connection.AuthNError incluyen los siguientes atributos:

protocol

El protocolo utilizado para realizar la solicitud. Los valores válidos son MQTT o HTTP.

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_AUTH y CUSTOM_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.

servidorNameIndication

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 siguiente tabla se enumeran los reason códigos de error y los correspondientes details mensajes que pueden aparecer para un Connection.AuthNError entrada de 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 AWS IoT el agente de mensajes genera una entrada de registro con un 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 del Común CloudWatch Registra los atributos ,DeleteConnection las entradas de 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 AWS IoT el agente de mensajes genera una entrada de registro con un eventType de GetRetainedMessage cuando 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 del Común CloudWatch Registra los atributos ,GetRetainedMessage las entradas de registro contienen los siguientes atributos:

últimoModifiedDate

La fecha y hora de la época, en milisegundos, en la que el mensaje retenido fue almacenado por 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 0 o 1.

topicName

El nombre del tema suscrito.

ListRetainedMessage entrada de registro

El AWS IoT el agente de mensajes genera una entrada de registro con un eventType de ListRetainedMessage cuando 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 del Común CloudWatch Registra los atributos ,ListRetainedMessage las entradas de registro contienen el siguiente atributo:

protocol

El protocolo utilizado para realizar la solicitud. Valor válido: HTTP.

ListSubscriptions entrada de registro

El AWS IoT el agente de mensajes genera una entrada de registro con un 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 Común CloudWatch Registra los atributos, 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 AWS IoT el agente de mensajes genera una entrada de registro con un 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 Común CloudWatch Registra los atributos, 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 AWS IoT el intermediario de mensajes recibe un mensaje de MQTT, genera una entrada de registro con un eventType de Publish-In.

Publish-In ejemplo de entrada en un registro de éxito

{ "timestamp": "2017-08-10 15:39:30.961", "logLevel": "INFO", "traceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "accountId": "111122223333", "status": "Success", "eventType": "Publish-In", "protocol": "MQTT", "topicName": "$aws/things/MyThing/shadow/get", "clientId": "abf27092886e49a8a5c1922749736453", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "203.0.113.12", "sourcePort": 13490, "retain": "True" }

Publish-In ejemplo de entrada en el registro de errores

{ "timestamp": "2026-07-09 22:01:12.858", "logLevel": "ERROR", "traceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "accountId": "111122223333", "status": "Failure", "eventType": "Publish-In", "protocol": "MQTT", "topicName": "testing/topic", "clientId": "device-12345", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "203.0.113.4", "sourcePort": 10872, "reason": "throttled", "details": "Exceeded Inbound publish requests per second per account limit" }

Además del Común CloudWatch Registra los atributos ,Publish-In las entradas de 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 MQTT o HTTP.

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.

razón

El motivo de la Publish-In fallo de operación. Este campo solo está presente cuando status es Failure. Los valores válidos son throttled, connection_throttled, CLIENT_ERROR o INTERNAL_SERVER_ERROR.

details

Una breve explicación del error. Este campo solo está presente cuando status es Failure.

Códigos de motivo

Los siguientes códigos de motivo y detalles aparecen en Publish-In entradas del registro de errores.

Motivo Details
throttled Se ha superado el límite de solicitudes de publicación entrantes por segundo por cuenta
throttled Se ha superado el límite de solicitudes de publicación salientes por segundo por cuenta
throttled Se ha superado el límite de evaluaciones de reglas por segundo por cuenta
throttled Se ha superado el límite de solicitudes de publicación entrantes de mensajes retenidos por segundo por cuenta
throttled Se ha superado el límite de solicitudes de publicación entrantes de mensajes retenidos por segundo por tema
throttled Se ha superado el límite máximo de mensajes retenidos por cuenta
connection_throttled Se ha superado el límite de solicitudes de publicación por segundo por conexión
CLIENT_ERROR Se ha superado el límite máximo de solicitudes de publicación de QoS 1 entrantes no confirmadas

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 de éxito

{ "timestamp": "2017-08-10 15:39:30.961", "logLevel": "INFO", "traceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "accountId": "111122223333", "status": "Success", "eventType": "Publish-Out", "protocol": "MQTT", "topicName": "$aws/things/MyThing/shadow/get", "clientId": "abf27092886e49a8a5c1922749736453", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "203.0.113.13", "sourcePort": 13490 }

Publish-Out ejemplo de entrada en el registro de errores

{ "timestamp": "2026-07-14 21:12:33.026", "logLevel": "ERROR", "traceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "accountId": "111122223333", "status": "Failure", "eventType": "Publish-Out", "protocol": "MQTT", "topicName": "testing/topic", "clientId": "subscriberClientThrottled", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "reason": "connection_throttled", "details": "Exceeded Publish requests per second per connection limit" }

Además del Común CloudWatch Registra los atributos ,Publish-Out las entradas de 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 MQTT o HTTP.

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.

razón

El motivo de la Publish-Out fallo de operación. Este campo solo está presente cuando status es Failure. Los valores válidos son throttled, connection_throttled, CLIENT_ERROR o INTERNAL_SERVER_ERROR.

details

Una breve explicación del error. Este campo solo está presente cuando status es Failure.

Códigos de motivo

Los siguientes códigos de motivo y detalles aparecen en Publish-Out entradas del registro de errores.

Motivo Details
throttled Se ha superado el límite de solicitudes de publicación salientes por segundo por cuenta
connection_throttled Se ha superado el límite de solicitudes de publicación por segundo por conexión
connection_throttled Se ha superado el límite máximo de solicitudes de publicación de QoS 1 salientes no confirmadas
CLIENT_ERROR No se puede escribir en el punto final del cliente
CLIENT_ERROR El cliente no está conectado

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 EventType 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": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "accountId": "111122223333", "topicName": "$aws/things/MyThing/get", "clientId": "123123123", "qos": "1", "protocol": "MQTT", "eventType": "Queued", "status": "Failure", "details": "Server Error" }

Además del Común CloudWatch Registra los atributos ,Queued las entradas del registro de errores del servidor contienen los siguientes atributos:

clientId

El ID del cliente al que se pone el mensaje en cola.

details
Error de servidor

Un 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": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "accountId": "111122223333", "topicName": "$aws/things/MyThing/get", "clientId": "123123123", "qos": "1", "protocol": "MQTT", "eventType": "Queued", "status": "Success" }

Además del Común CloudWatch Registra los atributos ,Queued las entradas del registro de é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": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "accountId": "111122223333", "topicName": "$aws/things/MyThing/get", "clientId": "123123123", "qos": "1", "protocol": "MQTT", "eventType": "Queued", "status": "Failure", "reason": "connection_throttled", "details": "Throttled while queueing offline message" }

Además del Común CloudWatch Registra los atributos ,Queued las entradas de registro limitadas contienen los siguientes atributos:

clientId

El ID del cliente al que se pone el mensaje en cola.

details

Una breve explicación del error. ¿Cuándo status es Failure, el valor es Throttled while queueing offline message.

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.

razón
connection_throttled

El cliente superó el límite Publish requests per second per connection, por lo que el mensaje no se almacenó.

estrangulado

La cuenta superó el Queued messages per second per account límite, por lo que el mensaje no se almacenó.

topicName

El nombre del tema suscrito.

Entrada de registro de suscripción

El AWS IoT el agente de mensajes genera una entrada de registro con un eventType de Subscribe cuando un cliente MQTT se suscribe a un tema.

Ejemplo de entrada en el registro de éxito de una suscripción en MQTT 3

{ "timestamp": "2017-08-10 15:39:04.413", "logLevel": "INFO", "traceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "accountId": "111122223333", "status": "Success", "eventType": "Subscribe", "protocol": "MQTT", "topicName": "$aws/things/MyThing/shadow/#", "clientId": "abf27092886e49a8a5c1922749736453", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "203.0.113.14", "sourcePort": 13490 }

Ejemplo de entrada en un registro de errores al suscribirse

{ "timestamp": "2026-07-09 23:07:45.633", "logLevel": "ERROR", "traceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "accountId": "111122223333", "status": "Failure", "eventType": "Subscribe", "protocol": "MQTT", "topicName": "subscribe/test", "clientId": "device-12345", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "203.0.113.2", "sourcePort": 10494, "reason": "throttled", "details": "Exceeded Subscriptions per second per account limit" }

Además del Común CloudWatch Registra los atributos ,Subscribe las entradas de 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.

razón

El motivo de la Subscribe fallo de operación. Este campo solo está presente cuando status es Failure. Los valores válidos son throttled, CLIENT_ERROR o INTERNAL_SERVER_ERROR.

details

Una breve explicación del error. Este campo solo está presente cuando status es Failure.

Ejemplo de entrada de registro de suscripción de MQTT 5

{ "timestamp": "2022-11-30 16:24:15.628", "logLevel": "INFO", "traceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "accountId": "111122223333", "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": "203.0.113.15", "sourcePort": 13490 }

Para las operaciones de suscripción a MQTT 5, además de Común CloudWatch Registra los atributos y el Atributos de entrada de registro de suscripción, MATT 5 Subscribe las entradas de registro 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.

Códigos de motivo

Los siguientes códigos de motivo y detalles aparecen en Subscribe entradas del registro de errores.

Motivo Details
throttled Se ha superado el límite de suscripciones por segundo por cuenta
throttled Se ha superado el límite de suscripciones por cuenta
throttled Se ha superado el límite de suscripciones por conexión
throttled Se ha superado el límite de suscripciones compartidas por grupo
throttled Se ha superado el límite de solicitudes de suscripción y cancelación de suscripción por segundo por grupo
CLIENT_ERROR El paquete de suscripción reutiliza un identificador de paquete de una solicitud anterior no confirmada
CLIENT_ERROR El cliente no está conectado
CLIENT_ERROR Se ha superado el límite máximo de suscripciones por solicitud de suscripción
CLIENT_ERROR Filtro de tema no válido

Entrada de registro Unsubscribe

El AWS IoT el agente de mensajes genera una entrada de registro con un eventType de Unsubscribe cuando un cliente MQTT cancela la suscripción a un tema de MQTT.

Ejemplo de entrada de registro de éxito para cancelar la suscripción

{ "timestamp": "2024-08-20 22:53:32.844", "logLevel": "INFO", "traceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "accountId": "111122223333", "status": "Success", "eventType": "Unsubscribe", "protocol": "MQTT", "clientId": "abf27092886e49a8a5c1922749736453", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "203.0.113.16", "sourcePort": 13490 }

Ejemplo de entrada de registro de errores al cancelar la suscripción

{ "timestamp": "2026-01-07 15:37:23.476", "logLevel": "ERROR", "traceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "accountId": "111122223333", "status": "Failure", "eventType": "Unsubscribe", "protocol": "MQTT", "clientId": "device-12345", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "203.0.113.3", "sourcePort": 26051, "reason": "throttled", "details": "Exceeded Unsubscribe requests per second per account limit" }

Además del Común CloudWatch Registra los atributos ,Unsubscribe las entradas de 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.

razón

El motivo de la Unsubscribe fallo de operación. Este campo solo está presente cuando el status es Failure. Los valores válidos son throttled, CLIENT_ERROR o INTERNAL_SERVER_ERROR.

details

Una breve explicación del error. Este campo solo está presente cuando el status es Failure.

Códigos de motivo

Los siguientes códigos de motivo y detalles aparecen en Unsubscribe entradas del registro de errores.

Motivo Details
throttled Se ha superado el límite de solicitudes de cancelación de suscripción por segundo por cuenta
throttled Se ha superado el límite de solicitudes de suscripción y cancelación de suscripción por segundo y grupo
CLIENT_ERROR El paquete de cancelación de suscripción reutiliza un identificador de paquete de una solicitud anterior no confirmada
CLIENT_ERROR El cliente no está conectado

SendDirectMessage entrada de registro

El AWS IoT el agente de mensajes genera una entrada de registro con un eventType de SendDirectMessage cuando un SendDirectMessage Se realiza una solicitud de API.

AWS IoT Core registros SendDirectMessage eventos para CloudWatch Registra cuando habilitas el registro de IoT. Para obtener más información sobre la configuración del registro, consulte Configuració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 Común CloudWatch Registra los atributos, 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 true o false.

timeout

Tiempo máximo, en segundos, de espera para recibir una confirmación de entrega del cliente receptor. Solo está presente cuando confirmation es true.

razón

El código de motivo del fallo.

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 aparecen en SendDirectMessage 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 rechazó porque se superó la tasa 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:

RetrieveOCSPStapleData entrada de registro

AWS IoT Core genera una entrada de registro con un 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 el RetrieveOCSPStaple operación, además de la Común CloudWatch Registra los atributos , las entradas del registro contienen los siguientes atributos:

razón

Es el motivo por el que la operación falla.

dominioConfigName

Es el nombre de la configuración del dominio.

connectionDetails

Es una explicación breve de los detalles de la conexión.

  • httpStatusCode

    Códigos de estado de HTTP que devuelve el respondedor de OCSP en respuesta a la solicitud del cliente realizada al servidor.

  • ocspResponderUri

    El URI del respondedor OCSP que 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.

ocspRequestDetails

Detalles de la solicitud de OCSP.

  • requesterName

    El identificador del AWS IoT Core servidor que envía una solicitud al respondedor OCSP.

  • solicitudCertId

    Es el ID del certificado de la solicitud. Este es el ID del certificado para el que se solicita la respuesta del OCSP.

ocspResponseDetails

Son los detalles de la respuesta del OCSP.

  • respuestaCertId

    Es el ID del certificado de la respuesta del OCSP.

  • ocspResponseStatus

    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.

  • estoUpdateTime

    Es el momento en el que se sabe que el estado que se indica es correcto.

  • próximoUpdateTime

    Es la hora a la que estará disponible la información más reciente sobre el estado del certificado.

  • producidoAtTime

    Es la hora en la que el respondedor del OCSP firmó esta respuesta.

  • grapadoDataPayloadSize

    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 eventType de RetrieveOCSPStapleData cuando el servidor recupera los datos básicos del OCSP.

RetrieveOCSPStapleData ejemplos de entradas de registro para terminales 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 el RetrieveOCSPStaple operación, además de la Común CloudWatch Registra los atributos y los atributos en RetrieveOCSPStapleData entrada de 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.

autorizadoResponderArn

El ARN del respondedor del autorizador, si hay uno configurado en la configuración del dominio.

Entradas de registro de sombre de dispositivo

El AWS IoT El servicio Device Shadow genera entradas de registro para los siguientes eventos:

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 del Común CloudWatch Registra los atributos ,DeleteThingShadow las entradas de registro contienen los siguientes atributos:

dispositivoShadowName

Nombre de la sombra que se va a actualizar.

protocol

El protocolo utilizado para realizar la solicitud. Los valores válidos son MQTT o HTTP.

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 del Común CloudWatch Registra los atributos ,GetThingShadow las entradas de registro contienen los siguientes atributos:

dispositivoShadowName

El nombre de la sombra solicitada.

protocol

El protocolo utilizado para realizar la solicitud. Los valores válidos son MQTT o HTTP.

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 del Común CloudWatch Registra los atributos ,UpdateThingShadow las entradas de registro contienen los siguientes atributos:

dispositivoShadowName

Nombre de la sombra que se va a actualizar.

protocol

El protocolo utilizado para realizar la solicitud. Los valores válidos son MQTT o HTTP.

topicName

El nombre del tema en el que se publicó la solicitud.

Entradas del registro del motor de reglas

El AWS IoT el motor de reglas genera registros para los siguientes eventos:

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 u otro servicio web (por ejemplo, llamar get_thing_shadow).

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 del Común CloudWatch Registra los atributos ,FunctionExecution las entradas de registro contienen los siguientes atributos:

clientId

N/A para registros FunctionExecution.

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 AWS IoT el motor de reglas desencadena la acción de una regla, genera un RuleExecution entrada de 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 Común CloudWatch Registra los atributos, 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 AWS IoT el motor de reglas genera una entrada de registro con un 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 del Común CloudWatch Registra los atributos ,RuleMatch las entradas de 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

¿Cuándo AWS IoT Rules Engine limita la evaluación de reglas según el límite de evaluaciones de reglas por segundo por cuenta, genera una entrada de registro con un eventType de RuleEvaluation y razonar 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 Común CloudWatch Registra los atributos, 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 ingesta y publicación de reglas inexistentes, AWS IoT el motor de reglas genera una entrada de registro con un eventType de 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 del Común CloudWatch Registra los atributos ,RuleExecutionThrottled las entradas de 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 AWS IoT el motor de reglas no puede encontrar una regla con un nombre determinado, genera una entrada de registro con un eventType de RuleNotFound.

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 del Común CloudWatch Registra los atributos ,RuleNotFound las entradas de 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 AWS IoT el motor de reglas comienza a activar la acción de una regla, genera una entrada de registro con un eventType de StartingRuleExecution.

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 del Común CloudWatch Registra los atributos ,rule- las entradas de 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 AWS IoT El servicio de trabajos 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.

DescribeJobExecution entrada de registro

El AWS IoT El servicio Jobs genera una entrada de registro con un eventType de DescribeJobExecution cuando el servicio recibe una solicitud para describir la ejecución de una tarea.

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 del Común CloudWatch Registra los atributos ,GetJobExecution las entradas de 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 MQTT o HTTP.

topicName

El tema utilizado para realizar la solicitud.

GetPendingJobExecution entrada de registro

El AWS IoT El servicio Jobs genera una entrada de registro con un 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 del Común CloudWatch Registra los atributos ,GetPendingJobExecution las entradas de 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 MQTT o HTTP.

topicName

El nombre del tema suscrito.

ReportFinalJobExecutionCount entrada de registro

El AWS IoT El servicio Jobs genera una entrada de registro con un entryType 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 del Común CloudWatch Registra los atributos ,ReportFinalJobExecutionCount las entradas de 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, AWS IoT El servicio Jobs genera una entrada de registro con un eventType de StartNextPendingJobExecution.

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 del Común CloudWatch Registra los atributos ,StartNextPendingJobExecution las entradas de 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 MQTT o HTTP.

topicName

El tema utilizado para realizar la solicitud.

UpdateJobExecution entrada de registro

El AWS IoT El servicio Jobs genera una entrada de registro con un eventType de UpdateJobExecution cuando el servicio recibe una solicitud para actualizar la ejecución de una tarea.

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 del Común CloudWatch Registra los atributos ,UpdateJobExecution las entradas de 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 MQTT o HTTP.

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 AWS IoT El servicio de aprovisionamiento de dispositivos genera registros para los siguientes eventos.

GetDeviceCredentials entrada de registro

El AWS IoT El servicio de aprovisionamiento de dispositivos genera una entrada de registro con un eventType de GetDeviceCredential cuando un cliente llama GetDeviceCredential.

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 del Común CloudWatch Registra los atributos ,GetDeviceCredentials las entradas de registro contienen los siguientes atributos:

details

Una breve explicación del error.

dispositivoCertificateId

El ID del certificado del dispositivo.

ProvisionDevice entrada de registro

El AWS IoT El servicio de aprovisionamiento de dispositivos genera una entrada de registro con un eventType de ProvisionDevice cuando un cliente llama ProvisionDevice.

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 del Común CloudWatch Registra los atributos ,ProvisionDevice las entradas de registro contienen los siguientes atributos:

details

Una breve explicación del error.

dispositivoCertificateId

El ID del certificado del dispositivo.

aprovisionamientoTemplateName

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

¿Cuándo AWS IoT no pudo agregar nada a los grupos dinámicos especificados, genera una entrada de registro con un eventType de AddThingToDynamicThingGroupsFailed. 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 estar en los grupos de cosas dinámicas que figuran en dynamicThingGroupNames, pero no se pudo agregar a esos grupos dinámicos, tal como se describe en reason.

{ "timestamp": "2020-03-16 22:24:43.804", "logLevel": "ERROR", "traceId": "70b1f2f5-d95e-f897-9dcc-31e68c3e1a30", "accountId": "57EXAMPLE833", "status": "Failure", "eventType": "AddThingToDynamicThingGroupsFailed", "thingName": "TestThing", "dynamicThingGroupNames": [ "DynamicThingGroup11", "DynamicThingGroup12", "DynamicThingGroup13", "DynamicThingGroup14" ], "reason": "The thing failed to be added to the given dynamic thing group(s) because the thing already belongs to the maximum allowed number of groups." }

Además del Común CloudWatch Registra los atributos , AddThingToDynamicThingGroupsFailed las entradas de registro contienen los siguientes atributos:

dinámicaThingGroupNames

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

Común CloudWatch Registra los atributos

Todos CloudWatch Las entradas del registro incluyen los siguientes atributos:

accountId

Su Cuenta de AWS NIÑO.

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 eventType para 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.