# Afficher les entrées du journal CloudWatch AWS IoT Wireless Après avoir configuré la journalisation AWS IoT Wireless comme décrit dans la section [Créer un rôle et une politique de journalisation pour AWS IoT Wireless](create-logging-role-policy.md) et écrit certaines entrées de journal, vous pouvez consulter les entrées du journal dans la console CloudWatch en effectuant les étapes suivantes. ## Affichage des journaux AWS IoT dans la console de groupe de journaux CloudWatch Dans la [console CloudWatch](https://console.aws.amazon.com/cloudwatch), les journaux CloudWatch apparaissent dans un groupe de journaux nommé **/aws/iotwireless**. Pour plus d'informations sur CloudWatch Logs, consultez [CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html). **Pour afficher vos journaux AWS IoT dans la console CloudWatch** Accédez à la [console CloudWatch](https://console.aws.amazon.com/cloudwatch) et choisissez **Groupe de journaux** dans le volet de navigation. 1. Dans la zone de texte **Filtre**, entrez **/aws/iotwireless**, puis choisissez le groupe de journaux `/aws/iotwireless`. 1. Pour voir la liste complète des journaux AWS IoT Core for LoRaWAN générés pour votre compte, choisissez **Rechercher tout**. Pour consulter un flux de journaux individuel, choisissez l'icône de développement. 1. Pour filtrer les flux de journaux, vous pouvez également saisir une requête dans la zone de texte **Filtrer les événements**. Voici quelques requêtes à essayer : + `{ $.logLevel = "ERROR" }` Utilisez ce filtre pour rechercher tous les journaux dont le niveau de journal est égal à `ERROR` et vous pouvez étendre les flux d'erreurs individuels pour lire les messages d'erreur, ce qui vous aidera à les résoudre. + `{ $.resource = "WirelessGateway" }` Trouvez tous les journaux de la ressource `WirelessGateway`, quel que soit le niveau du journal. + `{ $.event = "CUPS_Request" && $.logLevel = "ERROR" }` Recherchez tous les journaux qui ont un type d'événement `CUPS_Request` et un niveau de journalisation `ERROR`. ## Événements et types de ressources Le tableau suivant indique les différents types d'événements pour lesquels vous verrez des entrées de journal. Les types d'événements varient également selon que le type de ressource est un appareil sans fil ou une passerelle sans fil. Vous pouvez utiliser le niveau de journal par défaut pour les ressources et les types d'événements ou remplacer le niveau de journal par défaut en spécifiant un niveau de journal pour chacun d'entre eux. **Types d'événements basés sur les ressources utilisées** | Ressource | Type de ressource | Type d’événement | | --- | --- | --- | | Passerelle sans fil | LoRaWAN | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/iot-wireless/latest/developerguide/cwl-format.html) | | Appareil sans fil | LoRaWAN | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/iot-wireless/latest/developerguide/cwl-format.html) | | Appareil sans fil | Sidewalk | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/iot-wireless/latest/developerguide/cwl-format.html) | La rubrique suivante contient plus d'informations sur ces types d'événements et les entrées de journal pour les passerelles et les appareils sans fil. **Topics** + [Affichage des journaux AWS IoT dans la console de groupe de journaux CloudWatch](#viewing-logs) + [Événements et types de ressources](#cwl-format-events-resources) + [Entrées de journal pour les passerelles sans fil et les ressources des appareils sans fil](wireless-log-entries.md) # 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](https://console.aws.amazon.com/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\$1Request** 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](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," } ``` + 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](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)" } ``` + 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](https://console.aws.amazon.com/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](lorawan-end-devices-add.md). 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](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" } ``` + 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\$1Data et Downlink\$1Data** 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](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\"}" } ``` + 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](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 et Downlink\$1Data** 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\$1Data et Downlink\$1Data** 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](cwl-insights.md).