Utilisez CloudWatch Insights pour filtrer les journaux pour AWS IoT Wireless

Bien que vous puissiez utiliser CloudWatch Logs pour créer des expressions de filtre, nous vous recommandons d'utiliser CloudWatch Insights pour créer et utiliser plus efficacement des expressions de filtre en fonction de votre application.

Nous vous recommandons d'utiliser d'abord les groupes de journaux CloudWatch pour en savoir plus sur les différents types de ressources, leurs types d'événements et les niveaux de journal que vous pouvez utiliser pour afficher les entrées de journal dans la console. Vous pouvez ensuite utiliser les exemples de certaines expressions de filtre de cette page comme référence pour créer vos propres filtres pour vos ressources AWS IoT Wireless.

Affichage des journaux AWS IoT dans la console d'informations CloudWatch Logs

Dans la console CloudWatch, les journaux CloudWatch apparaissent dans un groupe de journaux nommé /aws/iotwireless. Pour plus d'informations sur CloudWatch Logs, consultez CloudWatch Logs.

Pour afficher vos journaux AWS IoT dans la console CloudWatch

Accédez à la console CloudWatch et choisissez Logs Insights dans le volet de navigation.

1. Dans la zone de texte Filtre, entrez /aws/iotwireless, puis choisissez Informations sur les journaux /aws/iotwireless.

2. Pour afficher la liste complète des groupes de journaux, choisissez Sélectionner un ou plusieurs groupe de journaux. Pour rechercher des groupes de journaux AWS IoT Wireless, sélectionnez /aws/iotwireless.

Vous pouvez maintenant commencer à saisir des requêtes pour filtrer les groupes de journaux. Les sections suivantes contiennent des requêtes utiles qui vous aideront à mieux comprendre les indicateurs de vos ressources.

Créez des requêtes utiles pour filtrer et obtenir des informations sur AWS IoT Wireless

Vous pouvez utiliser des expressions de filtre pour afficher des informations de journal supplémentaires utiles avec CloudWatch Insights. Voici quelques exemples de requêtes :

Afficher uniquement les journaux pour des types de ressources spécifiques

Vous pouvez créer une requête qui vous aidera à afficher les journaux pour des types de ressources spécifiques uniquement, tels qu'une passerelle LoRaWAN ou un appareil Sidewalk. Par exemple, pour filtrer les journaux afin d'afficher uniquement les messages relatifs aux appareils Sidewalk, vous pouvez saisir la requête suivante et choisir Exécuter la requête. Pour enregistrer cette requête, choisissez Enregistrer.

fields @message
| filter @message like /Sidewalk/

Une fois la requête exécutée, vous verrez les résultats dans l'onglet Journaux, qui indique les horodatages des journaux associés aux appareils Sidewalk de votre compte. Vous verrez également un graphique à barres, qui indiquera l'heure à laquelle les événements se sont produits, s'il y a eu des événements précédemment liés à votre appareil Sidewalk. Voici un exemple si vous développez l'un des résultats dans l'onglet Journaux. Si vous souhaitez résoudre les erreurs liées aux appareils Sidewalk, vous pouvez également ajouter un autre filtre qui définit le niveau de journalisation sur ERROR et n'affiche que les informations d'erreur.

Field	          Value
@ingestionTime      1623894967640
@log	             954314929104:/aws/iotwireless
@logStream	   WirelessDevice-Downlink_Data-715adccfb34170214ec2f6667ddfa13cb5af2c3ddfc52fbeee0e554a2e780bed
@message	     {                    
                    "resource": "WirelessDevice",
                    "wirelessDeviceId": "3b058d05-4e84-4e1a-b026-4932bddf978d",
                    "wirelessDeviceType": "Sidewalk",
                    "devEui": "feffff000000011a",
                    "event": "Downlink_Data",
                    "logLevel": "INFO",
                    "messageId": "7e752a10-28f5-45a5-923f-6fa7133fedda",
                    "message": "Successfully sent downlink message. Amazon SidewalkId = 2000000006, Sequence number = 0"
                    }
@timestamp          1623894967640
devEui	           feffff000000011a
event	        Downlink_Data
logLevel            INFO
message	          Successfully sent downlink message. Amazon SidewalkId = 2000000006, Sequence number = 0
messageId	    7e752a10-28f5-45a5-923f-6fa7133fedda
resource	     WirelessDevice
wirelessDeviceId    3b058d05-4e84-4e1a-b026-4932bddf978d
wirelessDeviceType  Sidewalk

Afficher des messages ou des événements spécifiques

Vous pouvez créer une requête qui vous aidera à afficher des messages spécifiques et à observer le moment où les événements se sont produits. Par exemple, si vous voulez savoir quand votre message de liaison descendante a été envoyé depuis votre appareil sans fil LoRaWAN, vous pouvez saisir la requête suivante et choisir Exécuter la requête. Pour enregistrer cette requête, choisissez Enregistrer.

filter @message like /Downlink message sent/

Une fois la requête exécutée, vous verrez les résultats dans l'onglet Journaux, qui indique l'heure à laquelle le message de liaison descendante a été correctement envoyé à votre appareil sans fil. Vous verrez également un graphique à barres indiquant l'heure à laquelle un message de liaison descendante a été envoyé, si des messages de liaison descendante ont déjà été envoyés à votre appareil sans fil. Voici un exemple si vous développez l'un des résultats dans l'onglet Journaux. Sinon, si aucun message de lien descendant n'a été envoyé, vous pouvez modifier la requête pour afficher uniquement les résultats correspondant au cas où le message n'a pas été envoyé afin de pouvoir corriger le problème.

Field	          Value
@ingestionTime      1623884043676
@log	             954314929104:/aws/iotwireless
@logStream	   WirelessDevice-Downlink_Data-42d0e6d09ba4d7015f4e9756fcdc616d401cd85fe3ac19854d9fbd866153c872
@message	     {
                    "timestamp": "2021-06-16T22:54:00.770493863Z",
                    "resource": "WirelessDevice",
                    "wirelessDeviceId": "3b058d05-4e84-4e1a-b026-4932bddf978d",
                    "wirelessDeviceType": "LoRaWAN",
                    "devEui": "feffff000000011a",
                    "event": "Downlink_Data",
                    "logLevel": "INFO",
                    "messageId": "7e752a10-28f5-45a5-923f-6fa7133fedda",
                    "message": "Downlink message sent. MessageId: 7e752a10-28f5-45a5-923f-6fa7133fedda"
                    }
@timestamp          1623884040858
devEui	           feffff000000011a
event	        Downlink_Data
logLevel            INFO
message	          Downlink message sent. MessageId: 7e752a10-28f5-45a5-923f-6fa7133fedda
messageId	    7e752a10-28f5-45a5-923f-6fa7133fedda
resource	     WirelessDevice
timestamp	    2021-06-16T22:54:00.770493863Z
wirelessDeviceId    3b058d05-4e84-4e1a-b026-4932bddf978d
wirelessDeviceType  LoRaWAN

Étapes suivantes

Vous avez appris à utiliser CloudWatch Insights pour obtenir des informations plus utiles en créant des requêtes pour filtrer les messages du journal. Vous pouvez combiner certains des filtres décrits précédemment et concevoir vos propres filtres en fonction de la ressource que vous surveillez. Pour plus d'informations sur l'utilisation de CloudWatch Insights, consultez Analyse des données de journal avec CloudWatch Insights.

Après avoir créé des requêtes avec CloudWatch Insights, si vous les avez enregistrées, vous pouvez charger et exécuter les requêtes enregistrées selon vos besoins. Si vous cliquez sur le bouton Historique dans la console CloudWatch Logs Insights, vous pouvez également consulter les requêtes précédemment exécutées et les réexécuter si nécessaire, ou les modifier ultérieurement en créant des requêtes supplémentaires.