Protokolleinträge für WLAN-Gateways und WLAN-Geräteressourcen. - AWS IoT Wireless
Protokolleinträge von WLAN-GatewayProtokolleinträge von WLAN-Geräten

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 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_Anfrage

    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.

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

      {
    "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 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 vonINFO, 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 for 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 for LoRaWAN.

    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.

      {
    "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_Data und Downlink_Data

    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.

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

    {
    "resource": "WirelessDevice",
    "wirelessDeviceId": "8d0b2775-e19b-4b2a-a351-cb8a2734a504",
    "wirelessDeviceType": "Sidewalk",
    "event": "Registration",
    "logLevel": "INFO",
    "message": "Successfully completed device registration. Amazon SidewalkId = 2000000002"
}
  • Uplink_Data und Downlink_Data

    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_Data und Downlink_Data 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.