Les logs Z-Wave sont le carnet de bord de votre réseau. Ils enregistrent chaque tentative de communication, chaque erreur, chaque changement d’état. Savoir les lire transforme le dépannage à l’aveugle en diagnostic précis. Ce guide vous apprend à extraire les informations utiles des logs Z-Wave JS UI et Jeedom.
Accéder aux logs Z-Wave JS UI
- Dans Z-Wave JS UI, ouvrez l’onglet « Logs » dans le menu de gauche.
- Utilisez le filtre de niveau : commencez par « WARN » et « ERROR » pour les problèmes actifs.
- Filtrez par numéro de nœud pour isoler un appareil spécifique.
- Exportez les logs en fichier texte pour une analyse approfondie.
Accéder aux logs Jeedom Z-Wave
- Administration > Logs > sélectionnez « zwavejs » ou « openzwave » selon votre plugin.
- Réglez le niveau de log sur « Debug » temporairement pour un diagnostic complet (pensez à revenir en « Info » ensuite).
- Utilisez Ctrl+F dans le navigateur pour rechercher un numéro de nœud ou un type d’erreur.
Anatomie d’une entrée de log Z-Wave
Exemple d’une ligne de log Z-Wave JS :
| 2026-02-10 14:32:11.412 WARN ZWAVE Node 12: Failed to send message after 3 attempts (status: NoAck) |
Décomposition :
| Champ | Valeur dans l’exemple | Signification |
| Timestamp | 2026-02-10 14:32:11.412 | Date et heure précise de l’événement |
| Niveau | WARN | Avertissement (pas critique mais à surveiller) |
| Composant | ZWAVE | Le stack Z-Wave (et non la box domotique) |
| Nœud | Node 12 | L’identifiant du nœud concerné |
| Message | Failed to send… NoAck | Pas d’accusé de réception après 3 tentatives |
Codes d’erreur fréquents et leur signification
| Code / Message | Cause probable | Action recommandée |
| NoAck | Nœud hors portée ou éteint | Vérifier maillage, pile, alimentation |
| Timeout | Le nœud met trop longtemps à répondre | Pile faible, nœud surchargé, portée limite |
| Failed node | Nœud considéré mort par le contrôleur | Exclusion forcée ou ghost node |
| Nonce error (S2) | Erreur de séquence de chiffrement | Réinclure l’appareil en S2 |
| Supervision failed | Commande envoyée mais non confirmée | Vérifier les routes, lancer un Heal |
| Node interview failed | Impossible de lire les caractéristiques du nœud | Réinclure l’appareil, mettre à jour le device file |
Technique de diagnostic par corrélation temporelle
Une méthode puissante consiste à corréler les erreurs dans les logs avec des événements réels :
- Notez l’heure exacte à laquelle un problème se produit (déconnexion, commande ratée).
- Recherchez dans les logs les entrées WARN et ERROR dans un intervalle de ±5 minutes.
- Identifiez le(s) nœud(s) concernés.
- Vérifiez si plusieurs erreurs concernent le même nœud ou des nœuds voisins dans le maillage.
- Consultez la LWR de ces nœuds pour comprendre la route empruntée au moment de l’erreur.
💡 Si vous observez des erreurs récurrentes à des heures précises (18h, 22h…), cherchez une corrélation avec des appareils électriques qui s’allument à ces heures : four, lave-linge, radiateurs. Ces appareils peuvent générer des parasites électriques.
Niveau de verbosité recommandé par situation
| Situation | Niveau de log recommandé |
| Fonctionnement normal | INFO — ne conserve que l’essentiel |
| Diagnostic d’un problème spécifique | DEBUG — tous les détails de communication |
| Investigation d’un crash ou perte réseau | SILLY/TRACE — niveau maximum (lourd) |
| Après résolution du problème | Revenir à INFO obligatoirement |
