# 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 :

```bash
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.