Nettoyer l’historique de Home Assistant en sécurité

Recorder conserve les changements d’état et les événements utilisés par l’historique, le journal d’activité et les graphiques. Une purge supprime définitivement les anciennes données détaillées. Avant de commencer, créez une sauvegarde Home Assistant et décidez combien de jours d’historique vous souhaitez garder. Cette version remplace les anciennes instructions risquées de suppression manuelle d’une base active par les fonctions documentées de Recorder.

1. Purger les anciennes données maintenant

Ouvrez « Outils de développement » → « Actions » (« Services » dans les versions plus anciennes) et recherchez recorder.purge. Dans keep_days, indiquez par exemple 7 pour conserver les sept derniers jours d’historique détaillé. N’activez repack que si l’espace libre est suffisant : la réorganisation peut nécessiter temporairement un espace comparable à la taille de la base.

Exécutez l’action une seule fois et attendez sa fin. Une grande base peut demander du temps ; répéter l’action n’accélère pas le traitement. Pour supprimer uniquement l’historique d’entités précises, examinez plutôt recorder.purge_entities et sélectionnez soigneusement les entités concernées.

2. Définir une durée de conservation

Recorder purge normalement les anciennes données détaillées de façon automatique et conserve dix jours par défaut. Vous pouvez raccourcir cette durée dans configuration.yaml, par exemple :

recorder:
  purge_keep_days: 7
  auto_purge: true
  auto_repack: true

Vérifiez l’indentation YAML et la configuration avant de redémarrer Home Assistant. auto_purge et auto_repack sont activés par défaut, mais la réorganisation ne se produit pas chaque nuit. La taille du fichier peut donc rester inchangée immédiatement après une purge.

3. Vérifier l’espace utilisé

Dans « Paramètres » → « Système » → « Réparations » → « Informations système », consultez la taille estimée de la base Recorder. Comparez aussi l’espace libre avant et après la maintenance. Les statistiques à long terme ne sont pas supprimées automatiquement avec l’historique détaillé ; des valeurs agrégées peuvent rester visibles dans les graphiques.

Ne supprimez pas le fichier home-assistant_v2.db pendant que Home Assistant fonctionne. En cas de corruption ou d’espace insuffisant, sauvegardez d’abord votre installation et suivez le diagnostic de la documentation officielle de Recorder plutôt que de réinitialiser la base depuis un gestionnaire de fichiers.