# Création d’une configuration de l’analyseur de réseau et ajout de ressources
Avant de pouvoir diffuser des messages de suivi, créez une configuration d’analyseur de réseau et ajoutez les ressources que vous souhaitez suivre à cette configuration. Lorsque vous créez une configuration, vous pouvez :
+ Spécifiez un nom de configuration et, éventuellement, une description.
+ Personnalisez les paramètres de configuration tels que les informations sur la trame et le niveau de détail de vos messages de journal.
+ Ajoutez les ressources que vous souhaitez suivre. Les ressources peuvent être des appareils et/ou des passerelles sans fil.
Les paramètres de configuration que vous spécifiez détermineront les informations de messagerie de suivi que vous recevrez pour les ressources que vous ajoutez à la configuration. Vous souhaiterez peut-être également créer plusieurs configurations en fonction de votre cas d’utilisation de contrôle.
Le résultat est de créer une configuration et d’ajouter des ressources.
**Topics**
+ [Créer une configuration de l’analyseurr de réseau](network-analyzer-create.md)
+ [Ajouter des ressources et mettre à jour la configuration de l’analyseur de réseau](network-analyzer-resources.md)
# Créer une configuration de l’analyseurr de réseau
Avant de pouvoir surveiller vos passerelles ou vos appareils sans fil, vous devez créer une configuration d’analyseur de réseau. Lors de la création de la configuration, vous devez uniquement spécifier un nom de configuration. Vous pouvez personnaliser vos paramètres de configuration et ajouter les ressources que vous souhaitez contrôler à votre configuration, même après sa création. Les paramètres de configuration déterminent les informations de messagerie de suivi que vous recevrez pour ces ressources.
En fonction des ressources que vous souhaitez suivre et du niveau d’informations que vous souhaitez recevoir à leur sujet, vous souhaiterez peut-être créer plusieurs configurations. Par exemple, vous pouvez créer une configuration qui affiche uniquement les informations d’erreur pour un ensemble de passerelles de votre Compte AWS. Vous pouvez également créer une configuration qui affiche toutes les informations relatives à un appareil sans fil que vous souhaitez contrôler.
Les sections suivantes présentent les différents paramètres de configuration et indiquent comment créer votre configuration.
## Paramètres de configuration
Lorsque vous créez ou mettez à jour la configuration de votre analyseur de réseau, vous pouvez également personnaliser les paramètres suivants pour filtrer les informations du flux de journaux.
+
**Informations sur la trame**
Ce paramètre correspond aux informations de trame relatives aux ressources de votre appareil sans fil pour les messages de suivi. Les informations de trame peuvent être utilisées pour déboguer la communication entre votre serveur réseau et les appareils finaux. Il est activé par défaut.
+
**Niveaux de journalisation.**
Vous pouvez consulter les journaux d’informations ou d’erreurs, ou vous pouvez désactiver la journalisation.
+
**Infos**
Les journaux dont le niveau de journal est **Info** sont plus détaillés et contiennent à la fois des flux de journaux d’erreurs et des flux de journaux d’informations. Les journaux d’informations peuvent être utilisés pour visualiser les modifications apportées à l’état d’un appareil ou d’une passerelle.
**Note**
La collecte de flux de journaux plus détaillés peut entraîner des coûts supplémentaires. Pour de plus amples informations sur la tarification, veuillez consulter [AWS IoT CoreTarification](https://aws.amazon.com/iot-core/pricing/).
+
**Erreur**
Les journaux dont le niveau de journalisation est **Erreur** sont moins détaillés et n’affichent que les informations relatives aux erreurs. Vous pouvez utiliser ces journaux lorsqu’une application présente une erreur, telle qu’une erreur de connexion à un appareil. En utilisant les informations du flux de journaux, vous pouvez identifier et résoudre les erreurs liées aux ressources de votre flotte.
## Créer une configuration à l’aide de la console
Vous pouvez créer une configuration d’analyseur de réseau et personnaliser les paramètres facultatifs à l’aide de la console AWS IoT ou de l’API AWS IoT Wireless. Vous pouvez également créer plusieurs configurations et supprimer ultérieurement les configurations que vous n’utilisez plus.
**Créer une configuration de l’analyseur de réseau**
1. Ouvrez le [Centre de l’analyseur de réseau de la consoleAWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) et choisissez **Créer une configuration**.
1. Spécifier les paramètres de configuration.
+
**Nom, description et balises**
Spécifiez un **Nom de configuration** unique contenant uniquement des lettres, des chiffres, des traits d’union ou des traits de soulignement. Utilisez le champ **Description** facultatif pour fournir des informations sur la configuration. Utilisez le champ **Balises** pour ajouter des paires clé-valeur de métadonnées relatives à la configuration. Pour plus d’informations sur la dénomination et la description de vos ressources, veuillez consulter [Description de vos ressources AWS IoT Wireless](iotwireless-describe-resources.md).
+
**Paramètres de configuration**
Choisissez si vous souhaitez désactiver les informations sur les trames et utilisez l’option **Sélectionner les niveaux de journalisation** pour choisir les niveaux de journalisation que vous souhaitez utiliser pour vos journaux de messages de suivi. Choisissez **Suivant**.
1. Ajoutez des ressources à votre configuration. Vous pouvez soit ajouter vos ressources maintenant, soit choisir **Créer**, puis ajouter vos ressources ultérieurement. Pour ajouter des ressources ultérieurement, choisissez **Créer**.
Sur la **page Centre de l’analyseur de réseau**, vous verrez la configuration que vous avez créée ainsi que ses paramètres. Pour afficher les détails de la nouvelle configuration, choisissez le nom de la configuration.
**Supprimer votre configuration de l’analyseur de réseau**
Vous pouvez créer plusieurs configurations de l’analyseur de réseau en fonction des ressources que vous souhaitez contrôler et du niveau d’informations de suivi que vous souhaitez recevoir à leur sujet.
**Pour supprimer des configurations depuis la console**
1. Accédez au [Centre de l’analyseur de réseau de la AWS IoT console](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) et choisissez la configuration que vous souhaitez supprimer.
1. Choisissez **Actions**, puis **Supprimer**.
## Création de configuration à l’aide de l'API
Pour créer une configuration d’analyseur de réseau à l’aide de l’API, utilisez l’opération d’API [CreateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateNetworkAnalyzerConfiguration.html) ou la commande CLI [create-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-network-analyzer-configuration.html).
Lorsque vous créez votre configuration, il vous suffit de spécifier un nom de configuration. Vous pouvez également utiliser cette opération d’API pour spécifier les paramètres de configuration et ajouter des ressources lors de la création de la configuration. Sinon, vous pouvez les spécifier ultérieurement à l’aide de l’opération d’API [UpdateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) ou de l’interface de ligne de commande [update-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-network-analyzer-configuration.html).
+
**Créer une configuration**
Lorsque vous créez votre configuration, vous devez spécifier un nom. Par exemple, la commande suivante crée une configuration en fournissant uniquement un nom et, éventuellement, une description. Par défaut, les informations de trame sont activées dans la configuration et utilise un niveau de journalisation de `INFO`.
```
aws iotwireless create-network-analyzer-configuration \
--configuration-name My_Network_Analyzer_Config \
--description "My first network analyzer configuration"
```
L’exécution de cette commande affiche l’ARN et l’ID de la configuration de votre analyseur de réseau.
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
```
+
**Création d’une configuration à l’aide de ressources**
Pour personnaliser ces paramètres de configuration, utilisez le paramètre `trace-content`. Pour ajouter des ressources, utilisez les paramètres `WirelessDevices` et `WirelessGateways` pour spécifier les passerelles et/ou les appareils que vous souhaitez ajouter à votre configuration. Par exemple, la commande suivante personnalise les paramètres de configuration et ajoute à votre configuration les ressources sans fil, spécifiées par leur `WirelessGatewayID` et leur `WirelessDeviceID`.
```
aws iotwireless create-network-analyzer-configuration \
--configuration-name My_NetworkAnalyzer_Config \
--trace-content WirelessDeviceFrameInfo=DISABLED,LogLevel="ERROR" \
--wireless-gateways "12345678-a1b2-3c45-67d8-e90fa1b2c34d" "90123456-de1f-2b3b-4c5c-bb1112223cd1"
--wireless-devices "1ffd32c8-8130-4194-96df-622f072a315f"
```
L’exemple suivant illustre la sortie de l’exécution de la commande :
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
```
**Liste des configurations de l’analyseur de réseau**
Vous pouvez créer plusieurs configurations d’analyseur de réseau en fonction des ressources que vous souhaitez contrôleur et du niveau de détail des informations de messagerie de suivi que vous souhaitez recevoir pour ces ressources. Après avoir créé ces configurations, vous pouvez utiliser l’opération d’API [ListNetworkAnalyzerConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListNetworkAnalyzerConfigurations.html) ou la commande CLI [list-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-network-analyzer-configuration.html) pour obtenir une liste de ces configurations.
```
aws iotwireless list-network-analyzer-configurations
```
L’exécution de cette commande affiche toutes les configurations de l’analyseur de réseau de votre Compte AWS. Vous pouvez également utiliser le paramètre `max-results` pour spécifier le nombre de configurations que vous souhaitez afficher. La sortie de l’exécution de cette commande est présenté ci-dessous :
```
{
"NetworkAnalyzerConfigurationList": [
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Name": "My_Network_Analyzer_Config1"
},
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/90123456-a1a2-9a87-65b4-c12bf3c2d09a",
"Name": "My_Network_Analyzer_Config2"
}
]
}
```
**Supprimer votre configuration de l’analyseur de réseau**
Vous pouvez supprimer une configuration que vous n’utilisez plus à l’aide de l’opération d’API [DeleteNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteNetworkAnalyzerConfiguration.html) ou de la commande CLI [delete-network-analyzer-configuration.](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-network-analyzer-configuration.html)
```
aws iotwireless delete-network-analyzer-configuration \
--configuration-name My_NetworkAnalyzer_Config
```
Exécuter cette commande ne fournit aucune sortie. Pour afficher les configurations disponibles, vous pouvez utiliser l’opération d’API `ListNetworkAnalyzerConfigurations`.
## Étapes suivantes
Maintenant que vous avez créé une configuration d’analyseur de réseau, vous pouvez ajouter des ressources à votre configuration ou mettre à jour vos paramètres de configuration. Pour en savoir plus, consultez [Ajouter des ressources et mettre à jour la configuration de l’analyseur de réseau](network-analyzer-resources.md).
# Ajouter des ressources et mettre à jour la configuration de l’analyseur de réseau
Avant de pouvoir activer la messagerie de suivi, vous devez ajouter des ressources à votre configuration. Vous ne pouvez utiliser qu’une seule configuration d’analyseur de réseau par défaut. AWS IoT Core for LoRaWAN attribue le nom **NetworkAnalyzerConfig\$1Default** à cette configuration et ce champ ne peut pas être modifié. Cette configuration est automatiquement ajoutée à votre Compte AWS lorsque vous utilisez l’analyseur de réseau à partir de la console.
Vous pouvez ajouter les ressources que vous souhaitez surveiller à cette configuration par défaut. Les ressources peuvent être des appareils LoRaWAN et/ou des passerelles LoRaWAN. Pour ajouter chaque ressource individuelle à la configuration, utilisez les identifiants des passerelles et des d’appareils sans fil.
## Paramètres de configuration
Pour configurer les paramètres, commencez par ajouter des ressources à votre configuration par défaut et activez la messagerie de suivi. Une fois que vous avez reçu les journaux des messages de suivi, vous pouvez également personnaliser les paramètres suivants pour mettre à jour votre configuration par défaut et filtrer le flux de journaux.
+
**Informations sur la trame**
Ce paramètre correspond aux informations de trame des ressources de votre appareil sans fil pour les messages de suivi. Les informations de trame sont activées par défaut et peuvent être utilisées pour déboguer la communication entre votre serveur de réseau et les terminaux.
+
**Niveaux de journalisation.**
Vous pouvez consulter les journaux d’informations ou d’erreurs, ou vous pouvez désactiver la journalisation.
+
**Infos**
Les journaux dont le niveau de journalisation est **Info** sont plus détaillés et contiennent des flux de journaux qui sont informatifs et comportent des erreurs. Les journaux informatifs peuvent être utilisés pour visualiser les modifications apportées à l’état d’un appareil ou d’une passerelle.
**Note**
La collecte de flux de journaux plus détaillés peut entraîner des coûts supplémentaires. Pour de plus amples informations sur la tarification, veuillez consulter [AWS IoT CoreTarification](https://aws.amazon.com/iot-core/pricing/).
+
**Erreur**
Les journaux dont le niveau de journalisation est **Erreur** sont moins détaillés et n’affichent que les informations relatives aux erreurs. Vous pouvez utiliser ces journaux lorsqu’une application présente une erreur, telle qu’une erreur de connexion à un appareil. En utilisant les informations du flux de journaux, vous pouvez identifier et résoudre les erreurs liées aux ressources de votre flotte.
## Prérequis
Avant de pouvoir ajouter des ressources, vous devez avoir intégré à AWS IoT Core for LoRaWAN les passerelles et les appareils que vous souhaitez surveiller. Pour en savoir plus, consultez [Connexion de passerelles et d’appareils à AWS IoT Core for LoRaWAN](lorawan-getting-started.md).
## Ajout de ressources et mise à jour de la configuration de l’analyseur de réseau à l’aide de la console
Vous pouvez ajouter des ressources et personnaliser les paramètres facultatifs à l’aide de la console AWS IoT ou de l’API AWS IoT Wireless. Outre les ressources, vous pouvez également modifier vos paramètres de configuration et enregistrer la configuration mise à jour.
**Pour ajouter des ressources à votre configuration (console)**
1. Ouvrez le [hub Analyseur réseau de la console AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) et choisissez la configuration d’analyseur de réseau **NetworkAnalyzerConfig\$1Default**.
1. Choisissez **Ajouter des ressources**.
1. Ajoutez les ressources que vous souhaitez contrôler à l’aide de la passerelle sans fil et des identifiants d’appareils sans fil. Vous pouvez ajouter jusqu’à 250 passerelles ou appareils sans fil. Pour ajouter votre ressource :
1. Utilisez l’onglet **Afficher les passerelles** ou **Afficher les appareils** pour afficher la liste des passerelles et des appareils que vous avez ajoutés à votre Compte AWS.
1. Copiez le `WirelessDeviceID` ou le `WirelessGatewayID` de l’appareil ou de la passerelle que vous souhaitez surveiller et entrez la valeur d’identifiant de la ressource correspondante.
1. Pour continuer à ajouter des ressources, choisissez **Ajouter une passerelle** ou **Ajouter un appareil**, puis ajoutez votre passerelle ou votre appareil sans fil. Si vous avez ajouté une ressource que vous ne souhaitez plus surveiller, choisissez **Supprimer la ressource**.
1. Après avoir ajouté toutes les ressources, choisissez **Ajouter**.
Vous verrez le nombre de passerelles et d’appareils que vous avez ajoutés sur la page du **Centre de l’analyseur de réseau**. Vous pouvez toujours continuer à ajouter des passerelles et des appareils tant que vous n’activez pas la session de messagerie de suivi. Une fois la session activée, pour ajouter des ressources, vous devez désactiver la session.
**Pour modifier la configuration de l’analyseur de réseau (console)**
Vous pouvez également modifier la configuration de l’analyseur de réseau et choisir de désactiver les informations de trame et le niveau de journalisation de vos journaux de messages de suivi.
1. Ouvrez le [hub Analyseur réseau de la console AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) et choisissez la configuration d’analyseur de réseau **NetworkAnalyzerConfig\$1Default**.
1. Choisissez **Modifier**.
1. Choisissez si vous souhaitez désactiver les informations sur les trames et utilisez l’option **Sélectionner les niveaux de journalisation** pour choisir les niveaux de journalisation que vous souhaitez utiliser pour vos journaux de messages de suivi. Choisissez **Enregistrer**.
Vous verrez les paramètres de configuration que vous avez spécifiés sur la page de détails de la configuration de votre analyseur de réseau.
## Ajout de ressources et mise à jour de la configuration de l’analyseur de réseau à l’aide de l’API
Vous pouvez utiliser les [opérations d’API AWS IoT Wireless](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/) ou les [commandes d’interface de ligne de commande AWS IoT Wireless](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html) pour ajouter des ressources et mettre à jour les paramètres de configuration de votre analyseur de réseau.
+ Pour ajouter des ressources et mettre à jour la configuration de votre analyseur de réseau, utilisez l’API [UpdateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) ou l’interface de ligne de commande [update-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-network-analyzer-configuration.html).
+
**Ajout des ressources**
Pour les appareils sans fil que vous souhaitez ajouter, utilisez `WirelessDevicesToAdd` pour entrer le `WirelessDeviceID` des appareils sous forme de tableau de chaînes. Pour les passerelles sans fil que vous souhaitez ajouter, utilisez `WirelessGatewaysToAdd` pour entrer le `WirelessGatewayID` des passerelles sous forme de tableau de chaînes.
+
**Modification de la configuration**
Pour modifier la configuration de votre analyseur de réseau, utilisez le paramètre `TraceContent` pour spécifier si `WirelessDeviceFrameInfo` doit avoir la valeur `ENABLED` ou `DISABLED`, et si le paramètre `LogLevel` doit avoir la valeur `INFO`, `ERROR` ou `DISABLED`.
```
{
"TraceContent": {
"LogLevel": "string",
"WirelessDeviceFrameInfo": "string"
},
"WirelessDevicesToAdd": [ "string" ],
"WirelessDevicesToRemove": [ "string" ],
"WirelessGatewaysToAdd": [ "string" ],
"WirelessGatewaysToRemove": [ "string" ]
}
```
+ Pour obtenir des informations sur la configuration des ressources que vous avez ajoutées, utilisez l’opération d’API [GetNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) ou la commande [get-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-network-analyzer-configuration.html). Indiquez le nom de la configuration de l’analyseur de réseau, `NetworkAnalyzerConfig_Default`, en entrée.
## Étapes suivantes
Maintenant que vous avez ajouté des ressources et spécifié les paramètres de configuration facultatifs pour votre configuration, vous pouvez utiliser le protocole WebSocket pour établir une connexion à AWS IoT Core for LoRaWAN afin d’utiliser l’analyseur de réseau. Vous pouvez ensuite activer la messagerie de suivi et commencer à recevoir des messages de suivi pour vos ressources. Pour en savoir plus, consultez [Diffusez les messages de suivi de l’analyseur de réseau avec WebSockets](network-analyzer-api.md).