無線閘道和無線裝置資源的記錄項目

在啟用了記錄之後，您可以檢視無線閘道和無線裝置的記錄項目。下節根據您的資源和事件類型描述各種記錄項目。

無線閘道記錄項目

本節顯示無線閘道資源的一些範例記錄項目，您將在 CloudWatch 主控台中看到它們。這些記錄訊息可以具有事件類型 CUPS_Request 或 Certificate，並且可以設定為在資源層級或事件層級顯示日誌層級 INFO、ERROR 或 DISABLED。如果您只想要看到錯誤資訊，請將日誌層級設定為 ERROR。ERROR 記錄項目中的訊息將包含其為何失敗的相關資訊。

無線閘道資源的記錄項目可以根據下列事件類型進行分類：

CUPS_Request

在閘道上執行的 LoRa Basics Station 會定期將請求傳送至組態與更新伺服器 (CUPS) 進行更新。對於此事件類型，如果您在為無線閘道資源設定 CLI 時將日誌層級設定為 INFO，則在記錄中：
- 如果事件成功，您就會看到 logLevel 為 INFO 的記錄訊息。這些訊息將包含有關傳送至閘道之 CUPS 回應的詳細資訊以及閘道詳細資訊。下列顯示此記錄項目的範例。如需記錄項目中 logLevel 和其他欄位的詳細資訊，請參閱 AWS IoT Wireless 資源和日誌層級。
```
{
    "timestamp": "2021-05-13T16:56:08.853Z",
    "resource": "WirelessGateway",
    "wirelessGatewayId": "5da85cc8-3361-4c79-8be3-3360fb87abda",
    "wirelessGatewayType": "LoRaWAN",
    "gatewayEui": "feffff00000000e2",
    "event": "CUPS_Request",
    "logLevel": "INFO",
    "message": "Sending CUPS response of total length 3213 to GatewayEui: feffff00000000e2 with  TC Credentials,"
}
```
- 如果發生錯誤，您會看到 logLevel 為 ERROR 的記錄項目，而且訊息將包含錯誤的詳細資訊。CUPS_Request 事件何時可能發生錯誤的範例包括：缺少 CUPS CRC、閘道的 TC Uri 與 AWS IoT Core for LoRaWAN 不符、缺少 IoTWirelessGatewayCertManagerRole，或無法取得無線閘道記錄。下列範例顯示缺少 CRC 記錄項目。若要解決此錯誤，請檢查您的閘道設定，以驗證您是否已輸入正確的 CUPS CRC。
```
{
    "timestamp": "2021-05-13T16:56:08.853Z",
    "resource": "WirelessGateway",
    "wirelessGatewayId": "5da85cc8-3361-4c79-8be3-3360fb87abda",
    "wirelessGatewayType": "LoRaWAN",
    "gatewayEui": "feffff00000000e2",
    "event": "CUPS_Request",
    "logLevel": "ERROR",
    "message": "The CUPS CRC is missing from the request. Check your gateway setup and enter the CUPS CRC,"
}
```
憑證

這些記錄項目將協助您檢查無線閘道是否呈現正確的憑證，以驗證與 AWS IoT 的連線。對於此事件類型，如果您在為無線閘道資源設定 CLI 時將日誌層級設定為 INFO，則在記錄中：
- 如果事件成功，您就會看到 logLevel 為 INFO 的記錄訊息。這些訊息將包含憑證 ID 和無線閘道識別符的詳細資訊。下列顯示此記錄項目的範例。如需記錄項目中 logLevel 和其他欄位的詳細資訊，請參閱 AWS IoT Wireless 資源和日誌層級。
```
{
    "resource": "WirelessGateway",
    "wirelessGatewayId": "5da85cc8-3361-4c79-8be3-3360fb87abda",
    "wirelessGatewayType": "LoRaWAN",
    "event": "Certificate",
    "logLevel": "INFO",
    "message": "Gateway connection authenticated. 
    (CertificateId: b5942a7aee973eda24314e416889227a5e0aa5ed87e6eb89239a83f515dea17c, WirelessGatewayId: 5da85cc8-3361-4c79-8be3-3360fb87abda)"
}
```
- 如果發生錯誤，您會看到 logLevel 為 ERROR 的記錄項目，而且訊息將包含錯誤的詳細資訊。Certificate 事件何時可能發生錯誤的範例包含無效的憑證 ID、無線閘道識別符，或無線閘道識別符與憑證 ID 之間不相符。下列範例顯示 ERROR，因為無線閘道識別符無效。若要解決此錯誤，請檢查閘道識別符。
```
{
    "resource": "WirelessGateway",
    "wirelessGatewayId": "5da85cc8-3361-4c79-8be3-3360fb87abda",
    "wirelessGatewayType": "LoRaWAN",
    "event": "Certificate",
    "logLevel": "INFO",
    "message": "The gateway connection couldn't be authenticated because a provisioned gateway associated with the certificate couldn't be found. 
    (CertificateId: 729828e264810f6fc7134daf68056e8fd848afc32bfe8082beeb44116d709d9e)"
}
```

無線裝置記錄項目

本節顯示無線裝置資源的一些範例記錄項目，您將在 CloudWatch 主控台中看到它們。這些記錄訊息的事件類型取決於您使用的是 LoRaWAN 還是 Sidewalk 裝置。每個無線裝置資源或事件類型都可設定為顯示日誌層級 INFO、ERROR 或 DISABLED。

注意

您的請求不得同時包含 LoRaWAN 和 Sidewalk 無線中繼資料。若要避免此案例的 ERROR 記錄項目，請指定 LoRaWAN 或 Sidewalk 無線資料。

LoRaWAN 裝置記錄項目

LoRaWAN 無線裝置的記錄項目可以根據下列事件類型進行分類：

Join 與 Rejoin

當您新增 LoRaWAN 裝置並將其連接到 AWS IoT Core for LoRaWAN，然後您的裝置才能傳送上行資料時，您必須先完成稱為 activation 或 join procedure 的程序。如需詳細資訊，請參閱將您的無線裝置新增至 AWS IoT Core for LoRaWAN。

對於此事件類型，如果您在為無線閘道資源設定 CLI 時將日誌層級設定為 INFO，則在記錄中：
- 如果事件成功，您就會看到 logLevel 為 INFO 的記錄訊息。這些訊息將包含有關聯結或重新聯結請求之狀態的詳細資訊。下列顯示此記錄項目的範例。如需記錄項目中 logLevel 和其他欄位的詳細資訊，請參閱 AWS IoT Wireless 資源和日誌層級。
```
{
    "timestamp": "2021-05-13T16:56:08.853Z",
    "resource": "WirelessDevice",
    "wirelessDeviceType": "LoRaWAN",
    "WirelessDeviceId": "5da85cc8-3361-4c79-8be3-3360fb87abda",    
    "devEui": "feffff00000000e2",
    "event": "Rejoin",
    "logLevel": "INFO",
    "message": "Rejoin succeeded"
}
```
- 如果發生錯誤，您會看到 logLevel 為 ERROR 的記錄項目，而且訊息將包含錯誤的詳細資訊。Join 和 Rejoin 事件何時可能發生錯誤的範例包括無效的 LoRaWAN 區域設定，或無效的訊息完整性代碼 (MIC) 檢查。下列範例顯示由於 MIC 檢查而產生的聯結錯誤。若要解決此錯誤，請檢查您是否已輸入正確的根金鑰。
```
{
    "timestamp": "2020-11-24T01:46:50.883481989Z",
    "resource": "WirelessDevice",
    "wirelessDeviceType": "LoRaWAN",
    "WirelessDeviceId": "cb4c087c-1be5-4990-8654-ccf543ee9fff",
    "devEui": "58a0cb000020255c",
    "event": "Join",
    "logLevel": "ERROR",
    "message": "invalid MIC. It's most likely caused by wrong root keys."
}
```
Uplink_Data 與 Downlink_Data

事件類型 Uplink_Data 用於 LoRaWAN 或 Sidewalk 裝置向 AWS IoT 傳送承載時由 AWS IoT Wireless 產生的訊息。事件類型 Downlink_Data 用於與從 AWS IoT 傳送至無線裝置之下行訊息相關的訊息。

對於此事件類型，如果您在為無線裝置設定 CLI 時將日誌層級設定為 INFO，則在記錄中，您將看到：
- 如果事件成功，您就會看到 logLevel 為 INFO 的記錄訊息。這些訊息將包含所傳送之上行或下行訊息狀態的詳細資訊，以及無線裝置識別符。下列顯示 Sidewalk 裝置的此記錄項目的範例。如需記錄項目中 logLevel 和其他欄位的詳細資訊，請參閱 AWS IoT Wireless 資源和日誌層級。
```
{
    "resource": "WirelessDevice",
    "wirelessDeviceId": "5371db88-d63d-481a-868a-e54b6431845d",
    "wirelessDeviceType": "Sidewalk",
    "event": "Downlink_Data",
    "logLevel": "INFO",
    "messageId": "8da04fa8-037d-4ae9-bf67-35c4bb33da71",
    "message": "Message delivery succeeded.  MessageId: 8da04fa8-037d-4ae9-bf67-35c4bb33da71. AWS IoT Core: {\"message\":\"OK\",\"traceId\":\"038b5b05-a340-d18a-150d-d5a578233b09\"}"
}
```
- 如果發生錯誤，您會看到 logLevel 為 ERROR 的記錄項目，而且訊息將包含錯誤的詳細資訊，這將協助您解決此錯誤。Registration 事件何時可能發生錯誤的範例包括：身分驗證問題、無效或太多請求、無法加密或解密承載，或無法使用指定的 ID 找到無線裝置。下列範例顯示在處理訊息時遇到的許可錯誤。
```
{
    "resource": "WirelessDevice",
    "wirelessDeviceId": "cb4c087c-1be5-4990-8654-ccf543ee9fff",
    "wirelessDeviceType": "LoRaWAN",
    "event": "Uplink_Data",
    "logLevel": "ERROR",
    "message": "Cannot assume role MessageId: ef38877f-3454-4c99-96ed-5088c1cd8dee. 
    Access denied: User: arn:aws:sts::005196538709:assumed-role/DataRoutingServiceRole/6368b35fd48c445c9a14781b5d5890ed is not authorized to perform: sts:AssumeRole on resource: arn:aws:iam::400232685877:role/ExecuteRules_Role\tstatus code: 403, request id: 471c3e35-f8f3-4e94-b734-c862f63f4edb"
}
```

Sidewalk 裝置記錄項目

Sidewalk 裝置的記錄項目可以根據下列事件類型進行分類：

Registration

這些日誌項目會協助您監控正要向 AWS IoT Wireless 註冊之任何 Sidewalk 裝置的狀態。對於此事件類型，如果您在為無線裝置資源設定 CLI 時將日誌層級設定為 INFO，則在記錄中，您將看到 logLevel 為 INFO 和 ERROR 的記錄訊息。這些訊息將包含註冊進度 (從開始到完成) 的詳細資訊。ERROR 記錄訊息將包含如何疑難排解裝置註冊問題的相關資訊。

下列顯示日誌層級為 INFO 的記錄訊息範例。如需記錄項目中 logLevel 和其他欄位的詳細資訊，請參閱 AWS IoT Wireless 資源和日誌層級。
```
{
    "resource": "WirelessDevice",
    "wirelessDeviceId": "8d0b2775-e19b-4b2a-a351-cb8a2734a504",
    "wirelessDeviceType": "Sidewalk",
    "event": "Registration",
    "logLevel": "INFO",
    "message": "Successfully completed device registration. Amazon SidewalkId = 2000000002"
}
```
Uplink_Data 與 Downlink_Data

Sidewalk 裝置的事件類型 Uplink_Data 和 Downlink_Data 類似於 LoRaWAN 裝置的對應事件類型。如需詳細資訊，請參閱先前針對 LoRaWAN 裝置記錄項目所述的 Uplink_Data 與 Downlink_Data 一節。

後續步驟

您已了解如何檢視資源的日誌項目，以及您在啟用 AWS IoT Wireless 的記錄之後可在 CloudWatch 主控台中檢視的不同日誌項目。儘管您可以使用 Log groups (記錄群組) 來建立篩選串流，但我們建議您使用 CloudWatch Insights 來建立和使用篩選串流。如需詳細資訊，請參閱使用 CloudWatch Insights 來篩選 AWS IoT Wireless 的記錄。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

檢視日誌項目

使用 CloudWatch Insights 篩選日誌