Files
mes_skills/skills/infra/ha-log-investigator/references/watchman.md
T
2026-05-16 10:43:42 +02:00

1.5 KiB

Watchman

Rôle

Utiliser Watchman lorsqu'il est installé pour compléter l'audit Home Assistant.

Watchman scanne les fichiers de configuration et signale les entités et actions/services référencés mais manquants ou indisponibles. Il produit un rapport texte, généralement watchman_report.txt, et peut aussi retourner un rapport via l'action watchman.report.

Règles d'usage

  • Vérifier si Watchman est installé avant l'analyse finale.
  • S'il est installé, lire le rapport le plus récent et l'intégrer aux constats.
  • Ne pas traiter automatiquement chaque ligne Watchman comme une vérité absolue : Watchman utilise une analyse heuristique et peut produire des faux positifs ou faux négatifs.
  • Croiser ses résultats avec :
    • l'état réel des entités ;
    • les dashboards ;
    • les automatisations ;
    • les logs runtime.

Rapport attendu

Chercher en priorité :

  • /config/watchman_report.txt
  • ou le chemin configuré dans Watchman si différent.

Quand produire le rapport

Si nécessaire et si l'utilisateur autorise l'action, exécuter watchman.report depuis Home Assistant avec création de fichier afin d'obtenir un rapport actualisé avant l'analyse finale.

Ce qu'il faut reprendre dans les livrables

Dans repair.md :

  • nombre d'entités manquantes ;
  • nombre d'actions/services manquants ;
  • exemples significatifs ;
  • indication que le rapport vient de Watchman.

Dans best_entity.md :

  • pistes de nettoyage des références orphelines ;
  • priorités d'amélioration si elles sont confirmées par d'autres sources.