!Serverschrank mit Netzwerktechnik

Wer seine Heizkurve über drei Winter vergleichen will oder den Stromverbrauch seit dem Einbau der Wärmepumpe, stößt in Home Assistant schnell an eine Grenze. Der eingebaute Recorder ist keine Langzeitdatenbank, und er soll auch keine sein.

Die übliche Antwort darauf heißt seit Jahren InfluxDB und Grafana. Nur hat sich an diesem Gespann 2026 gleich zweimal etwas geändert, und wer eine ältere Anleitung befolgt, landet in einer Sackgasse.

Zwei Änderungen, die man vorher kennen sollte

Das Add-on ist weg. Das InfluxDB-Add-on der Home Assistant Community Add-ons wurde im August 2026 aus dem Store entfernt. Grund ist das Ende der Unterstützung für InfluxDB 1.x. Wer es noch installiert hat, betreibt eine Version ohne Pflege. Die YAML-Konfiguration der Verbindung ist gestrichen. Home Assistant hat die Verbindungseinstellungen für InfluxDB aus der configuration.yaml herausgelöst. Die Warnmeldung dazu lautete unmissverständlich, dass die YAML-Konfiguration entfernt wird und ab Version 2026.9.0 nicht mehr funktioniert.

Beides zusammen bedeutet: Praktisch jede Anleitung, die vor Mitte 2026 geschrieben wurde, beschreibt einen Weg, den es so nicht mehr gibt. Und der Fehler äußert sich unangenehm, nämlich als stillschweigend fehlende Daten statt als Fehlermeldung.

Was wohin gehört, seit die Trennung gilt

Die neue Aufteilung ist nach kurzer Eingewöhnung logischer als die alte.

In die Oberfläche wandert alles, was die Verbindung betrifft: URL, Organisation, Bucket, API-Token und die SSL-Einstellungen. Der Weg führt über Einstellungen, dann Geräte und Dienste, dann Integration hinzufügen. In der configuration.yaml bleibt dagegen die Filterung, also die Entscheidung, welche Entitäten überhaupt in die Datenbank geschrieben werden: 
influxdb:
  include:
    domains:
      - sensor
      - binary_sensor
  exclude:
    entities:
      - sensor.date

Dieser Block ist wichtiger, als er aussieht. Ohne Filter schreibt Home Assistant alles nach InfluxDB, auch Datums- und Zeitsensoren, Verbindungszähler und jede Statusänderung jedes Schalters. Die Datenbank wächst dann schnell und die Grafana-Abfragen werden zäh, ohne dass man mehr Erkenntnis hätte.

Der Einrichtungsweg 2026

Es gibt zwei Wege, und welcher infrage kommt, hängt von der Installationsart ab.

Bei Home Assistant OS oder Supervised installiert man ein Community-Add-on für InfluxDB 2, etwa das Repository danieloldberg/addon-influxdbv2. Das ist der bequeme Weg, weil Add-on und Home Assistant im selben System laufen. Bei Container- oder Core-Installationen läuft InfluxDB als eigener Docker-Container mit dem offiziellen Image influxdb:2, neben Home Assistant. Das ist der sauberere Weg, weil man Datenbank und Automatisierung unabhängig voneinander aktualisieren kann.

Grafana kommt in beiden Fällen als eigener Dienst dazu. Eine getestete Kombination sind Home Assistant 2026.9.1, InfluxDB 2.9.1 und Grafana 13.2.

Die vier Fallstricke bei der ersten Abfrage

Hier gehen die meisten Nachmittage verloren, und alle vier Punkte sind bekannt und vermeidbar.

Die Messungen heißen nicht wie die Entitäten. InfluxDB legt die Messung nach der Einheit an, also °C, % oder W, nicht nach dem Entitätsnamen. Wer nach sensor.wohnzimmer_temperatur sucht, findet nichts und hält die Anbindung für kaputt. Der entity_id-Tag hat kein Domain-Präfix. Die Abfrage lautet entity_id == "wohnzimmer_temperatur", nicht sensor.wohnzimmer_temperatur. Das ist der zweithäufigste Grund für leere Diagramme. Das Feld muss gefiltert werden. Ohne einen Filter auf _field gleich value versucht Grafana, auch Textwerte zu aggregieren, und die Abfrage scheitert mit einer Fehlermeldung, die auf etwas ganz anderes hindeutet. Im Docker-Umfeld gehören Dienstnamen in die URL, keine IP-Adressen. Also http://influxdb:8086 statt einer Adresse aus dem Heimnetz. Sonst funktioniert es genau so lange, bis sich eine Adresse ändert.

Der Recorder gehört trotzdem angefasst

Ein Missverständnis hält sich hartnäckig: InfluxDB ersetzt den Recorder nicht. Verlauf, Logbuch und die Historienansicht in Home Assistant greifen weiterhin auf die interne Datenbank zu. InfluxDB bekommt zusätzlich eine Kopie der ausgewählten Zustandsänderungen.

Daraus folgt, dass beide Seiten getrennt konfiguriert werden wollen. Der Recorder darf kurz eingestellt sein, weil die Langzeitdaten woanders liegen. In Beispielkonfigurationen taucht dafür etwa purge_keep_days: 15 auf, gegenüber einer Voreinstellung, die typischerweise rund zehn Tage behält.

Wer den Recorder zusätzlich mit include und exclude einschränkt, bekommt eine spürbar flottere Oberfläche. Das ist bei Installationen auf einem Raspberry Pi oder in einer kleinen VM der wirksamste Einzelgriff überhaupt. Wie sich so eine Installation sonst noch beschleunigen lässt, steht im Artikel über die Home-Assistant-Installation als Proxmox-VM.

Wann sich der Aufwand lohnt und wann nicht

Ehrlich gesagt nicht immer. Seit Home Assistant Langzeitstatistiken eingeführt hat, werden Sensoren mit der passenden Zustandsklasse ohnehin stündlich verdichtet und langfristig behalten. Für viele Fragen reicht das, und das eingebaute Energie-Dashboard beantwortet die typischen Verbrauchsfragen ohne jede Zusatzsoftware.

Der Aufwand lohnt sich in drei Fällen. Erstens, wenn Werte in feiner Auflösung über Jahre gebraucht werden, etwa Vorlauftemperatur im Minutentakt über drei Heizperioden. Zweitens, wenn Daten aus verschiedenen Quellen in einem Diagramm zusammenkommen sollen, also Heizung, Wetter und Strompreis nebeneinander. Drittens, wenn die Auswertung geteilt werden soll, ohne Zugang zur Steuerung zu geben, denn ein Grafana-Dashboard kann man herzeigen, eine Home-Assistant-Instanz eher nicht.

Wer keinen dieser drei Fälle hat, ist mit den Bordmitteln gut bedient und spart sich zwei zusätzliche Dienste, die gepflegt und gesichert werden wollen. Was beim Sichern zu beachten ist, steht im Artikel über die Backup-Strategie.

Ein Hinweis zur Datensicherung

Ein Punkt, der beim Basteln gern untergeht: Die InfluxDB-Daten liegen außerhalb des Home-Assistant-Backups. Ein Snapshot von Home Assistant sichert die Datenbank nicht mit, wenn sie in einem eigenen Container läuft.

Wer drei Jahre Messwerte aufgebaut hat und sie beim nächsten Serverumzug verliert, ärgert sich zu Recht. Ein regelmäßiger Export des Buckets gehört deshalb zur Einrichtung dazu, nicht in die Rubrik mache ich später.

Quellen: Aktualisierter Einrichtungsleitfaden zu Home Assistant, InfluxDB und Grafana, getestet gegen Home Assistant 2026.9.1, InfluxDB 2.9.1 und Grafana 13.2, mit den Angaben zur Entfernung des Community-Add-ons im August 2026 und zum Wegfall der YAML-Verbindungskonfiguration ab Version 2026.9.0, veröffentlicht bei smarthomeassistant.co.uk · deutschsprachige Einrichtungsanleitungen mit den Recorder-Einstellungen bei alkly.de und simon42.com · Diskussion zu Recorder, SQLite, InfluxDB und Grafana im KNX-User-Forum