Lire une trace d'exécution

Une automatisation qui ne fait rien pousse à la réécrire. C'est presque toujours une erreur : Home Assistant garde une trace de chaque exécution, qui raconte ce qui s'est réellement passé. La lire prend une minute ; réécrire à l'aveugle remplace une cause connue par une nouvelle.

Où sont les traces

Depuis l'éditeur d'une automatisation, ouvrez ses traces. Chaque exécution récente y figure. Les traces ne sont conservées qu'un temps, et seulement pour les dernières exécutions : provoquez la situation, puis regardez tout de suite.

En tête de chaque trace, Home Assistant indique ce qui l'a déclenchée. En dessous, un graphe montre chaque étape. Cliquer sur une étape affiche son détail : le résultat d'une condition, l'erreur d'une action, la cible visée.

Les quatre histoires possibles

1. Aucune trace au moment attendu. L'automatisation n'a pas démarré. Le déclencheur n'a pas eu lieu, ou l'automatisation est désactivée. Rien ne sert de regarder les actions.
2. Une trace arrêtée sur une condition. Elle a démarré, puis un test a échoué. Le détail de l'étape dit lequel et pourquoi.
3. Une trace en erreur sur une action. Tout allait bien jusqu'à une action qui a échoué, souvent parce que l'appareil visé est indisponible.
4. Une trace arrêtée parce qu'une seule exécution est permise. L'automatisation tournait encore quand le déclencheur suivant est arrivé. C'est le sujet de la leçon suivante.

flowchart TD
    P["L'automatisation n'a rien fait"] --> T{"Une trace existe ?"}
    T -- non --> N["Déclencheur ou automatisation désactivée"]
    T -- oui --> S{"Où s'arrête-t-elle ?"}
    S --> C["Sur une condition : lire le détail"]
    S --> A["Sur une action en erreur : réparer l'appareil"]
    S --> M["Exécution déjà en cours : voir le mode"]

Séparer les deux moitiés

L'éditeur permet de lancer les actions à la main, sans déclencheur ni condition. Si elles fonctionnent ainsi mais pas en conditions réelles, la panne est forcément dans le déclencheur ou une condition. Ce seul geste coupe le problème en deux.

Cas concret

« La lumière du couloir ne s'allume plus la nuit. » La trace existe, donc le déclencheur fonctionne. Elle s'arrête sur la condition « soleil couché ». Le détail montre que la condition attend la position « sous l'horizon » et que l'heure de l'essai était 18 h en juin : il faisait encore jour. L'automatisation fonctionnait parfaitement. Il fallait tester la nuit.

Erreurs fréquentes

• Réécrire avant de lire la trace. On perd la seule information fiable.
• Regarder la trace trop tard. Les anciennes exécutions ne sont plus gardées.
• Corriger l'automatisation quand l'action échoue sur un appareil indisponible. Réparez l'appareil ; voir Home Assistant : un appareil est indisponible.

À retenir

• Pas de trace : déclencheur. Arrêt sur condition : la condition. Erreur sur action : l'appareil ou l'action.
• Lancer les actions à la main coupe le problème en deux.
• La fiche Home Assistant : une automatisation ne se déclenche pas reprend la procédure pas à pas.

Mini-exercice

Ouvrez la trace de la dernière exécution d'une de vos automatisations. Identifiez son déclencheur, puis cliquez sur chaque condition pour lire son résultat.