# Protokolleinträge für WLAN-Gateways und WLAN-Geräteressourcen. Nachdem Sie die Protokollierung aktiviert haben, können Sie Protokolleinträge für Ihre WLAN-Gateways und WLAN-Geräte anzeigen. Im folgenden Abschnitt werden die verschiedenen Arten von Protokolleinträgen beschrieben, die auf Ihren Ressourcen- und Ereignistypen basieren. ## Protokolleinträge von WLAN-Gateway In diesem Abschnitt werden einige der Beispielprotokolleinträge für Ihre WLAN-Gateway-Ressourcen aufgeführt, die Sie in der [CloudWatch-Konsole](https://console.aws.amazon.com/cloudwatch) sehen werden. Diese Protokollnachrichten können den Ereignistyp `CUPS_Request` oder `Certificate` haben und so konfiguriert werden, dass eine Protokollebene von `INFO`, `ERROR`, oder `DISABLED` auf Ressourcen- oder Ereignisebene angezeigt wird. Wenn Sie nur Fehlerinformationen sehen möchten, stellen Sie die Protokollebene auf `ERROR`. Die Meldung im `ERROR`-Protokolleintrag enthält Informationen darüber, warum der Fehler aufgetreten ist. Die Protokolleinträge für Ihre WLAN-Gateway-Ressource können anhand der folgenden Ereignistypen klassifiziert werden: + **CUPS\$1Anfrage** Die LoRa Basics Station, die auf Ihrem Gateway läuft, sendet regelmäßig eine Anfrage für Updates an den Configuration and Update Server (CUPS). Wenn Sie für diesen Ereignistyp bei der Konfiguration der CLI für Ihre WLAN-Gateway-Ressource die Protokollebene auf `INFO` festgelegt haben, erscheint dann in den Protokollen: + Wenn das Ereignis erfolgreich ist, werden Ihnen Protokollmeldungen mit einem `logLevel` von `INFO` angezeigt. Die Nachrichten werden Details über die an Ihr Gateway gesendete CUPS-Antwort und die Gateway-Details enthalten. Das folgende Beispiel zeigt einen dieser Protokolleinträge. Weitere Informationen zu den Feldern `logLevel` und anderen im Protokolleintrag, finden Sie unter [AWS IoT Wireless-Ressourcen und Protokollebenen](configure-resource-logging.md#log-levels-resources). ``` { "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," } ``` + Wenn ein Fehler auftritt, werden Ihnen Logeinträge mit einem `logLevel` von `ERROR` angezeigt, und die Meldungen enthalten Details über den Fehler. Zu den möglichen Fehlern im Zusammenhang mit dem `CUPS_Request`-Ereignis gehören: fehlender CUPS CRC, Nichtübereinstimmung der TC-URI des Gateways mit dem drahtlosen Gateway-Datensatz AWS IoT Core für LoRaWAN, fehlender `IoTWirelessGatewayCertManagerRole` oder fehlender Zugriff auf den Datensatz für das WLAN-Gateway. Das folgende Beispiel zeigt einen CRC-Protokolleintrag. Um den Fehler zu beheben, überprüfen Sie Ihr Gateway-Setup, um sicherzustellen, dass Sie den richtigen CUPS CRC eingegeben haben. ``` { "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," } ``` + **Zertifikat** Anhand dieser Protokolleinträge können Sie überprüfen, ob Ihr WLAN-Gateway das richtige Zertifikat für die Authentifizierung der Verbindung mit AWS IoT vorgelegt hat. Wenn Sie für diesen Ereignistyp bei der Konfiguration der CLI für Ihre WLAN-Gateway-Ressource die Protokollebene auf `INFO` festgelegt haben, erscheint in den Protokollen: + Wenn das Ereignis erfolgreich ist, werden Ihnen Protokollmeldungen mit einem `logLevel` von `INFO` angezeigt. Die Nachrichten werden Details zur Zertifikat-ID und zur WLAN-Gateway-ID enthalten. Das folgende Beispiel zeigt einen dieser Protokolleinträge. Weitere Informationen zu den Feldern `logLevel` und anderen im Protokolleintrag, finden Sie unter [AWS IoT Wireless-Ressourcen und Protokollebenen](configure-resource-logging.md#log-levels-resources). ``` { "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)" } ``` + Wenn ein Fehler auftritt, werden Ihnen Logeinträge mit einem `logLevel` von `ERROR` angezeigt, und die Meldungen enthalten Details über den Fehler. Zu den möglichen Fehlern im Zusammenhang mit dem `Certificate`-Ereignis gehören beispielsweise eine ungültige Zertifikat-ID, eine WLAN-Gateway-ID oder eine Nichtübereinstimmung zwischen der WLAN-Gateway-ID und der Zertifikat-ID. Das folgende Beispiel zeigt `ERROR`, aufgrund ungültiger WLAN-Gateway-ID. Überprüfen Sie die Gateway-IDs, um den Fehler zu beheben. ``` { "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)" } ``` ## Protokolleinträge von WLAN-Geräten In diesem Abschnitt werden einige der Beispielprotokolleinträge für Ihre WLAN-Geräte-Ressourcen aufgeführt, die Sie in der [CloudWatch-Konsole](https://console.aws.amazon.com/cloudwatch) sehen werden. Der Ereignistyp für diese Protokollnachrichten hängt davon ab, ob Sie ein LoRaWAN- oder ein Sidewalk-Gerät verwenden. Jede Ressource oder jeder Ereignistyp eines WLAN-Geräts kann so konfiguriert werden, dass eine Protokollebene von`INFO`, `ERROR` oder `DISABLED` angezeigt wird. **Anmerkung** Ihre Anfrage darf nicht gleichzeitig LoRaWAN- und Sidewalk-WLAN-Metadaten enthalten. Um einen `ERROR`-Protokolleintrag für dieses Szenario zu vermeiden, geben Sie entweder LoRaWAN- oder Sidewalk-WLAN-Daten an. ### LoRaWAN-Geräteprotokolleinträge von LoRaWAN Die Protokolleinträge für Ihre LoRaWAN-WLAN-Geräte können anhand der folgenden Ereignistypen klassifiziert werden: + **`Join` und `Rejoin`** Wenn Sie ein LoRaWAN-Gerät hinzufügen und eine Verbindung mit AWS IoT Core für LoRaWAN herstellen, müssen Sie einen Vorgang namens `activation` oder `join procedure` abschließen, bevor Ihr Gerät Uplink-Daten senden kann. Weitere Informationen finden Sie unter [Hinzufügen Ihres drahtlosen Geräts zu AWS IoT Core für LoRaWAN](lorawan-end-devices-add.md). Wenn Sie für diesen Ereignistyp bei der Konfiguration der CLI für Ihre WLAN-Gateway-Ressource die Protokollebene auf `INFO` festgelegt haben, erscheint in den Protokollen: + Wenn das Ereignis erfolgreich ist, werden Ihnen Protokollmeldungen mit einem `logLevel` von `INFO` angezeigt. Die Nachrichten werden Details zum Status Ihrer Anfrage für den Beitritt oder den erneuten Beitritt enthalten. Das folgende Beispiel zeigt einen dieser Protokolleinträge. Weitere Informationen zu den Feldern `logLevel` und anderen im Protokolleintrag, finden Sie unter [AWS IoT Wireless-Ressourcen und Protokollebenen](configure-resource-logging.md#log-levels-resources). ``` { "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" } ``` + Wenn ein Fehler auftritt, werden Ihnen Logeinträge mit einem `logLevel` von `ERROR` angezeigt, und die Meldungen enthalten Details über den Fehler. Beispiele dafür, wann bei den Ereignissen `Join` und `Rejoin` ein Fehler auftreten kann, sind eine ungültige LoRaWAN-Regionseinstellung oder eine ungültige MIC-Prüfung (Message Integrity Code). Das folgende Beispiel zeigt einen Verbindungsfehler aufgrund einer MIC-Prüfung. Um den Fehler zu beheben, überprüfen Sie, ob Sie die richtigen Root-Keys eingegeben haben. ``` { "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\$1Data und Downlink\$1Data** Der Ereignistyp `Uplink_Data` wird für Nachrichten verwendet, die von AWS IoT Wireless generiert werden, wenn die Nutzlast von Ihrem LoRaWAN- oder Sidewalk-Gerät an AWS IoT gesendet wird. Der Ereignistyp `Downlink_Data` wird für Nachrichten verwendet, die sich auf Downlink-Nachrichten beziehen, die von AWS IoT an das WLAN-Gerät gesendet werden. Wenn Sie für diesen Ereignistyp bei der Konfiguration der CLI für Ihre WLAN-Geräte die Protokollebene auf `INFO` festgelegt haben, erscheint in den Protokollen: + Wenn das Ereignis erfolgreich ist, werden Ihnen Protokollmeldungen mit einem `logLevel` von `INFO` angezeigt. Die Nachrichten enthalten Details zum Status der gesendeten Uplink- oder Downlink-Nachricht sowie zur Kennung des WLAN-Geräts. Das folgende Beispiel zeigt einen dieser Protokolleinträge. Weitere Informationen zu diesen und anderen Einträgen in `logLevel` finden Sie unter [AWS IoT Wireless-Ressourcen und Protokollebenen](configure-resource-logging.md#log-levels-resources). ``` { "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\"}" } ``` + Wenn ein Fehler auftritt, werden Ihnen Logeinträge mit einem `logLevel`von `ERROR` angezeigt, und die Meldungen enthalten Details über den Fehler, was Ihnen bei der Lösung helfen wird. Zu den möglichen Fehlern im Zusammenhang mit dem `Registration`-Ereignis gehören: Authentifizierungsprobleme, ungültige oder zu viele Anfragen, die Payload konnte nicht ver- oder entschlüsselt werden oder das WLAN-Gerät konnte mit der angegebenen ID nicht gefunden werden. Das folgende Beispiel zeigt einen Berechtigungsfehler, der bei der Verarbeitung einer Nachricht aufgetreten ist. ``` { "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" } ``` ### Protokolleinträge von Sidewalk-Geräten Die Protokolleinträge für Ihre Sidewalk-Geräte können anhand der folgenden Ereignistypen klassifiziert werden: + **`Registration`** Diese Protokolleinträge helfen Ihnen dabei, den Status aller Sidewalk-Geräte zu überwachen, bei denen Sie sich mit AWS IoT Wireless registrieren. Wenn Sie für diesen Ereignistyp bei der Konfiguration der CLI für Ihre WLAN-Geräte-Ressourcen die Protokollebene auf `INFO` festgelegt haben, erscheinen Protokollnachrichten mit einem `logLevel` von `INFO` und `ERROR`. Die Meldungen enthalten Informationen über den Fortschritt der Registrierung von Anfang bis Ende. `ERROR` Protokollnachrichten enthalten Informationen zum Beheben von Problemen bei der Registrierung Ihres Geräts. Im Folgenden finden Sie ein Beispiel für eine Protokollnachricht mit der Protokollebene von `INFO`. Weitere Informationen zu den Feldern `logLevel` und anderen im Protokolleintrag, finden Sie unter [AWS IoT Wireless-Ressourcen und Protokollebenen](configure-resource-logging.md#log-levels-resources). ``` { "resource": "WirelessDevice", "wirelessDeviceId": "8d0b2775-e19b-4b2a-a351-cb8a2734a504", "wirelessDeviceType": "Sidewalk", "event": "Registration", "logLevel": "INFO", "message": "Successfully completed device registration. Amazon SidewalkId = 2000000002" } ``` + **Uplink\$1Data und Downlink\$1Data** Die Ereignistypen `Uplink_Data` und `Downlink_Data` für Sidewalk-Geräte ähneln den entsprechenden Ereignistypen für LoRaWAN-Geräte. Weitere Informationen finden Sie in den zuvor beschriebenen Abschnitten **Uplink\$1Data und Downlink\$1Data** für LoRaWAN-Geräteprotokolleinträge. ### Nächste Schritte Sie haben gelernt, wie Sie Protokolleinträge für Ihre Ressourcen und die verschiedenen Protokolleinträge anzeigen können, die Sie in der CloudWatch-Konsole sehen können, nachdem Sie die Protokollierung für AWS IoT Wireless aktiviert haben. Sie können zwar Filterstreams mithilfe von **Protokollgruppen** erstellen, wir empfehlen jedoch, CloudWatch Insights zu verwenden, um Filterstreams zu erstellen und zu verwenden. Weitere Informationen finden Sie unter [Verwenden von CloudWatch Insights zum Filtern von Protokollen nach AWS IoT Wireless](cwl-insights.md).