46 lines
2.2 KiB
Markdown
46 lines
2.2 KiB
Markdown
# 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.
|