mes_skills/skills/infra/ha-log-investigator/references/log-analysis.md

Analyse des logs

Collecte

• Conserver la source brute quand elle existe.
• Si rtk est disponible localement, produire en complément une version compacte avec rtk log pour réduire le volume transmis au modèle.
• Ne jamais remplacer la source brute par le résumé compact.

Stratégie selon le type d'installation

Home Assistant OS

• Ne pas attendre de fichier /config/home-assistant.log par défaut.
• Si un fichier dupliqué existe et n'est pas vide, le préférer pour la collecte automatisée car il évite un shell interactif et garde le flux brut disponible.
• Considérer comme sources officielles prioritaires :
  1. l'interface Settings > System > Logs ;
  2. ha core logs depuis l'add-on officiel Terminal & SSH si l'accès SSH autorisé le permet ;
  3. /config/home-assistant.log seulement si le mode duplicate-log-file a été activé volontairement.
• Si plusieurs add-ons SSH sont installés, ne pas supposer qu'ils donnent le même accès : tracer l'add-on réellement utilisé pour la collecte.
• Si ha core logs retourne 401 Unauthorized en commande distante directe mais fonctionne en session ouverte, tester une session SSH interactive avec TTY (ssh -tt) : certains environnements d'add-on initialisent l'accès Supervisor seulement dans ce contexte.

Home Assistant Container / Core

• Vérifier les fichiers logs de configuration quand ils existent et les commandes adaptées au mode d'installation.

Cas où aucune source de log exploitable n'est disponible

Vérifier séparément :

1. le type d'installation ;
2. les sources officiellement attendues pour ce type ;
3. l'existence éventuelle de fichiers dupliqués ;
4. les erreurs d'autorisation éventuelles sur les commandes documentées.

Si aucune source exploitable n'est accessible :

• l'écrire explicitement dans repair.md ;
• demander un export des logs depuis l'interface Home Assistant ou une source équivalente fournie par l'utilisateur ;
• ne pas conclure à l'absence d'erreurs runtime.

Usage de rtk

Exemple local :

rtk log home-assistant.log > home-assistant.compact.log

Le résumé compact sert à l'analyse rapide ; les constats importants doivent rester traçables vers le log brut.