Afficher et suivre les journaux des messages de suivi de l’analyseur de réseau en temps réel - AWS IoT Wireless
PrérequisActiver la messagerie de suivi à l’aide de la consoleAffichage et surveillance des messages de suiviMessage de journal JSON de l’analyseur de réseauRevue et prochaines étapes

Afficher et suivre les journaux des messages de suivi de l’analyseur de réseau en temps réel

Si vous avez ajouté des ressources à la configuration de votre analyseur de réseau, vous pouvez activer la messagerie de suivi pour commencer à recevoir des messages de suivi pour vos ressources. Vous pouvez utiliser la AWS Management Console, l’API AWS IoT Wireless ou AWS CLI.

Prérequis

Avant de pouvoir activer la messagerie de suivi à l’aide de l’analyseur de réseau, vous devez disposer des éléments suivants :

Activer la messagerie de suivi à l’aide de la console

Pour activer la messagerie de suivi

  1. Ouvrez le Centre d’analyseur de réseau de la AWS IoT console et choisissez la configuration de votre analyseur de réseau, NetworkAnalyzerConfig_Default.

  2. Sur la page de détails de la configuration de votre analyseur de réseau, choisissez Activer la messagerie de suivi, puis sélectionnez Activer.

    Vous allez commencer à recevoir des messages de suivi où le message de suivi le plus récent apparaît en premier dans la console.

    Note

    Après le démarrage de la session de messagerie, la réception de messages de suivi peut entraîner des coûts supplémentaires jusqu’à ce que vous désactiviez la session ou que vous quittiez la session de suivi. Pour de plus amples informations sur la tarification, veuillez consulter AWS IoT CoreTarification.

Affichage et surveillance des messages de suivi

Une fois que vous avez activé la messagerie de suivi, la connexion WebSocket est établie et les messages de suivi commencent à apparaître en temps réel, les plus récents en premier. Vous pouvez personnaliser les préférences pour spécifier le nombre de messages de suivi à afficher sur chaque page et pour afficher uniquement les champs pertinents pour chaque message. Par exemple, vous pouvez personnaliser le journal des messages de suivi pour n’afficher que les journaux des ressources de passerelle sans fil dont le niveau de journalisation est défini sur ERROR, afin d’identifier et de corriger rapidement les erreurs liées à vos passerelles. Le message de suivi contient les informations suivantes.

  • Numéro du message : numéro unique qui indique le dernier message reçu en premier.

  • ID de ressource : de passerelle sans fil ou d’appareil sans fil de la ressource.

  • Horodatage : heure à laquelle le message a été reçu.

  • ID de message : identifiant attribué par AWS IoT Core for LoRaWAN à chaque message reçu.

  • FPort : port de fréquence permettant de communiquer avec l’appareil à l’aide de la connexion WebSocket.

  • DevEui : identifiant unique étendu (EUI) de votre appareil sans fil.

  • Ressource : si la ressource surveillée est un appareil sans fil ou une passerelle sans fil.

  • Événement : événement correspondant à un message de journal pour un appareil sans fil, qui peut être Join, Rejoin, Uplink_Data, Downlink_Data ou Registration.

  • Niveau de journalisation : informations sur INFO ou ERROR flux de journaux relatifs à votre appareil.

Message de journal JSON de l’analyseur de réseau

Vous pouvez également choisir un message de suivi à la fois pour afficher la charge utile JSON associée à ce message. Selon le message que vous sélectionnez dans les journaux des messages de suivi, vous verrez des informations dans la charge utile JSON indiquant qu’il contient deux parties : CustomerLog et LoraFrame.

Journal du client

La partie CustomerLog du JSON affiche le type et l’identifiant de la ressource qui a reçu le message, le niveau du journal et le contenu du message. L’exemple suivant montre un message de journal CustomerLog. Vous pouvez utiliser le champ message du JSON pour obtenir plus d’informations sur l’erreur et sur la manière de la résoudre.

Cadre Lora

La partie LoraFrame du JSON possède un ID de message et contient des informations sur la charge utile physique de l’appareil et les métadonnées sans fil.

La structure du message JSON est présentée dans l’exemple suivant.

export type TraceMessage = {
  ResourceId: string;
  Timestamp: string;
  LoRaFrame: 
  {
    MessageId: string;
    PhysicalPayload: any;
    WirelessMetadata: 
    {
      fPort: number;
      dataRate: number;
      devEui: string;
      frequency: number,
      timestamp: string;
    },
  }
  CustomerLog: 
  {
    resource: string;
    wirelessDeviceId: string;
    wirelessDeviceType: string;
    event: string;
    logLevel: string;
    messageId: string;
    message: string;
  },
};

Revue et prochaines étapes

Dans cette section, vous avez consulté les messages de suivi et appris comment utiliser ces informations pour corriger les erreurs. Après avoir consulté tous les messages, vous pouvez :

  • Pour désactiver la messagerie de suivi

    Pour éviter des coûts supplémentaires, vous pouvez désactiver la session de messagerie de suivi. La désactivation de la session déconnecte votre connexion WebSocket afin que vous ne receviez aucun message de suivi supplémentaire. Vous pouvez toujours consulter les messages existants dans la console.

  • Modifier les informations de la trame pour votre configuration

    Vous pouvez modifier la configuration de l’analyseur de réseau, choisir de désactiver les informations de la trame et de choisir les niveaux de journalisation de vos messages. Avant de mettre à jour votre configuration, pensez à désactiver votre session de messagerie de suivi. Pour effectuer ces modifications, ouvrez la page de détails de l’analyseur de réseau dans la AWS IoT console et choisissez Modifier. Vous pouvez ensuite mettre à jour votre configuration avec les nouveaux paramètres de configuration et activer la messagerie de suivi pour voir les messages mis à jour.

  • Ajoutez des ressources à votre configuration.

    Vous pouvez également ajouter des ressources supplémentaires à la configuration de votre analyseur de réseau et les suivre en temps réel. Vous pouvez ajouter un total de 250 ressources de passerelle sans fil et d’appareil sans fil. Pour ajouter des ressources, sur la page de détails de l’analyseur de réseau de la AWS IoT console, choisissez l’onglet Ressources, puis choisissez Ajouter des ressources. Vous pouvez ensuite mettre à jour votre configuration avec les nouvelles ressources et activer la messagerie de suivi pour voir les messages mis à jour pour les ressources supplémentaires.

Pour plus d’informations sur la mise à jour de la configuration de votre analyseur de réseau en modifiant les paramètres de configuration et en ajoutant des ressources, consultez Ajouter des ressources et mettre à jour la configuration de l’analyseur de réseau.