View a markdown version of this page

CloudWatch 日志 Amazon IoT 日志条目 - Amazon IoT Core
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

CloudWatch 日志 Amazon IoT 日志条目

的每个组件 Amazon IoT 生成自己的日志条目。每个日志条目都有一个 eventType 指定导致生成日志条目的操作。本部分介绍以下 Amazon IoT 组件所生成的日志条目。

消息代理日志条目

这个 Amazon IoT 消息代理为以下事件生成日志条目:

Connect 日志条目

这个 Amazon IoT 消息代理生成一个带有 eventType 的 Connect 当 MQTT 客户端连接时。

连接成功日志条目示例

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

连接失败日志条目示例

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

除了 常见 CloudWatch 日志属性 ,Connect 日志条目包含以下属性:

clientId

发出请求的客户端的 ID。

principalId

发出请求的委托人的 ID。

protocol

用于提出请求的协议。有效值为 MQTT 或 HTTP。

sourceIp

请求的源 IP 地址。

sourcePort

请求的源端口。

reason

其原因 Connect 操作失败。此字段仅在以下情况下出现 status 是 Failure。有效值为 throttled、client_id_throttled 或 INTERNAL_SERVER_ERROR。

details

错误的简要说明。此字段仅在以下情况下出现 status 是 Failure。

原因代码

以下原因代码和详细信息显示在 Connect 失败日志条目。

Reason 说明
throttled 超过了每个账户每秒 Connect 请求的上限
client_id_throttled 超过了每个客户端 ID 的每秒 Connect 请求数限制

Disconnect 日志条目

这个 Amazon IoT 消息代理生成一个带有 eventType 的 Disconnect 当 MQTT 客户端断开连接时。

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

除了 常见 CloudWatch 日志属性 ,Disconnect 日志条目包含以下属性:

clientId

发出请求的客户端的 ID。

principalId

发出请求的委托人的 ID。

protocol

用于提出请求的协议。有效值为 MQTT 或 HTTP。

sourceIp

请求的源 IP 地址。

sourcePort

请求的源端口。

reason

客户端断开连接的原因。

details

错误的简要说明。

disconnectReason

客户端断开连接的原因。

Ping 日志条目

这个 Amazon IoT 消息代理生成一个带有 eventType 的 Ping 当它处理来自连接的客户端的 MQTT PINGREQ 并发送相应的 PINGRESP 时。每个 Ping 操作都会发出一个日志条目。

重要

默认情况下,Ping 日志条目是可选启用和禁用的。排放阈值与每次参赛的结果相匹配:成功参赛作品的发射时间为 DEBUG 级别和失败条目在 ERROR 级别。因此,无论何时发生事件级别或,您都会看到 Ping 失败条目 Resource-specific 适用于连接的覆盖设置为 ERROR 或者更详细的级别 (WARN, INFO,或 DEBUG),但是只有当该级别设置为时,才会发布 Ping 成功参赛作品 DEBUG。要配置这些设置,请参阅 配置账户和 Event-level 登录 Amazon IoT (CLI) 和 配置 Resource-specific 覆盖 Amazon IoT (CLI)。

成功后, logLevel 是 DEBUG 还有 status 是 Success。失败时(例如,当客户端连接在发送 PINGRESP 之前终止时), logLevel 是 ERROR 还有 status 是 Failure。

Ping 日志条目示例(成功)

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

Ping 日志条目示例(失败)

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

除了 常见 CloudWatch 日志属性 之外,Ping 日志条目还包含以下属性:

protocol

用于提出请求的协议。此值始终为 MQTT。

延迟

从接收 PINGREQ 到发送 PINGREP 之间的时间(以毫秒为单位)。此字段仅在以下情况下出现 status 是 Success。

请求时间戳

时间戳是 Amazon IoT Core 从客户端收到了 PINGREQ。

响应时间戳

时间戳是 Amazon IoT Core 已将 PINGRESP 发送给客户端。此字段仅在以下情况下出现 status 是 Success。

clientId

发出请求的客户端的 ID。

principalId

发出请求的委托人的 ID。

sourceIp

请求的源 IP 地址。

sourcePort

请求的源端口。

reason

Ping 操作失败的原因。此字段仅在以下情况下出现 status 是 Failure。

details

错误的简要说明。此字段仅在以下情况下出现 status 是 Failure。

Connection.AuthNError 日志条目

这个 Amazon IoT 消息代理生成一个带有 eventType 的 Connection.AuthNError 当客户端连接尝试由于身份验证失败而被拒绝时。这个 logLevel 因为这个日志条目始终是 ERROR 还有 status 永远是 Failure。此日志条目对应于 Connection.AuthNError CloudWatch 公制。

重要

Connection.AuthNError 默认情况下,日志条目是可选启用和禁用的。它们发射在 ERROR 日志级别,所以 Connection.AuthNError 只有在事件级别或,才会发布日志条目 Resource-specific 适用于连接的覆盖设置为 ERROR 或者更详细的级别 (WARN, INFO,或 DEBUG)。要配置这些设置,请参阅 配置账户和 Event-level 登录 Amazon IoT (CLI) 和 配置 Resource-specific 覆盖 Amazon IoT (CLI)。

注意

此日志条目发布到 Amazon Web Services 账户 它拥有 TLS 握手中提供的服务器名称指示 (SNI)。如果客户端不提供 SNI,或者无法将 SNI 解析到账户,则不会发出任何日志条目或指标。

Connection.AuthNError 日志条目示例

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

除了 常见 CloudWatch 日志属性 之外,Connection.AuthNError 日志条目还包含以下属性:

protocol

用于提出请求的协议。有效值为 MQTT 或 HTTP。

身份验证类型

用于连接尝试的身份验证类型。有效值为 AWS_X509、AWS_SIGV4、CUSTOM_AUTH 和 CUSTOM_AUTH_X509。

clientId

提出请求的客户端 ID(如果有)。

principalId

提出请求的委托人的 ID(如果有)。

sourceIp

请求的源 IP 地址。

sourcePort

请求的源端口。

targetIp

连接的目标 IP 地址。此字段可能不存在于所有日志条目中。

目标端口

连接的目标端口。

服务器NameIndication

客户端提供的 TLS 服务器名称指示 (SNI) 扩展主机名。

reason

客户端身份验证失败的原因。参见 Connection.AuthNError 错误代码 获取可能值的列表。

details

身份验证失败的简要描述。

Connection.AuthNError 错误代码

下表列出了 reason 错误代码和相应的 details 可能出现的消息 Connection.AuthNError 日志条目。将来可能会添加其他错误代码。

错误代码 错误消息
CUSTOM_AUTHORIZER_LAMBDA_EXECUTION_ERROR 自定义授权器 Lambda 调用失败
CUSTOM_AUTHORIZER_NOT_FOUND 找不到自定义授权器
CUSTOM_AUTHORIZER_PARAMETER_INVALID 自定义身份验证参数无效
DEVICE_CERTIFICATE_INACTIVE 设备证书未激活
DEVICE_CERTIFICATE_NOT_REGISTERED 设备证书未注册
DEVICE_CERTIFICATE_REVOKED 设备证书已吊销
DOMAIN_CONFIGURATION_DISABLED 提供的服务器名称指示 (SNI) 的域配置已禁用
DOMAIN_CONFIGURATION_INVALID 域配置中的端点类型无效
INTERNAL_SERVER_ERROR 内部服务器错误
NOT_AUTHENTICATED 提供的凭据无法进行身份验证
SECURITY_TOKEN_EXPIRED 安全令牌已过期
SECURITY_TOKEN_INVALID 请求中包含的安全令牌无效
SECURITY_TOKEN_SIGNATURE_MISMATCH 请求签名与提供的签名不匹配
SNI_MISUSED 客户使用了与此账户无关的 SNI

DeleteConnection 日志条目

这个 Amazon IoT 消息代理使用以下内容生成日志条目 eventType 的 DeleteConnection 删除 MQTT 客户端连接时。

DeleteConnection 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,DeleteConnection 日志条目包含以下属性:

clientId

将被断开连接的客户端的 ID。

principalId

发出请求的委托人的 ID。有关如何使用主体 ID 识别主体的信息,请参阅《IAM 用户指南》中的比较 IAM 身份和凭证。

protocol

用于提出请求的协议。有效值为 HTTP。

sourceIp

请求的源 IP 地址。

sourcePort

请求的源端口。

GetRetainedMessage 日志条目

这个 Amazon IoT 消息代理使用以下内容生成日志条目 eventType 的 GetRetainedMessage 什么时候 GetRetainedMessage 被称为。

GetRetainedMessage 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,GetRetainedMessage 日志条目包含以下属性:

最后的ModifiedDate

存储保留消息时的 Epoch 日期和时间,以毫秒为单位 Amazon IoT。

protocol

用于提出请求的协议。有效值:HTTP。

qos

发布请求中使用的服务质量(QoS)级别。有效值为 0 或 1。

topicName

已订阅主题的名称。

ListRetainedMessage 日志条目

这个 Amazon IoT 消息代理使用以下内容生成日志条目 eventType 的 ListRetainedMessage 什么时候 ListRetainedMessages 被称为。

ListRetainedMessage 日志条目示例

{ "timestamp": "2017-08-07 18:47:56.664", "logLevel": "INFO", "traceId": "1a60d02e-15b9-605b-7096-a9f584a6ad3f", "accountId": "123456789012", "status": "Success", "eventType": "ListRetainedMessage", "protocol": "HTTP" }

除了 常见 CloudWatch 日志属性 ,ListRetainedMessage 日志条目包含以下属性:

protocol

用于提出请求的协议。有效值:HTTP。

ListSubscriptions 日志条目

这个 Amazon IoT 消息代理使用以下内容生成日志条目 eventType 的 ListSubscriptions 当收到列出客户订阅的请求时。

ListSubscriptions 日志条目示例

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

除了 常见 CloudWatch 日志属性 之外,ListSubscriptions 日志条目还包含以下属性:

clientId

发出请求的客户端的 ID。

principalId

发出请求的委托人的 ID。

protocol

用于提出请求的协议。有效值:HTTP。

sourceIp

请求的源 IP 地址。

sourcePort

请求的源端口。

maxResults

请求的最大结果数。

GetConnection 日志条目

这个 Amazon IoT 消息代理使用以下内容生成日志条目 eventType 的 GetConnection 当收到获取连接信息的请求时。

GetConnection 日志条目示例

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

除了 常见 CloudWatch 日志属性 之外,GetConnection 日志条目还包含以下属性:

clientId

发出请求的客户端的 ID。

principalId

发出请求的委托人的 ID。

protocol

用于提出请求的协议。有效值:HTTP。

sourceIp

发起 API 请求的 IP 地址。

sourcePort

发起 API 请求的端口。

Publish-In 日志条目

当 Amazon IoT 消息代理收到 MQTT 消息,它生成一个带有 eventType 的 Publish-In。

Publish-In 成功日志条目示例

{ "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 失败日志条目示例

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

除了 常见 CloudWatch 日志属性 ,Publish-In 日志条目包含以下属性:

clientId

发出请求的客户端的 ID。

principalId

发出请求的委托人的 ID。

protocol

用于提出请求的协议。有效值为 MQTT 或 HTTP。

保留

当消息的 REATIN 标志的值设置为 True 时使用的属性。如果消息未设置 REATIN 标志,则该属性不会显示在日志条目中。有关更多信息,请参阅 MQTT 保留消息。

sourceIp

请求的源 IP 地址。

sourcePort

请求的源端口。

topicName

已订阅主题的名称。

reason

其原因 Publish-In 操作失败。此字段仅在以下情况下出现 status 是 Failure。有效值为 throttled、connection_throttled、CLIENT_ERROR 或 INTERNAL_SERVER_ERROR。

details

错误的简要说明。此字段仅在以下情况下出现 status 是 Failure。

原因代码

以下原因代码和详细信息显示在 Publish-In 失败日志条目。

Reason 说明
throttled 超过了每个账户每秒的入站发布请求上限
throttled 超过了每个账户每秒的出站发布请求上限
throttled 已超过每个账户每秒的规则评估限制
throttled 已超过每个账户每秒保留的留言入站发布请求上限
throttled 已超过每个主题每秒保留的消息入站发布请求上限
throttled 已超过每个账户保留的最大邮件数量限制
connection_throttled 超过了每个连接的每秒发布请求限制
CLIENT_ERROR 已超过未确认的最大入站 QoS 1 发布请求限制

Publish-Out 日志条目

当消息代理发布 MQTT 消息时,它会生成一个 eventType 为 Publish-Out 的日志条目

Publish-Out 成功日志条目示例

{ "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 失败日志条目示例

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

除了 常见 CloudWatch 日志属性 ,Publish-Out 日志条目包含以下属性:

clientId

接收有关该 MQTT 主题的消息的订阅客户端的 ID。

principalId

发出请求的委托人的 ID。

protocol

用于提出请求的协议。有效值为 MQTT 或 HTTP。

sourceIp

请求的源 IP 地址。

sourcePort

请求的源端口。

topicName

已订阅主题的名称。

reason

其原因 Publish-Out 操作失败。此字段仅在以下情况下出现 status 是 Failure。有效值为 throttled、connection_throttled、CLIENT_ERROR 或 INTERNAL_SERVER_ERROR。

details

错误的简要说明。此字段仅在以下情况下出现 status 是 Failure。

原因代码

以下原因代码和详细信息显示在 Publish-Out 失败日志条目。

Reason 说明
throttled 超过了每个账户每秒的出站发布请求上限
connection_throttled 超过了每个连接的每秒发布请求限制
connection_throttled 已超过未确认的出站 QoS 1 发布请求上限
CLIENT_ERROR 客户端端点不可写入
CLIENT_ERROR 客户机未连接

排队的日志条目

当具有持续会话的设备断开连接时,MQTT 消息代理会存储该设备的消息和 Amazon IoT 生成 eventType 为的日志条目 Queued。有关 MQTT 持久会话的更多信息,请参阅 MQTT 持久会话 。

排队的服务器错误日志条目示例

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

除了 常见 CloudWatch 日志属性 ,Queued 服务器错误日志条目包含以下属性:

clientId

消息排队的客户端的 ID。

details
服务器错误

服务器错误导致无法存储消息。

protocol

用于提出请求的协议。该值始终为 MQTT。

qos

请求的服务质量(QoS)级别。该值将始终为 1,因为不存储 QoS 为 0 的消息。

topicName

已订阅主题的名称。

排队的成功日志条目示例

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

除了 常见 CloudWatch 日志属性 ,Queued 成功日志条目包含以下属性:

clientId

消息排队的客户端的 ID。

protocol

用于提出请求的协议。该值始终为 MQTT。

qos

请求的服务质量(QoS)级别。该值将始终为 1,因为不存储 QoS 为 0 的消息。

topicName

已订阅主题的名称。

排队的限制日志条目示例

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

除了 常见 CloudWatch 日志属性 ,Queued 限制的日志条目包含以下属性:

clientId

消息排队的客户端的 ID。

details

错误的简要说明。什么时候 status 是 Failure,值是 Throttled while queueing offline message。

protocol

用于提出请求的协议。该值始终为 MQTT。

qos

请求的服务质量(QoS)级别。该值将始终为 1,因为不存储 QoS 为 0 的消息。

reason
connection_throttled

客户端超出了 Publish requests per second per connection 限制,因此未存储消息。

节流

该账户超过了 Queued messages per second per account 限制,因此消息未存储。

topicName

已订阅主题的名称。

Subscribe 日志条目

这个 Amazon IoT 消息代理使用以下内容生成日志条目 eventType 的 Subscribe 当 MQTT 客户端订阅主题时。

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 }

订阅失败日志条目示例

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

除了 常见 CloudWatch 日志属性 ,Subscribe 日志条目包含以下属性:

clientId

发出请求的客户端的 ID。

principalId

发出请求的委托人的 ID。

protocol

用于提出请求的协议。该值始终为 MQTT。

sourceIp

请求的源 IP 地址。

sourcePort

请求的源端口。

topicName

已订阅主题的名称。

reason

其原因 Subscribe 操作失败。此字段仅在以下情况下出现 status 是 Failure。有效值为 throttled、CLIENT_ERROR 或 INTERNAL_SERVER_ERROR。

details

错误的简要说明。此字段仅在以下情况下出现 status 是 Failure。

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 }

对于 MQTT 5 订阅操作,除了 常见 CloudWatch 日志属性 还有 订阅日志条目属性,MQTT 5 Subscribe 日志条目包含以下属性:

订阅

订阅请求中的已请求主题与各个 MQTT 5 原因代码之间的映射列表。有关更多信息,请参阅 MQTT 原因代码。

原因代码

以下原因代码和详细信息显示在 Subscribe 失败日志条目。

Reason 说明
throttled 超过了每个账户每秒的订阅量限制
throttled 已超过每个账户的订阅上限
throttled 已超过每个连接的订阅限制
throttled 超过了每个群组的共享订阅限制
throttled 超过了每组每秒的订阅和取消订阅请求上限
CLIENT_ERROR 订阅数据包重复使用先前未确认的请求中的数据包 ID
CLIENT_ERROR 客户机未连接
CLIENT_ERROR 超过了每次订阅请求的最大订阅量限制
CLIENT_ERROR 主题筛选器无效

取消订阅日志条目

这个 Amazon IoT 消息代理使用以下内容生成日志条目 eventType 的 Unsubscribe 当 MQTT 客户端取消订阅 MQTT 主题时。

取消订阅成功日志条目示例

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

取消订阅失败日志条目示例

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

除了 常见 CloudWatch 日志属性 ,Unsubscribe 日志条目包含以下属性:

protocol

用于提出请求的协议。该值始终为 MQTT。

clientId

发出请求的客户端的 ID。

principalId

发出请求的委托人的 ID。

sourceIp

请求的源 IP 地址。

sourcePort

请求的源端口。

reason

其原因 Unsubscribe 操作失败。此字段仅在以下情况下出现 status 是 Failure。有效值为 throttled、CLIENT_ERROR 或 INTERNAL_SERVER_ERROR。

details

错误的简要说明。此字段仅在以下情况下出现 status 是 Failure。

原因代码

以下原因代码和详细信息显示在 Unsubscribe 失败日志条目。

Reason 说明
throttled 超过了每个账户每秒的取消订阅请求上限
throttled 超过了每组每秒的订阅和取消订阅请求上限
CLIENT_ERROR 取消订阅数据包重复使用先前未确认的请求中的数据包 ID
CLIENT_ERROR 客户机未连接

SendDirectMessage 日志条目

这个 Amazon IoT 消息代理使用以下内容生成日志条目 eventType 的 SendDirectMessage 当 SendDirectMessage 已提出 API 请求。

Amazon IoT Core 圆木 SendDirectMessage 活动到 CloudWatch 启用 IoT 日志记录时的日志。有关配置日志记录的更多信息,请参阅 配置 Amazon IoT 日志记录。

SendDirectMessage 成功日志条目示例

{ "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 失败日志条目示例

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

除了 常见 CloudWatch 日志属性 之外,SendDirectMessage 日志条目还包含以下属性:

clientId

接收直接消息的客户端 ID。

topicName

发送消息的主题。

protocol

用于提出请求的协议。有效值:HTTP。

确认

是否要求确认送达。有效值为 true 或 false。

timeout

等待接收客户确认送达的最长时间(以秒为单位)。仅在出现时出现 confirmation 是 true。

reason

失败的原因代码。

details

错误的简要说明。

principalId

发出请求的委托人的 ID。

sourceIp

请求的源 IP 地址。

sourcePort

请求的源端口。

原因代码

以下原因代码和详细信息显示在 SendDirectMessage 失败日志条目。

Reason 说明
MALFORMED_CLIENTID 此客户端 ID 无效。客户端 ID 不得超过 128 个字符,并且不能以美元符号 ($) 开头。输入不同的客户端 ID
INVALID_TOPIC 此主题无效。主题大小必须在 256 字节以内,应包含少于 9 个部分,并且不应以美元符号 ($) 开头
INVALID_TIMEOUT_PARAMETER 超时值无效。必须是 1 到 15 之间的整数
INVALID_CONFIRMATION_PARAMETER 确认值无效。必须为 “真” 或 “假”
RECEIVE_AUTHORIZATION_FAILURE 目标客户机授权失败。验证您的政策是否授予了必要的权限
TARGET_CLIENT_ID_NOT_FOUND 找不到客户端 ID。验证客户端是否已连接,然后重试
TARGET_CLIENT_NOT_CONNECTED 目标客户端 ID 未连接,但它有一个活跃的持续会话
SEND_DIRECT_MESSAGE_THROTTLED 由于超出发送私信请求速率,该请求被拒绝
RECEIVE_SESSION_THROTTLED 请求被拒绝,因为请求速率超过了每个连接每秒的出站发布请求数
RECEIVER_MAX_UNACKED_QOS1_EXCEEDED 接收方客户端已达到未确认的 QoS 1 消息的最大数量
DELIVERY_CONFIRMATION_TIMEOUT 未在指定的超时时间内收到配送确认
DELIVERY_CONFIRMATION_SENDER_DISCONNECT 在收到送达确认之前,发件人已断开连接
CLIENT_ENDPOINT_NOT_WRITABLE 接收方客户端端点不可写入
INTERNAL_SERVER_ERROR 内部服务器错误

服务器证书 OCSP 日志条目

Amazon IoT Core 为以下事件生成日志条目:

RetrieveOCSPStapleData 日志条目

Amazon IoT Core 生成一个带有 eventType 的 RetrieveOCSPStapleData 当服务器检索 OCSP 主要数据时。

RetrieveOCSPStapleData 日志条目示例

以下是 Success 示例日志条目。

{ "timestamp": "2024-01-30 15:39:30.961", "logLevel": "INFO", "traceId": "180532b7-0cc7-057b-687a-5ca1824838f5", "accountId": "123456789012", "status": "Success", "eventType": "RetrieveOCSPStapleData", "domainConfigName": "test-domain-config-name", "connectionDetails": { "httpStatusCode": "200", "ocspResponderUri": "http://ocsp.example.com", "sourceIp": "205.251.233.181", "targetIp": "250.15.5.3" }, "ocspRequestDetails": { "requesterName": "iot.amazonaws.com", "requestCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01" }, "ocspResponseDetails": { "responseCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01", "ocspResponseStatus": "successful", "certStatus": "good", "signature": "4C:6F:63:61:6C:20:52:65:73:70:6F:6E:64:65:72:20:53:69:67:6E:61:74:75:72:65", "thisUpdateTime": "Jan 31 01:21:02 2024 UTC", "nextUpdateTime": "Feb 02 00:21:02 2024 UTC", "producedAtTime": "Jan 31 01:37:03 2024 UTC", "stapledDataPayloadSize": "XXX" } }

以下是 Failure 示例日志条目。

{ "timestamp": "2024-01-30 15:39:30.961", "logLevel": "ERROR", "traceId": "180532b7-0cc7-057b-687a-5ca1824838f5", "accountId": "123456789012", "status": "Failure", "reason": "A non 2xx HTTP response was received from the OCSP responder.", "eventType": "RetrieveOCSPStapleData", "domainConfigName": "test-domain-config-name", "connectionDetails": { "httpStatusCode": "444", "ocspResponderUri": "http://ocsp.example.com", "sourceIp": "205.251.233.181", "targetIp": "250.15.5.3" }, "ocspRequestDetails": { "requesterName": "iot.amazonaws.com", "requestCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01" } }

对于 RetrieveOCSPStaple 操作,除了 常见 CloudWatch 日志属性 ,日志条目包含以下属性:

reason

操作失败的原因。

域ConfigName

域配置的名称。

connectionDetails

连接详情的简要说明。

  • httpStatusCode

    OCSP 响应程序为响应客户端向服务器发出的请求而返回的 HTTP 状态码。

  • ocspResponderUri

    OCSP 响应器 URI 是 Amazon IoT Core 从服务器证书中获取。

  • sourceIp

    的源 IP 地址 Amazon IoT Core 服务器。

  • targetIp

    OCSP 响应程序的目标 IP 地址。

ocspRequestDetails

OCSP 请求的详细信息。

  • requesterName

    的标识符 Amazon IoT Core 向 OCSP 响应者发送请求的服务器。

  • 请求CertId

    请求的证书 ID。这是正在请求 OCSP 响应的证书的 ID。

ocspResponseDetails

OCSP 响应的详细信息。

  • 反应CertId

    OCSP 响应的证书 ID。

  • ocspResponseStatus

    OCSP 响应的状态。

  • certStatus

    证书的状态。

  • signature

    可信实体应用于响应的签名。

  • 这个UpdateTime

    已知所指示状态正确的时间。

  • 下一个UpdateTime

    在此时间或此时间之前,将提供有关证书状态的更新的信息。

  • 生产的AtTime

    OCSP 响应程序签署此响应的时间。

  • 装订DataPayloadSize

    已绑定数据的有效载荷大小。

RetrieveOCSPStapleData 私有端点的日志条目

Amazon IoT Core 生成一个带有 eventType 的 RetrieveOCSPStapleData 当服务器检索 OCSP 主要数据时。

RetrieveOCSPStapleData 私有端点的日志条目示例

以下是 Success 示例日志条目。

{ "timestamp": "2024-01-30 15:39:30.961", "logLevel": "INFO", "traceId": "180532b7-0cc7-057b-687a-5ca1824838f5", "accountId": "123456789012", "status": "Success", "eventType": "RetrieveOCSPStapleData", "domainConfigName": "test-domain-config-name", "lambdaDetails": { "lambdaArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "sourceArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/testDomainConfigure/6bzfg" }, "authorizedResponderArn": "arn:aws:acm:us-west-2:123456789012:certificate/certificate_ID", "ocspRequestDetails": { "requesterName": "iot.amazonaws.com", "requestCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01" }, "ocspResponseDetails": { "responderId": "04:C1:3F:8F:27:D6:49:13:F8:DE:B2:36:9D:85:8E:F8:31:3B:A6:D0" "responseCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01", "ocspResponseStatus": "successful", "certStatus": "good", "signature": "4C:6F:63:61:6C:20:52:65:73:70:6F:6E:64:65:72:20:53:69:67:6E:61:74:75:72:65", "thisUpdateTime": "Jan 31 01:21:02 2024 UTC", "nextUpdateTime": "Feb 02 00:21:02 2024 UTC", "producedAtTime": "Jan 31 01:37:03 2024 UTC", "stapledDataPayloadSize": "XXX" } }

以下是 Failure 示例日志条目。

{ "timestamp": "2024-01-30 15:39:30.961", "logLevel": "ERROR", "traceId": "180532b7-0cc7-057b-687a-5ca1824838f5", "accountId": "123456789012", "status": "Failure", "reason": "The payload returned by the Lambda function exceeds the maximum response size of 7 kilobytes.", "eventType": "RetrieveOCSPStapleData", "domainConfigName": "test-domain-config-name", "lambdaDetails": { "lambdaArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "sourceArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/testDomainConfigure/6bzfg" }, "authorizedResponderArn": "arn:aws:acm:us-west-2:123456789012:certificate/certificate_ID", "ocspRequestDetails": { "requesterName": "iot.amazonaws.com", "requestCertId": "30:3A:30:09:06:05:2B:0E:03:02:1A:05:00:04:14:9C:FF:90:A1:97:B0:4D:6C:01:B9:69:96:D8:3E:E7:A2:51:7F:30:C4:04:14:7C:84:78:AE:12:58:71:38:0C:65:FC:17:77:7D:14:DD:69:73:71:46:02:01:01" } }

对于 RetrieveOCSPStaple 操作,除了 常见 CloudWatch 日志属性 以及其中的属性 RetrieveOCSPStapleData 日志条目,私有端点的日志条目包含以下属性:

lambdaDetails

Lambda 函数的详细信息。

  • lambdaArn

    Lambda 函数的 ARN。

  • sourceArn

    域配置的 ARN。

授权ResponderArn

如果在域配置中配置了授权响应者,则为其 ARN。

设备影子日志条目

这个 Amazon IoT 设备影子服务为以下事件生成日志条目:

DeleteThingShadow 日志条目

当收到删除设备影子的请求时,Device Shadow 服务会生成一个 eventType 为 DeleteThingShadow 的日志条目。

DeleteThingShadow 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,DeleteThingShadow 日志条目包含以下属性:

设备ShadowName

要更新的影子的名称。

protocol

用于提出请求的协议。有效值为 MQTT 或 HTTP。

topicName

发布请求时所基于的主题的名称。

GetThingShadow 日志条目

当收到影子的获取请求时,Device Shadow 服务会生成一个 eventType 为 GetThingShadow 的日志条目。

GetThingShadow 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,GetThingShadow 日志条目包含以下属性:

设备ShadowName

所请求的影子的名称。

protocol

用于提出请求的协议。有效值为 MQTT 或 HTTP。

topicName

发布请求时所基于的主题的名称。

UpdateThingShadow 日志条目

当收到更新设备影子的请求时,Device Shadow 服务会生成一个 eventType 为 UpdateThingShadow 的日志条目。

UpdateThingShadow 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,UpdateThingShadow 日志条目包含以下属性:

设备ShadowName

要更新的影子的名称。

protocol

用于提出请求的协议。有效值为 MQTT 或 HTTP。

topicName

发布请求时所基于的主题的名称。

规则引擎日志条目

这个 Amazon IoT 规则引擎为以下事件生成日志:

FunctionExecution 日志条目

当规则的 SQL 查询调用外部函数时,规则引擎会生成一个 eventType 为 FunctionExecution 的日志条目。当规则的操作向发出 HTTP 请求时,会调用外部函数 Amazon IoT 或其他 Web 服务(例如,调用 get_thing_shadow)。

FunctionExecution 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,FunctionExecution 日志条目包含以下属性:

clientId

N/A(针对 FunctionExecution 日志)。

principalId

发出请求的委托人的 ID。

资源

规则的操作所使用的资源的集合。

ruleName

匹配规则的名称。

topicName

已订阅主题的名称。

RuleExecution 日志条目

当 Amazon IoT 规则引擎触发规则的操作,它生成一个 RuleExecution 日志条目。

RuleExecution 日志条目示例

{ "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 以批处理日志条目为例

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

除了 常见 CloudWatch 日志属性 之外,RuleExecution 日志条目还包含以下属性:

clientId

发出请求的客户端的 ID。

principalId

发出请求的委托人的 ID。

资源

规则的操作所使用的资源的集合。

ruleAction

所触发的操作的名称。

ruleName

匹配规则的名称。

topicName

已订阅主题的名称。

RuleMatch 日志条目

这个 Amazon IoT 规则引擎生成一个带有 eventType 的 RuleMatch 当消息代理收到符合规则的消息时。

RuleMatch 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,RuleMatch 日志条目包含以下属性:

clientId

发出请求的客户端的 ID。

principalId

发出请求的委托人的 ID。

ruleName

匹配规则的名称。

topicName

已订阅主题的名称。

RuleEvaluation 限制的日志条目

什么时候 Amazon IoT 规则引擎限制对每个账户每秒的规则评估限制,它生成一个带有 eventType 的 RuleEvaluation 而理由是 Throttled。

RuleEvaluation 限制的日志条目示例

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

除了 常见 CloudWatch 日志属性 之外,RuleEvaluation 日志条目还包含以下属性:

clientId

发出请求的客户端的 ID。

details

错误的简要说明。

principalId

发出请求的委托人的 ID。永远 N/A 用于此日志条目。

reason

字符串 “节流”。

ruleName

规则的名称。永远 N/A 用于此日志条目。

topicName

已发布主题的名称。永远 N/A 用于此日志条目。

RuleExecutionThrottled 日志条目

当规则评估由于恶意行为(例如对不存在的规则的过多基本采集发布请求)而受到规则引擎限制时, Amazon IoT 规则引擎生成一个带有 eventType 的 RuleExecutionThrottled。

RuleExecutionThrottled 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,RuleExecutionThrottled 日志条目包含以下属性:

clientId

发出请求的客户端的 ID。

details

错误的简要说明。

principalId

发出请求的委托人的 ID。

reason

字符串”RuleExecutionThrottled“。

ruleName

要触发的规则的名称。

topicName

已发布的主题的名称。

RuleNotFound 日志条目

当 Amazon IoT 规则引擎找不到具有给定名称的规则,它会生成一个带有 eventType 的 RuleNotFound。

RuleNotFound 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,RuleNotFound 日志条目包含以下属性:

clientId

发出请求的客户端的 ID。

details

错误的简要说明。

principalId

发出请求的委托人的 ID。

reason

字符串”RuleNotFound“。

ruleName

找不到的规则的名称。

topicName

已发布的主题的名称。

StartingRuleExecution 日志条目

当 Amazon IoT 规则引擎开始触发规则的操作,它生成一个带有 eventType 的 StartingRuleExecution。

StartingRuleExecution 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,rule- 日志条目包含以下属性:

clientId

发出请求的客户端的 ID。

principalId

发出请求的委托人的 ID。

ruleAction

所触发的操作的名称。

ruleName

匹配规则的名称。

topicName

已订阅主题的名称。

任务日志条目

这个 Amazon IoT 任务服务为以下事件生成日志条目。当从设备收到 MQTT 或 HTTP 请求时,将生成日志条目。

DescribeJobExecution 日志条目

这个 Amazon IoT 作业服务生成一个带有 eventType 的 DescribeJobExecution 当服务收到描述任务执行的请求时。

DescribeJobExecution 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,GetJobExecution 日志条目包含以下属性:

clientId

发出请求的客户端的 ID。

clientToken

用于确保请求幂等性的唯一、区分大小写的标识符。有关更多信息,请参阅如何确保幂等性。

details

来自 Jobs 服务的其它信息。

jobId

任务执行的任务 ID。

protocol

用于提出请求的协议。有效值为 MQTT 或 HTTP。

topicName

发出请求所使用的主题。

GetPendingJobExecution 日志条目

这个 Amazon IoT 作业服务生成一个带有 eventType 的 GetPendingJobExecution 当服务收到任务执行请求时。

GetPendingJobExecution 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,GetPendingJobExecution 日志条目包含以下属性:

clientId

发出请求的客户端的 ID。

clientToken

用于确保请求幂等性的唯一、区分大小写的标识符。有关更多信息,请参阅如何确保幂等性。

details

来自 Jobs 服务的其它信息。

protocol

用于提出请求的协议。有效值为 MQTT 或 HTTP。

topicName

已订阅主题的名称。

ReportFinalJobExecutionCount 日志条目

这个 Amazon IoT 作业服务生成一个带有 entryType 的 ReportFinalJobExecutionCount 当作业完成时。

ReportFinalJobExecutionCount 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,ReportFinalJobExecutionCount 日志条目包含以下属性:

details

来自 Jobs 服务的其它信息。

jobId

任务执行的任务 ID。

StartNextPendingJobExecution 日志条目

当它收到启动下一个待执行任务的请求时, Amazon IoT 作业服务生成一个带有 eventType 的 StartNextPendingJobExecution。

StartNextPendingJobExecution 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,StartNextPendingJobExecution 日志条目包含以下属性:

clientId

发出请求的客户端的 ID。

clientToken

用于确保请求幂等性的唯一、区分大小写的标识符。有关更多信息,请参阅如何确保幂等性。

details

来自 Jobs 服务的其它信息。

protocol

用于提出请求的协议。有效值为 MQTT 或 HTTP。

topicName

发出请求所使用的主题。

UpdateJobExecution 日志条目

这个 Amazon IoT 作业服务生成一个带有 eventType 的 UpdateJobExecution 当服务收到更新任务执行的请求时。

UpdateJobExecution 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,UpdateJobExecution 日志条目包含以下属性:

clientId

发出请求的客户端的 ID。

clientToken

用于确保请求幂等性的唯一、区分大小写的标识符。有关更多信息,请参阅如何确保幂等性。

details

来自 Jobs 服务的其它信息。

jobId

任务执行的任务 ID。

protocol

用于提出请求的协议。有效值为 MQTT 或 HTTP。

topicName

发出请求所使用的主题。

versionNumber

任务执行的版本。

设备预调配日志条目

这个 Amazon IoT 设备配置服务为以下事件生成日志。

GetDeviceCredentials 日志条目

这个 Amazon IoT 设备配置服务生成带有以下内容的日志条目 eventType 的 GetDeviceCredential 当客户打电话时 GetDeviceCredential。

GetDeviceCredentials 日志条目示例

{ "timestamp" : "2019-02-20 20:31:22.932", "logLevel" : "INFO", "traceId" : "8d9c016f-6cc7-441e-8909-7ee3d5563405", "accountId" : "123456789101", "status" : "Success", "eventType" : "GetDeviceCredentials", "deviceCertificateId" : "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "details" : "Additional details about this log." }

除了 常见 CloudWatch 日志属性 ,GetDeviceCredentials 日志条目包含以下属性:

details

错误的简要说明。

设备CertificateId

设备证书的 ID。

ProvisionDevice 日志条目

这个 Amazon IoT 设备配置服务生成带有以下内容的日志条目 eventType 的 ProvisionDevice 当客户打电话时 ProvisionDevice。

ProvisionDevice 日志条目示例

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

除了 常见 CloudWatch 日志属性 ,ProvisionDevice 日志条目包含以下属性:

details

错误的简要说明。

设备CertificateId

设备证书的 ID。

配置TemplateName

预配置模板的名称。

动态事物组日志条目

Amazon IoT 动态事物组为以下事件生成日志。

AddThingToDynamicThingGroupsFailed 日志条目

什么时候 Amazon IoT 无法向指定的动态组中添加内容,它会生成一个带有 eventType 的 AddThingToDynamicThingGroupsFailed。当事物满足要处于动态事物组中的条件时,就会发生此情况;但是,无法将其添加到动态组中,或者无法将其从动态组中删除。这可能是因为:

  • 事物已经属于最大数量的组数。

  • --override-dynamic-groups 选项用于将事物添加到静态事物组中。它已被从一个动态事物组中删除,以便可以再添加。

有关更多信息,请参阅动态事物组限制和冲突。

AddThingToDynamicThingGroupsFailed 日志条目示例

此示例显示 AddThingToDynamicThingGroupsFailed 错误的日志条目。在这个例子中, TestThing 符合加入中列出的动态事物组的标准 dynamicThingGroupNames,但无法添加到这些动态组中,如中所述 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." }

除了 常见 CloudWatch 日志属性 , AddThingToDynamicThingGroupsFailed 日志条目包含以下属性:

动态ThingGroupNames

无法向其中添加该事物的动态事物组的数组。

reason

事物无法添加到动态事物组的原因。

thingName

无法添加到动态事物组的事物的名称。

实例集索引日志条目

Amazon IoT 舰队索引为以下事件生成日志条目。

NamedShadowCountForDynamicGroupQueryLimitExceeded 日志条目

对于动态组中不特定于数据来源的查询术语,每个对象最多处理 25 个命名影子。由于事件而违反该限制时,将发出 NamedShadowCountForDynamicGroupQueryLimitExceeded 事件类型。

NamedShadowCountForDynamicGroupQueryLimitExceeded 日志条目示例

此示例显示 NamedShadowCountForDynamicGroupQueryLimitExceeded 错误的日志条目。在此示例中,所有基于值的 DynamicGroup 结果都可能不准确,如 reason 字段中所述。

{ "timestamp": "2020-03-16 22:24:43.804", "logLevel": "ERROR", "traceId": "70b1f2f5-d95e-f897-9dcc-31e68c3e1a30", "accountId": "571032923833", "status": "Failure", "eventType": "NamedShadowCountForDynamicGroupQueryLimitExceeded", "thingName": "TestThing", "reason": "A maximum of 25 named shadows per thing are processed for non-data source specific query terms in dynamic groups." }

常见 CloudWatch 日志属性

全部 CloudWatch 日志日志条目包括以下属性:

accountId

你的 Amazon Web Services 账户 ID。

eventType

已为其生成日志的事件类型。事件类型的值取决于生成日志条目的事件。每个日志条目描述都包括该日志条目的 eventType 的值。

logLevel

所使用的日志级别。有关更多信息,请参阅 日志级别。

status

请求的状态。

timestamp

客户端连接到 Amazon IoT 消息代理的时间的便于阅读的 UNIX 时间戳。

traceId

一个随机生成的标识符,可用于将特定请求的所有日志关联起来。