# 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).