ワイヤレスゲートウェイとワイヤレスデバイスのリソースのログエントリ
ログ記録を有効にすると、ワイヤレスゲートウェイとワイヤレスデバイスのログエントリを表示できます。次のセクションでは、リソースタイプとイベントタイプに基づくさまざまな種類のログエントリについて説明します。
ワイヤレスゲートウェイのログエントリ
このセクションでは、CloudWatch コンソールCUPS_Request または Certificate を含めることができ、ログレベル INFO、ERROR、または DISABLED をリソースレベルまたはイベントレベルで表示するように構成できます。エラー情報のみを表示する場合は、ログレベルを ERROR に設定します。ERROR ログエントリ内のメッセージには、失敗した理由に関する情報が含まれます。
ワイヤレスゲートウェイリソースのログエントリは、次のイベントタイプに基づいて分類できます。
-
CUPS_Request
ゲートウェイで実行されている LoRa Basics Station は、定期的に更新のためのリクエストを Configuration and Update Server (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 とワイヤレスゲートウェイ 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 が無効であること、またはワイヤレスゲートウェイ ID と証明書 IDの不一致などがあります。次の例は、無効なワイヤレスゲートウェイ ID が原因のERRORを示しています。エラーを解決するには、ゲートウェイ ID を確認します。{ "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 コンソールINFO、ERROR、またはDISABLED のログレベルを表示するように構成できます。
注記
リクエストに、LoRaWAN と Sidewalk の両方のワイヤレスメタデータを同時に含めてはなりません。このシナリオで ERROR ログエントリを回避するには、LoRaWAN または Sidewalk のいずれかのワイヤレスデータを指定してください。
LoRaWAN デバイスログエントリ
LoRaWAN ワイヤレスデバイスのログエントリは、次のイベントタイプに基づいて分類できます。
-
JoinおよびRejoinLoRaWAN デバイスを追加して 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 リージョン設定、または無効な Message Integrity Code (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であるログメッセージが表示されます。メッセージには、送信されたアップリンクメッセージまたはダウンリンクメッセージのステータスに関する詳細と、ワイヤレスデバイス ID が含まれます。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
イベントタイプ
Uplink_DataおよびDownlink_Dataは、LoRaWAN デバイスの対応するイベントタイプと同様です。詳細については、LoRaWAN デバイスのログエントリに関して前述された「Uplink_Data および Downlink_Data」セクションを参照してください。
次のステップ
AWS IoT Wireless へのログ記録を有効にした後に CloudWatch コンソールでリソースのログエントリを表示する方法と、表示できるさまざまなログエントリについて学習しました。ロググループを使用してフィルターストリームを作成することができますが、CloudWatch Insights を使用して、フィルターストリームを作成および使用することをお勧めします。詳細については、「CloudWatch Insights を使用して AWS IoT Wireless のログをフィルタリングする」を参照してください。
