本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
CloudWatch 記 AWS IoT 錄檔項目
的每個元件都 AWS IoT 會產生自己的記錄項目。每個日誌項目都有 eventType
指定造成日誌項目產生的作業。本節旨在說明下列 AWS IoT
元件所產生的記錄項目。
主題
Message broker 日誌項目
AWS IoT 訊息代理程式會產生下列事件的記錄項目:
主題
Connect 記錄項目
當 MQTT 用戶端連線Connect
時, AWS IoT 訊息代理程式會產生一個記錄項目。eventType
Connect 日誌項目範例
{ "timestamp": "2017-08-10 15:37:23.476", "logLevel": "INFO", "traceId": "20b23f3f-d7f1-feae-169f-82263394fbdb", "accountId": "123456789012", "status": "Success", "eventType": "Connect", "protocol": "MQTT", "clientId": "abf27092886e49a8a5c1922749736453", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "205.251.233.181", "sourcePort": 13490 }
除了 一般 CloudWatch 記錄檔屬性,Connect
記錄項目包含下列屬性:
- clientId
-
提出請求的用戶端 ID。
- principalId
-
提出請求的委託人 ID。
- protocol
-
用來提出要求的協定。有效值為
MQTT
或HTTP
。 - sourceIp
-
請求來源所在的 IP 地址。
- sourcePort
-
請求來源所在的埠口。
Publish-In 日誌項目
當 MQTT 用戶端中斷連線Disconnect
時, AWS IoT 訊息代理程式會產生一個記錄項目。eventType
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
-
用戶端中斷連線的原因。
- 詳細資訊
-
錯誤的簡要說明。
- disconnectReason
-
用戶端中斷連線的原因。
GetRetainedMessage 記錄項目
AWS IoT 訊息代理程式會產生一個記錄項目,其中包含呼GetRetainedMessage
叫eventType
的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 日期和時間 (以毫秒為單位)。 AWS IoT
- protocol
-
用來提出要求的協定。有效值:
HTTP
。 - qos
-
發佈請求中使用的服務品質 (QoS) 等級。有效值為
0
或1
。 - topicName
-
訂閱主題的名稱。
ListRetainedMessage 記錄項目
AWS IoT 訊息代理程式會產生一個記錄項目,其中包含呼ListRetainedMessages
叫eventType
的ListRetainedMessage
時間。
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
。
Publish-In 日誌項目
當 AWS IoT 訊息代理程式收到 MQTT 訊息時,會產生含有的記錄項目。eventType
Publish-In
Publish-In 日誌項目範例
{ "timestamp": "2017-08-10 15:39:30.961", "logLevel": "INFO", "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699", "accountId": "123456789012", "status": "Success", "eventType": "Publish-In", "protocol": "MQTT", "topicName": "$aws/things/MyThing/shadow/get", "clientId": "abf27092886e49a8a5c1922749736453", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "205.251.233.181", "sourcePort": 13490, "retain": "True" }
除了 一般 CloudWatch 記錄檔屬性,Publish-In
記錄項目包含下列屬性:
- clientId
-
提出請求的用戶端 ID。
- principalId
-
提出請求的委託人 ID。
- protocol
-
用來提出要求的協定。有效值為
MQTT
或HTTP
。 - 保留
-
當「保留」旗標訊息的值設定為
True
時所使用的屬性。如果訊息沒有設定「保留」旗標,則此屬性不會顯示在日誌條目中。如需詳細資訊,請參閱 MQTT 保留訊息。 - sourceIp
-
請求來源所在的 IP 地址。
- sourcePort
-
請求來源所在的埠口。
- topicName
-
訂閱主題的名稱。
Publish-Out 日誌項目
當訊息代理程式發佈 MQTT 訊息時,會產生 eventType
為 Publish-Out
的日誌項目。
Publish-Out 日誌項目範例
{ "timestamp": "2017-08-10 15:39:30.961", "logLevel": "INFO", "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699", "accountId": "123456789012", "status": "Success", "eventType": "Publish-Out", "protocol": "MQTT", "topicName": "$aws/things/MyThing/shadow/get", "clientId": "abf27092886e49a8a5c1922749736453", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "205.251.233.181", "sourcePort": 13490 }
除了 一般 CloudWatch 記錄檔屬性,Publish-Out
記錄項目包含下列屬性:
- clientId
-
接收有關該 MQTT 主題之訊息的訂閱用戶端的 ID。
- principalId
-
提出請求的委託人 ID。
- protocol
-
用來提出要求的協定。有效值為
MQTT
或HTTP
。 - sourceIp
-
請求來源所在的 IP 地址。
- sourcePort
-
請求來源所在的埠口。
- topicName
-
訂閱主題的名稱。
佇列日誌項目
當具有持續工作階段的裝置中斷連線時,MQTT 訊息代理程式會儲存裝置的訊息,並 AWS IoT 產生具有 EeventType 的記錄項目。Queued
如需 MQTT 持久性工作階段的相關資訊,請參閱 MQTT 持久性工作階段。
佇列的伺服器錯誤日誌項目範例
{ "timestamp": "2022-08-10 15:39:30.961", "logLevel": "ERROR", "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699", "accountId": "123456789012", "topicName": "$aws/things/MyThing/get", "clientId": "123123123", "qos": "1", "protocol": "MQTT", "eventType": "Queued", "status": "Failure", "details": "Server Error" }
除了 一般 CloudWatch 記錄檔屬性,Queued
伺服器錯誤日誌項目包含下列屬性:
- clientId
-
訊息排入佇列的用戶端 ID。
- 詳細資訊
-
Server Error
伺服器錯誤會造成訊息無法儲存。
- protocol
-
用來提出要求的協定。這個值將永遠為
MQTT
。 - qos
-
請求的服務品質 (QoS) 等級。該值將始終為 1,因為具有 QoS 為 0 的訊息不會儲存。
- topicName
-
訂閱主題的名稱。
佇列成功日誌項目範例
{ "timestamp": "2022-08-10 15:39:30.961", "logLevel": "INFO", "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699", "accountId": "123456789012", "topicName": "$aws/things/MyThing/get", "clientId": "123123123", "qos": "1", "protocol": "MQTT", "eventType": "Queued", "status": "Success" }
除了 一般 CloudWatch 記錄檔屬性,Queued
成功日誌項目包含下列屬性:
- clientId
-
訊息排入佇列的用戶端 ID。
- protocol
-
用來提出要求的協定。這個值將永遠為
MQTT
。 - qos
-
請求的服務品質 (QoS) 等級。該值將始終為 1,因為具有 QoS 為 0 的訊息不會儲存。
- topicName
-
訂閱主題的名稱。
佇列限流日誌項目範例
{ "timestamp": "2022-08-10 15:39:30.961", "logLevel": "ERROR", "traceId": "672ec480-31ce-fd8b-b5fb-22e3ac420699", "accountId": "123456789012", "topicName": "$aws/things/MyThing/get", "clientId": "123123123", "qos": "1", "protocol": "MQTT", "eventType": "Queued", "status": "Failure", "details": "Throttled while queueing offline message" }
除了 一般 CloudWatch 記錄檔屬性,Queued
限流日誌項目包含下列屬性:
- clientId
-
訊息排入佇列的用戶端 ID。
- 詳細資訊
-
Throttled while queueing offline message
用戶端超出
Queued messages per second per account
限制,因此訊息不會儲存。 - protocol
-
用來提出要求的協定。這個值將永遠為
MQTT
。 - qos
-
請求的服務品質 (QoS) 等級。該值將始終為 1,因為具有 QoS 為 0 的訊息不會儲存。
- topicName
-
訂閱主題的名稱。
訂閱日誌項目
當 MQTT 用戶端訂閱某個eventType
主題Subscribe
時, AWS IoT 訊息代理程式會產生一個記錄項目,其中包含 in。
MQTT 3 訂閱日誌項目範例
{ "timestamp": "2017-08-10 15:39:04.413", "logLevel": "INFO", "traceId": "7aa5c38d-1b49-3753-15dc-513ce4ab9fa6", "accountId": "123456789012", "status": "Success", "eventType": "Subscribe", "protocol": "MQTT", "topicName": "$aws/things/MyThing/shadow/#", "clientId": "abf27092886e49a8a5c1922749736453", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "205.251.233.181", "sourcePort": 13490 }
除了 一般 CloudWatch 記錄檔屬性,Subscribe
記錄項目包含下列屬性:
- clientId
-
提出請求的用戶端 ID。
- principalId
-
提出請求的委託人 ID。
- protocol
-
用來提出要求的協定。有效值為
MQTT
或HTTP
。 - sourceIp
-
請求來源所在的 IP 地址。
- sourcePort
-
請求來源所在的埠口。
- topicName
-
訂閱主題的名稱。
MQTT 5 訂閱日誌項目範例
{ "timestamp": "2022-11-30 16:24:15.628", "logLevel": "INFO", "traceId": "7aa5c38d-1b49-3753-15dc-513ce4ab9fa6", "accountId": "123456789012", "status": "Success", "eventType": "Subscribe", "protocol": "MQTT", "topicName": "test/topic1,$invalid/reserved/topic", "subscriptions": [ { "topicName": "test/topic1", "reasonCode": 1 }, { "topicName": "$invalid/reserved/topic", "reasonCode": 143 } ], "clientId": "abf27092886e49a8a5c1922749736453", "principalId": "145179c40e2219e18a909d896a5340b74cf97a39641beec2fc3eeafc5a932167", "sourceIp": "205.251.233.181", "sourcePort": 13490 }
針對 MQTT 5 訂閱操作,除了 一般 CloudWatch 記錄檔屬性 和 MQTT 3 訂閱日誌項目屬性之外,MQTT 5 Subscribe
日誌項目還包含下列屬性:
- 訂閱
-
「訂閱」請求中所要求主題與個別 MQTT 5 原因代碼之間的對應清單。如需更多詳細資訊,請參閱 MQTT 原因代碼。
伺服器憑證 OCSP 記錄項目
AWS IoT Core 會產生下列事件的記錄項目:
擷取 OCSP StapleData 記錄項目
AWS IoT Core 當伺服器擷取 OCSP 裝訂資料RetrieveOCSPStapleData
時,會產生一個記錄項目,eventType
其中包含的。
擷取 OCSP StapleData 記錄項目範例
以下是的記錄項目範例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
-
網域組態的名稱。
- 連接詳情
-
連接詳細信息的簡要說明。
-
HTTP StatusCode
OCSP 回應程式針對用戶端對伺服器的要求而傳回的 HTTP 狀態碼。
-
OCSP ResponderUri
從伺服器憑證 AWS IoT Core 擷取的 OCSP 回應程式 URI。
-
sourceIp
伺服器的來源 IP 位 AWS IoT Core 址。
-
目標提示
OCSP 回應程式的目標 IP 位址。
-
- OCSP RequestDetails
-
OCSP 要求的詳細資料。
-
請求者名稱
傳送要求給 OCSP 回應程式之 AWS IoT Core 伺服器的識別碼。
-
請求 CertId
要求的憑證識別碼。這是要求 OCSP 回應的憑證識別碼。
-
- OCSP ResponseDetails
-
OCSP 回應的詳細資料。
-
回應 CertId
OCSP 回應的憑證識別碼。
-
OCSP ResponseStatus
OCSP 回應的狀態。
-
認證狀態
憑證的狀態。
-
signature
受信任實體套用至回應的簽章。
-
這 UpdateTime
正在指示的狀態已知正確的時間。
-
下一個 UpdateTime
提供有關憑證狀態之新資訊的時間或之前。
-
生產 AtTime
OCSP 回應程式簽署此回應的時間。
-
裝訂尺寸 DataPayload
裝訂資料的裝載大小。
-
Device Shadow 日誌項目
AWS IoT Device Shadow 服務會針對下列事件產生記錄項目:
DeleteThingShadow 記錄項目
當收到刪除 Device Shadow 的要求時,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 記錄項目
當收到影子的 get 要求時,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 的要求時,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
-
請求所發布的主題名稱。
Rules engine 日誌項目
AWS IoT 規則引擎會產生下列事件的記錄檔:
主題
FunctionExecution 記錄項目
當規則的 SQL 查詢呼叫外部函數時,規則引擎會產生 eventType
為 FunctionExecution
的日誌項目。當規則的動作向 AWS IoT 或另一個 Web 服務(例如,調用get_thing_shadow
或machinelearning_predict
)發出 HTTP 請求時,就會調用外部函數。
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。
- resources
-
該規則動作所使用的資源集合。
- ruleName
-
符合的規則名稱。
- topicName
-
訂閱主題的名稱。
RuleExecution 記錄項目
AWS 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" }
除了 一般 CloudWatch 記錄檔屬性,RuleExecution
記錄項目包含下列屬性:
- clientId
-
提出請求的用戶端 ID。
- principalId
-
提出請求的委託人 ID。
- resources
-
該規則動作所使用的資源集合。
- ruleAction
-
受到觸發的動作名稱。
- ruleName
-
符合的規則名稱。
- topicName
-
訂閱主題的名稱。
RuleMatch 記錄項目
當訊息代理程式收到符合 AWS IoT 規則eventType
的訊息RuleMatch
時,規則引擎會產生一個記錄項目,其中包含 in。
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
-
訂閱主題的名稱。
RuleExecutionThrottled 記錄項目
限制執行時, AWS 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": "RuleMessageThrottled", "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。
- 詳細資訊
-
錯誤的簡要說明。
- principalId
-
提出請求的委託人 ID。
- reason
-
字符串「RuleExecution節流」。
- ruleName
-
欲觸發的規則名稱。
- topicName
-
已發佈的主題名稱。
RuleNotFound 記錄項目
當 AWS 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。
- 詳細資訊
-
錯誤的簡要說明。
- principalId
-
提出請求的委託人 ID。
- reason
-
字符串「RuleNot找到」。
- ruleName
-
找不到的規則名稱。
- topicName
-
已發佈的主題名稱。
StartingRuleExecution 記錄項目
當 AWS 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
-
訂閱主題的名稱。
任務日誌項目
AWS IoT Job 服務會產生下列事件的記錄項目。從裝置收到 MQTT 或 HTTP 請求時系統會產生日誌項目。
主題
DescribeJobExecution 記錄項目
J AWS IoT obs 服務會在服務收到描述工作執行eventType
的要求DescribeJobExecution
時產生一個記錄項目,其中包含 a。
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
-
用來確保請求冪等的,是一個唯一、區分大小寫的識別符。如需詳細資訊,請參閱如何確保冪等。
- 詳細資訊
-
任務裝置的其他資訊。
- jobId
-
任務執行的任務 ID。
- protocol
-
用來提出要求的協定。有效值為
MQTT
或HTTP
。 - topicName
-
用來提出請求的主題。
GetPendingJobExecution 記錄項目
J AWS IoT obs 服務會在服務收到工作執行要求GetPendingJobExecution
時產生一個記錄項目,eventType
其中包含的。
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
-
用以確保請求冪等的,是一個唯一、區分大小寫的識別符。如需詳細資訊,請參閱如何確保冪等。
- 詳細資訊
-
任務裝置的其他資訊。
- protocol
-
用來提出要求的協定。有效值為
MQTT
或HTTP
。 - topicName
-
訂閱主題的名稱。
ReportFinalJobExecutionCount 記錄項目
J AWS IoT obs 服務會在工作完成ReportFinalJobExecutionCount
時產生一個記錄項目,entryType
其中包含的。
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
記錄項目包含下列屬性:
- 詳細資訊
-
任務裝置的其他資訊。
- jobId
-
任務執行的任務 ID。
StartNextPendingJobExecution 記錄項目
當它收到啟動下一個擱置中工作執行的要求時,J AWS IoT obs 服務會產生一個記錄項目,其中包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
-
用以確保請求冪等的,是一個唯一、區分大小寫的識別符。如需詳細資訊,請參閱如何確保冪等。
- 詳細資訊
-
任務裝置的其他資訊。
- protocol
-
用來提出要求的協定。有效值為
MQTT
或HTTP
。 - topicName
-
用來提出請求的主題。
UpdateJobExecution 記錄項目
J AWS IoT obs 服務會在服務收到更新工作執行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
-
用以確保請求冪等的,是一個唯一、區分大小寫的識別符。如需詳細資訊,請參閱如何確保冪等。
- 詳細資訊
-
任務裝置的其他資訊。
- jobId
-
任務執行的任務 ID。
- protocol
-
用來提出要求的協定。有效值為
MQTT
或HTTP
。 - topicName
-
用來提出請求的主題。
- versionNumber
-
任務執行的版本。
裝置佈建日誌項目
AWS IoT 裝置佈建服務會產生下列事件的記錄檔。
GetDeviceCredentials 記錄項目
AWS IoT 裝置佈建服務會在用戶端呼叫GetDeviceCredential
時產生一個記錄項目,eventType
其中包含 in GetDeviceCredential
。
GetDevice認證記錄項目範例
{ "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
記錄項目包含下列屬性:
- 詳細資訊
-
錯誤的簡要說明。
- 裝置 CertificateId
-
裝置憑證的 ID。
ProvisionDevice 記錄項目
AWS IoT 裝置佈建服務會在用戶端呼叫ProvisionDevice
時產生一個記錄項目,eventType
其中包含 in 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
記錄項目包含下列屬性:
- 詳細資訊
-
錯誤的簡要說明。
- 裝置 CertificateId
-
裝置憑證的 ID。
- 佈建 TemplateName
-
佈建範本的名稱。
動態物件群組日誌項目
AWS IoT 動態物件群組會針對下列事件產生記錄檔。
AddThingToDynamicThingGroupsFailed 記錄項目
AWS 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
記錄項目包含下列屬性:
- 動態ThingGroup名稱
-
無法新增物件的動態物件群組的陣列。
- reason
-
物件無法新增到動態物件群組的原因。
- thingName
-
無法新增至動態物件群組的物件名稱。
機群索引日誌項目
AWS 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
-
你的 AWS 帳戶 身份證
- eventType
-
產生日誌的事件類型。事件類型的值會根據產生該日誌項目的事件而定。每個日誌項目說明都包含該
eventType
日誌項目的值。 - logLevel
-
使用的日誌層級。如需詳細資訊,請參閱 日誌層級。
- status
-
請求的狀態。
- timestamp
-
用戶端連線至 AWS IoT 訊息代理程式時,人類看得懂的 UTC 時間戳記。
- traceId
-
隨機產生的識別符,可用於建立某個特定請求的所有日誌的關聯性。