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.

  • 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 et choisissez Créer une configuration.

2. 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.

   • 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.

3. 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 et choisissez la configuration que vous souhaitez supprimer.

2. 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 ou la commande CLI create-network-analyzer-configuration.

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 ou de l’interface de ligne de commande update-network-analyzer-configuration.

• 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 ou la commande CLI list-network-analyzer-configuration 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 ou de la commande CLI delete-network-analyzer-configuration.

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.