Logs

Cet article détaille les différents logs (journaux) disponibles dans la console.

Ces journaux sont des enregistrements chronologiques d'événements, d'opérations et d'erreurs. Ils sont utiles pour comprendre le comportement des équipements connectés à la box, diagnostiquer les problèmes, assurer la sécurité et surveiller les performances.

Ces informations sont disponibles dans l’onglet Log de la console et sont regroupées en 3 catégories : Commandes, Evènements et Propriétés :

Logs Commandes

L'objectif est ici d'avoir une traçabilité des commandes (demande d'écriture depuis la console ou l'API) en particulier pour le LoRaWAN, en fournissant des statuts détaillés et un historique complet. Cela permet de mieux comprendre l'état des commandes et de faciliter le processus de débogage.

Chaque évènement commande est affiché avec les informations suivantes :

• Date de l’évènement
• Type de commande
• Statut
• ID unique
• Nom et valeur éventuels de la propriété concernée
• Le nom de l’utilisateur (username) dans la console ou API 

Les types de commande sont les suivants :

• Envoi de configuration
• Demande d'écriture d'une propriété
• Demande de lecture d'une propriété
• Scan (BACnet ou mbus)
• Redémarrage de la box
• Activation de la communication (Activation des data cloud sur les bridges / activation carte SIM)
• Arrêt de la communication (Désactivation des data cloud sur les bridges / désactivation carte SIM)

L'envoi d'une commande suit un processus complexe qui nécessite un suivi de son état d'avancement. La colonne statut décrit l'état courant de la commande (Commande envoyée à la box, envoyée à l'équipement, délivrée, etc ...)

Historique des statuts et aide au debuggage

Un bouton d'accès aux détails de l'évènement commande est disponible sur chaque ligne :

Il permet de visualiser un historique complet des changements de statut, et de suivre toutes les étapes et les événements survenus au cours du processus.

Filtrage de l'affichage

Vous pouvez filtrer la liste d’évènements si vous avez besoin de rechercher une information en particulier. 

Logs Evènements

Ce journal liste les évènements liés au fonctionnement de la console/box et aux échanges avec les équipements associés (hors mise à jour des valeurs de propriétés qui sont répertoriées dans le paragraphe ci-dessous). Ces logs permettent de détecter des problèmes de communications, de format de données, de configuration, de réseau …)

Chaque ligne de log est horodatée et identifiée par son origine (Type / code). Les catégories de types sont les suivantes :

• Générique (0-999)
• Configuration (1000-1999)
• Réseau (2000-2999)
• Configuration des données (3000-3999)
• Propriétés (4000-4999)
• Equipements (5000-5999) 

Vous retrouverez tous les codes utilisés sur cette page. 

Nous avons ici par exemple les codes 2008, 4004 et 4001 qui correspondent aux informations suivantes :

• 2008: Invalid operation when reading or writing a value through the gateway
• 4004: Downlink reception status

• 4001: Read error (property could not be read) 

   

Si les événements sont liés aux équipements et/ou propriétés, leurs noms sont également affichés. La colonne Origine indique la commande à qui est à la source de l’évènement.

Command ID : commande depuis la console ou l’API
Autre : Commande externe ou locale (BMS, planning, scenario,etc..)

Le lien sous Command ID permet de visualiser le détail de cette commande.

Vous pouvez également filtrer la liste des événements si nécessaire :

Logs Propriétés

A chaque fois qu’une valeur de propriété est mise à jour, une ligne est ajoutée dans le journal des propriétés. Cela se produit par exemple lorsque la box reçoit une trame de données d'un capteur LoRaWAN ou lorsque la box reçoit le résultat d'une requête de lecture (modbus, knx …). 

Cette ligne est composée de la date, du nom de l'équipement, de la propriété, de la valeur brute et de la valeur corrigée du facteur de scaling. 

La fonctionnalité de filtrage permet de rechercher des équipements et/ou des propriétés en particulier. 

Pour toute information complémentaire, veuillez nous contacter : Assistance Wattsense.