

# Utilisez CloudWatch Insights pour filtrer les journaux pour AWS IoT Wireless
<a name="cwl-insights"></a>

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
<a name="viewing-logs"></a>

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 **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`.

1. 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
<a name="insights-resource-filter"></a>

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
<a name="insights-gateway-filter"></a>

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
<a name="insights-gateway-filter"></a>

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
<a name="insights-next-steps"></a>

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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData).

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.