Entrées de journal pour les passerelles sans fil et les ressources des appareils sans fil - AWS IoT Wireless
Entrées du journal de passerelle sans filEntrées du journal des appareils sans fil

Entrées de journal pour les passerelles sans fil et les ressources des appareils sans fil

Après avoir activé la journalisation, vous pouvez consulter les entrées de journal de vos passerelles et appareils sans fil. La section suivante décrit les différents types d'entrées de journal en fonction de vos types de ressources et d'événements.

Entrées du journal de passerelle sans fil

Cette section présente certains exemples d'entrées de journal pour les ressources de votre passerelle sans fil que vous verrez dans la console CloudWatch. Ces messages de journal peuvent avoir le type d'événement CUPS_Request ou Certificate, et peuvent être configurés pour afficher un niveau de journal INFO, ERROR, ou DISABLED au niveau des ressources ou au niveau de l'événement. Si vous souhaitez uniquement voir les informations d'erreur, définissez le niveau de journal sur ERROR. Le message contenu dans l'entrée du journal ERROR contiendra des informations sur les raisons de l'échec.

Les entrées du journal relatives à votre ressource de passerelle sans fil peuvent être classées en fonction des types d'événements suivants :

  • CUPS_Request

    La station LoRa Basics exécutée sur votre passerelle envoie régulièrement une demande de mise à jour au serveur de configuration et de mise à jour (CUPS). Pour ce type d'événement, si vous définissez le niveau de journalisation sur INFO lors de la configuration de la CLI pour votre ressource de passerelle sans fil, alors dans les journaux :

    • Si l'événement est réussi, vous verrez des messages de journal contenant le caractère logLevel de INFO. Les messages incluront des détails sur la réponse CUPS envoyée à votre passerelle et les détails de la passerelle. Voici un exemple de cette entrée de journal. Pour plus d'informations sur le logLevel et d'autres champs de l'entrée de journal, consultez Ressources et niveaux de journalisation 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,"
}

    • En cas d'erreur, vous verrez des entrées de journal comportant un logLevel de ERROR, et les messages incluront des détails sur l'erreur. Voici quelques exemples de situations dans lesquelles un événement CUPS_Request peut provoquer une erreur : le CRC CUPS est manquant, l'URI TC de la passerelle ne correspond pas AWS IoT Core for LoRaWAN, absence de IoTWirelessGatewayCertManagerRole ou impossibilité d'obtenir l'enregistrement de la passerelle sans fil. L'exemple suivant montre une entrée de journal CRC manquante. Pour résoudre l'erreur, vérifiez la configuration de votre passerelle afin de vérifier que vous avez saisi le bon CRC CUPS.

      {
    "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,"
}
  • Certificat

    Ces entrées de journal vous aideront à vérifier si votre passerelle sans fil a présenté le bon certificat pour authentifier la connexion à AWS IoT. Pour ce type d'événement, si vous définissez le niveau de journalisation sur INFO lors de la configuration de la CLI pour votre ressource de passerelle sans fil, alors dans les journaux :

    • Si l'événement est réussi, vous verrez des messages de journal contenant le caractère logLevel de INFO. Les messages incluront des détails sur l'ID du certificat et l'identifiant de la passerelle sans fil. Voici un exemple de cette entrée de journal. Pour plus d'informations sur le logLevel et d'autres champs de l'entrée de journal, consultez Ressources et niveaux de journalisation 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)"
}

    • En cas d'erreur, vous verrez des entrées de journal comportant un logLevel de ERROR, et les messages incluront des détails sur l'erreur. Un identifiant de certificat ou un identifiant de passerelle sans fil non valide ou une incompatibilité entre l'identifiant de passerelle sans fil et l'ID de certificat sont des exemples de situations dans lesquelles une erreur peut se produire lors de l'événement Certificate. L'exemple suivant montre un ERROR en raison d'un identifiant de passerelle sans fil non valide. Pour résoudre l'erreur, vérifiez les identifiants de passerelle.

      {
    "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)"
}

Entrées du journal des appareils sans fil

Cette section présente certains exemples d'entrées de journal pour les ressources de votre appareil sans fil que vous verrez dans la console CloudWatch. Le type d'événement associé à ces messages de journal varie selon que vous utilisez un appareil LoRaWAN ou Sidewalk. Chaque type de ressource ou d'événement d’appareil sans fil peut être configuré pour afficher un niveau de journal de INFO, ERROR, ou DISABLED.

Note

Votre demande ne doit pas contenir à la fois les métadonnées sans fil LoRaWAN et Sidewalk. Pour éviter une entrée dans le journal ERROR dans ce scénario, spécifiez les données sans fil LoRaWAN ou Sidewalk.

Entrées du journal de l'appareil LoRaWAN

Les entrées de journal de votre appareil sans fil LoRaWAN peuvent être classées en fonction des types d'événements suivants :

  • Join et Rejoin

    Lorsque vous ajoutez un appareil LoRaWAN et que vous le connectez à AWS IoT Core for LoRaWAN, avant que votre appareil puisse envoyer des données de liaison montante, vous devez effectuer un processus appelé activation ou join procedure. Pour en savoir plus, consultez Ajout de votre appareil sans fil à AWS IoT Core for LoRaWAN.

    Pour ce type d'événement, si vous définissez le niveau de journalisation sur INFO lors de la configuration de la CLI pour votre ressource de passerelle sans fil, alors dans les journaux :

    • Si l'événement est réussi, vous verrez des messages de journal contenant le caractère logLevel de INFO. Les messages contiendront des informations sur le statut de votre demande d'adhésion ou de réadhésion. Voici un exemple de cette entrée de journal. Pour plus d'informations sur le logLevel et d'autres champs de l'entrée de journal, consultez Ressources et niveaux de journalisation 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"
}

    • En cas d'erreur, vous verrez des entrées de journal comportant un logLevel de ERROR, et les messages incluront des détails sur l'erreur. Parmi les exemples de situations où une erreur peut se produire lors des événements Join et Rejoin, citons un paramètre de région LoRaWAN non valide ou une vérification du code MIC (Message Integrity Code) non valide. L'exemple suivant montre une erreur de jointure due à une vérification du MIC. Pour résoudre l'erreur, vérifiez si vous avez saisi les bonnes clés root.

      {
    "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 et Downlink_Data

    Le type d’événement Uplink_Data est utilisé pour les messages générés par AWS IoT Wireless lorsque la charge utile est envoyée de votre appareil LoRaWAN ou Sidewalk à AWS IoT. Le type d'événement Downlink_Data est utilisé pour les messages liés aux messages de liaison descendante envoyés depuis AWS IoT à l’appareil sans fil.

    Pour ce type d'événement, si vous définissez le niveau de journal sur INFO lors de la configuration de la CLI pour vos appareils sans fil, alors dans les journaux, vous verrez :

    • Si l'événement est réussi, vous verrez des messages de journal contenant le caractère logLevel de INFO. Les messages comprendront des détails sur l'état du message de liaison montante ou descendante envoyé et l'identifiant de l'appareil sans fil. Voici un exemple de cette entrée de journal pour un appareil Sidewalk. Pour plus d'informations sur le logLevel et d'autres champs de l'entrée de journal, consultez Ressources et niveaux de journalisation 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\"}"
}

    • S'il y a une erreur, vous verrez les entrées de journal comportant un logLevel de ERROR et les messages incluront des détails sur l'erreur, ce qui vous aidera à la résoudre. Exemples de cas d'erreur pouvant se produire pour l'événement Registration : problèmes d'authentification, demandes non valides ou trop nombreuses, impossible de chiffrer ou de déchiffrer la charge utile, ou impossibilité de trouver l’appareil sans fil à l'aide de l'ID spécifié. L'exemple suivant montre une erreur d'autorisation rencontrée lors du traitement d'un message.

      {
    "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"
}

Entrées du journal Sidewalk

Les entrées de journal de votre appareil Sidewalk peuvent être classées en fonction des types d'événements suivants :

  • Registration

    Ces entrées de journal vous aideront à surveiller l'état de tous les appareils Sidewalk que vous utilisez pour vous enregistrer à AWS IoT Wireless. Pour ce type d'événement, si vous définissez le niveau de journal sur INFO lors de la configuration de la CLI pour la ressource de votre appareil sans fil, dans les journaux, vous verrez les messages de journal comportant un logLevel de INFO et ERROR. Les messages contiendront des détails sur la progression de l'enregistrement, du début à la fin. Les messages de journal ERROR contiendront des informations sur la résolution des problèmes d'enregistrement de votre appareil.

    Voici un exemple de message de journal dont le niveau de journalisation est de INFO. Pour plus d'informations sur le logLevel et d'autres champs de l'entrée de journal, consultez Ressources et niveaux de journalisation 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 et Downlink_Data

    Les types d'événements Uplink_Data et Downlink_Data pour les appareils Sidewalk sont similaires aux types d'événements correspondants pour les appareils LoRaWAN. Pour plus d'informations, reportez-vous aux sections Uplink_Data et Downlink_Data décrites précédemment pour les entrées du journal des appareils LoRaWAN.

Étapes suivantes

Vous avez appris à consulter les entrées du journal de vos ressources et les différentes entrées de journal que vous pouvez consulter dans la console CloudWatch après avoir activé la journalisation AWS IoT Wireless. Bien que vous puissiez créer des flux filtrés à l'aide de groupe de journaux, nous vous recommandons d'utiliser CloudWatch Insights pour créer et utiliser des flux filtrés. Pour en savoir plus, consultez Utilisez CloudWatch Insights pour filtrer les journaux pour AWS IoT Wireless.