Modul: Energieprofil

eedc Handbuch — Energieprofil

Dieses Handbuch ist Teil der eedc-Dokumentation. Siehe auch: Teil II: Bedienung | Teil III: Einstellungen | Daten-Checker | Prognosen | Berechnungen & Kennzahlen | Glossar

Inhaltsverzeichnis

Was ist das Energieprofil?
Wo du das Energieprofil in der App findest
Voraussetzungen: die richtigen Datenquellen
Reparatur & Pflege
Bekannte Fehlerbilder
Beziehung zu anderen Auswertungen

1. Was ist das Energieprofil?

Das Energieprofil ist die feinste zeitliche Auflösung deiner Anlagendaten in eedc: eine Zeile pro Stunde und daraus abgeleitet eine Zusammenfassung pro Tag. Während das Cockpit auf Monats- und Jahresebene mit Summen arbeitet, hält das Energieprofil fest, wann an einem Tag welche Energie geflossen ist — Stunde für Stunde, getrennt nach PV-Erzeugung, Netzbezug, Einspeisung, Batterie, Wärmepumpe, Wallbox und sonstigen Verbrauchern.

Damit ist das Energieprofil die Datengrundlage fast aller anderen Auswertungen: Stundenwerte werden zu Tagessummen verdichtet, Tagessummen zu Monatswerten. Wenn im Cockpit oder in den Auswertungen etwas „komisch” aussieht, liegt die Ursache fast immer eine Ebene tiefer — im Energieprofil.

Kernidee: eedc rechnet kWh als Differenz kumulativer Zählerstände (wie das HA-Energie-Dashboard), nicht durch Aufsummieren von Leistungsmesswerten. Das ist der wichtigste Unterschied, um die Abhängigkeiten und Fehlerbilder dieses Bereichs zu verstehen. Wie eedc die Werte erhebt und verdichtet, steht ausführlich im Hintergrund-Kapitel Einstellungen → Hintergrund: Energieprofile & Snapshot-Architektur.

2. Wo du das Energieprofil in der App findest

Früher hatte das Energieprofil einen eigenen Tab „Auswertung → Energieprofil (Beta)” mit vier Sub-Reitern (Tagesdetail, Wochenvergleich, Monat, Prognose). In der neuen Oberfläche gibt es diesen Tab nicht mehr. Stattdessen sind seine Darstellungen dorthin gewandert, wo sie thematisch hingehören — und nach einem einfachen Grundsatz getrennt:

Anzeige ≠ Pflege. Die Auswertung der Stunden- und Tageswerte findest du im Cockpit (nach Zeit-Ebene sortiert); das Pflegen und Reparieren der Daten liegt gebündelt in den Einstellungen.

Früher (Sub-Tab „Energieprofil (Beta)“)	Jetzt
Tagesdetail (Butterfly-Chart + Stundentabelle)	Cockpit → Tag
Monat (Monats-Reichdarstellungen)	Cockpit → Monat
Prognose (Tagesprognose)	Cockpit → Aussicht
Tages-Tabelle (eine Zeile pro Tag, viele Spalten)	Auswertungen → Tabelle
Datenverwaltung / Reparatur	Einstellungen → Daten → Energieprofil-Pflege
Wochenvergleich	entfällt (siehe Hinweis unten)

2.1 Tagesdetail → Cockpit → Tag

Der einzelne Kalendertag mit Stunden-Auflösung. Die Tag-Sicht zeigt den Stunden-Verlauf von Erzeugung, Verbrauch und Speicher, eine Tagesbilanz als Kennzahl-Strip und die Stundenwert-Detailtabelle. Datum-Navigation über die Zeit-Leiste. Details: Bedienung → Cockpit → Tag.

2.2 Monats-Analysen → Cockpit → Monat

Die reichhaltigen Monats-Darstellungen des alten Energieprofils sind in die Monat-Sicht des Cockpits gehoben — reuse aus demselben Stunden-Bestand, ohne neuen Rechenweg. Neben Kennzahl-Strip und Energiebilanz zeigt die Monat-Sicht:

Performance Ratio (Ø Monat) — als Kennzahl.
Erzeugung & Verbrauch nach Kategorie — eine kompakte Anteils-Leiste über alle Erzeuger- und Verbraucher-Kategorien.
Typisches Tagesprofil — der stündliche Mittelwert von PV und Verbrauch über die Tage des Monats.
Top-Stunden — die stärksten Netzbezugs- und Einspeise-Stunden (Datum + Uhrzeit), nützlich zur Tarif-Optimierung.
§51-EEG-Negativpreis — Stunden mit negativem Börsenpreis, die dabei eingespeiste Energie und der Ø-Börsenpreis.

Details: Bedienung → Cockpit → Monat.

2.3 Tages-Prognose → Cockpit → Aussicht

Die stündliche Tagesprognose (PV vs. Verbrauch vs. Netto mit Ladezustands-Overlay) und die zugehörige Prognose-Stundentabelle liegen in der Aussicht. eedc wählt die Prognosebasis (gleicher Wochentag/Tagestyp) und die Wetterquelle automatisch; die gewählte Basis steht als Beschriftung an der Karte. Details: Bedienung → Cockpit → Aussicht und Handbuch Prognosen.

2.4 Roh-Tabelle / Tageswerte → Auswertungen → Tabelle

Die tabellarische Zeile-pro-Tag-Sicht mit Spalten-Selektor, Monats-Summen-/Durchschnittszeile und den Detail-Spalten (Tages-kWh je Gerät, Peaks, Performance Ratio, Börsenpreis-Spalten …) ist in die Werte-Werkbank unter Auswertungen → Tabelle gezogen. Dort wählst du Granularität (Tag/Monat) und Spalten und exportierst bei Bedarf.

Vorzeichen der Geräte-Spalten: positiv = Erzeugung, negativ = Verbrauch. Die Spalte „Stunden verfügbar” (z. B. 20/24) bleibt die wichtigste Diagnose: zeigt sie dauerhaft weniger als 24, fehlen dir Stunden — ein Hinweis auf Snapshot-Lücken oder ein Datenquellen-Problem. Eine einzelne fehlende Stunde in der Home-Assistant-Statistik (Neustart, Update) kostet dagegen keine Energie: eedc rechnet sie wie das HA-Energie-Dashboard, ihre Energie steht in der Stunde danach, und die ist in Stundentabelle und Tagesverlauf als „enthält n Stunden” beschriftet — der Tag bleibt vollständig, auch wenn hier 23/24 steht.

2.5 Pflege → Einstellungen → Daten

Datenbestand-Status, Lücken-Nachfüllen (Vollbackfill), Kraftstoffpreis-Backfill und die Reparatur-Werkbank liegen unter Einstellungen → Daten → Energieprofil-Pflege. Siehe §4.

Aus der alten „Energieprofil (Beta)“-Sicht bewusst nicht übernommen:

der Wochentag-Wochenvergleich entfällt — der Rückblick „Ø gleicher Wochentag” in der Tag-Sicht deckt den Kern.

die Tag×Stunde-Heatmap ist vorerst nicht dabei und kommt später neu gestaltet zurück (Cockpit → Monat).

3. Voraussetzungen: die richtigen Datenquellen

Das Energieprofil rechnet nur so gut wie seine zugeordneten Datenquellen. Die Zuordnung pflegst du feld-zentrisch unter Einstellungen → Datenquellen (Teil III §7). Vier Punkte sind entscheidend:

Kumulative kWh-Zähler, keine Leistungssensoren. Der Aggregator liest ausschließlich fortlaufende kWh-Zählerstände. Ein Leistungssensor (W/kW) in einem kWh-Feld liefert physikalisch unmögliche Stundenwerte. Basis der Anlage sind einspeisung und netzbezug — fehlt einer, bleibt der bilanziell gerechnete Gesamtverbrauch leer.
state_class muss gesetzt sein — HA-LTS ist keine Zeitmaschine. Home Assistant legt Long-Term-Statistics für einen Sensor erst ab dem Zeitpunkt an, an dem dessen state_class gesetzt ist. Vorher existieren keine Daten; kein Backfill kann nachholen, was HA nie aufgezeichnet hat.
Anschaffungs- und Stilllegungsdatum. Eine Komponente fließt nur an den Tagen in die Aggregation ein, an denen sie laut Datum aktiv war (gepflegt unter Einstellungen → Komponenten).
PV-Leistung (kWp) und Koordinaten. leistung_kwp ist Voraussetzung für die Performance Ratio und den Ausreißer-Schutz; Standort-Koordinaten brauchst du für Wetter-IST und Strahlungswerte.

Wie eedc daraus Stunden-, Tages- und Monatswerte macht (Snapshot-Job, Backward-Slot, NULL-Semantik, Zähler-Resets, Ausreißer-Schutz), steht im Hintergrund-Kapitel Einstellungen → §9. Der Daten-Checker warnt aktiv, wenn eine dieser Voraussetzungen fehlt.

4. Reparatur & Pflege

Alle Pflege-Funktionen liegen unter Einstellungen → Daten → Energieprofil-Pflege. eedc bietet bewusst keinen großen „Alles-heilen”-Knopf, sondern gezielte, nachvollziehbare Werkzeuge mit Vorschau — lieber einen konkreten Tag prüfen und reparieren als blind alles überschreiben.

Die Reparatur-Werkbank bündelt die Operationen mit ihren echten Bezeichnungen:

„Tag neu aggregieren” — einen einzelnen Tag neu berechnen. Über eine Alt/Neu-Vorschau entscheidest du zwischen „aus HA neu laden + neu rechnen” (holt die Snapshots frisch) und „nur neu rechnen” (aus den vorhandenen Snapshots). eedc meldet danach, wie viele Stunden mit echten Messdaten verarbeitet wurden — ein ehrlicher Erfolgsindikator, kein pauschales „erledigt”. Der Lauf baut Stundenwerte und Tageszeile neu; die Tages-Kennzahlen der Energiebilanz (Netzbezug, Einspeisung, PV, Speicher) kommen aber, wo er den Tag deckt, aus dem HA-Spiegel — einer Kopie der HA-Langzeitstatistik. Eine Korrektur in Home Assistant übernimmt der nächtliche Abgleich (02:45) — oder sofort der Knopf „HA-Spiegel jetzt abgleichen“ (unten).
„Mehrere Tage neu aggregieren” — ein Datumsbereich (max. 31 Tage). Die Tage werden einzeln verarbeitet und festgeschrieben; ein Abbruch lässt bereits reparierte Tage stehen.

Was die Vorschau prüft — und was sie nicht prüft. Sie stellt deine gespeicherten Zählerstände den Werten aus der Home-Assistant-Statistik gegenüber. Meldet sie „keine Änderung”, heißt das genau das: An den Zählerständen ändert der Lauf nichts. Es heißt nicht, dass der Lauf folgenlos bliebe — die Stundenwerte und die Tageszusammenfassung baut er aus diesen Zählerständen in jedem Fall neu auf, und darauf schaut die Vorschau nicht. Genau das ist der häufigste Grund, sie zu starten: Wenn die Aggregation einmal ausgesetzt hat, stehen die Zählerstände vollständig da, und trotzdem fehlen dir Stunden. Deshalb nennt die Vorschau zusätzlich, wie viele der 24 Stunden für den Tag gespeichert sind — steht dort weniger als 24, trägt der Lauf die fehlenden nach.

Die Reparatur sagt, was sie getan hat — je Komponente. Nach einem Tages-Lauf steht in der Rückmeldung, für welche der zugeordneten Komponenten ein Wert geschrieben wurde und welche leer geblieben sind („2 von 3 Komponenten neu geschrieben — ohne Wert blieb: Wärmepumpe”). Konnte der Lauf für keine Komponente etwas holen, erscheint das als Hinweis statt als Erfolg, mit der häufigsten Ursache daneben (kein Leistungssensor zugeordnet, oder die HA-Historie reicht nicht so weit zurück). Vorher meldete der Einzeltag-Lauf immer „OK” und zeigte nur die PV-Tagessumme vor/nach — eine Komponente ohne geschriebenen Wert war davon nicht zu unterscheiden. Der Bereichs-Lauf macht dieselbe Aussage je Tag.

Wie weit die Reparatur zurückreicht. Sie holt die Stunden-Leistungskurve zuerst aus der HA-Historie — die hebt Home Assistant standardmäßig nur rund zehn Tage auf. Findet sie dort nichts, greift sie auf die Langzeitstatistik zurück, denselben Weg wie „Lücken aus HA-LTS nachfüllen”. Damit reicht die Tagesreparatur so weit zurück wie deine LTS-Daten, nicht nur zehn Tage (bis v4.0.5 stieg sie für ältere Tage mit „keine Live-/MQTT-Daten gefunden” aus, obwohl der Daten-Checker 90 Tage weit prüft). Geht es trotzdem nicht, nennt die Meldung den Grund: keine Leistungs-Zuordnung (Handgriff: Datenquellen), HA nicht erreichbar oder HA hat für den Tag selbst nichts — Letzteres ist keine Fehlfunktion und lässt sich nicht füllen.

Was ein Neu-Aggregieren stehen lässt. Hat Home Assistant für einen Tag keinen einzigen Leistungswert mehr — weil sein Verlauf standardmäßig nur rund zehn Tage reicht —, dann überschreibt eedc keinen gespeicherten Tag damit. Der tägliche Lauf und der Wetter-Nachzug lassen einen solchen Tag stehen, sobald er Gerätewerte trägt. Das Speichern eines Monats (Monatsabschluss) rechnet seit dem Update nach 4.1.2 ohnehin nur noch fehlende Tage — und nur solange Home Assistant sie noch im Verlauf hat; einen vorhandenen Tag fasst es nie an. Die Werkbank („Tag neu aggregieren”, „Mehrere Tage neu aggregieren”, ebenso die Knöpfe „Neu aggregieren” im Daten-Checker) holt die Kurve dann aus der Langzeitstatistik; hat auch die nichts, bleibt der Tag unverändert, und die Meldung sagt das. Ein Tag ohne gespeicherte Gerätewerte wird wie bisher aus den Zählerständen geschrieben.

Wird ein Tag neu geschrieben, bleiben außerdem die Werte stehen, die Home Assistant nur aus seinem Verlauf kennt: die Betriebsart einer Wärmepumpe oder Klimaanlage (Heizen/Kühlen/Warmwasser) und Ladestand und Strompreis von Sensoren ohne Langzeitstatistik; was HA noch liefert, gewinnt.

Bis einschließlich v4.1.0 schrieb eedc solche Tage mit leerer Kurve neu — bei jedem Speichern eines Monats für alle Tage älter als die Aufbewahrung. Rückweg: Die Gerätewerte holt „Mehrere Tage neu aggregieren” aus der Langzeitstatistik zurück, soweit sie den Tag kennt. Die Betriebsart kennt die Langzeitstatistik nicht — so verlorene Stunden kommen nur über eine eedc-Sicherung von vorher zurück.

„HA-Spiegel jetzt abgleichen” — gleicht den HA-Spiegel, aus dem die Tages- und Monats-Kennzahlen der Energiebilanz kommen, sofort mit der HA-Langzeitstatistik ab: derselbe Lauf wie nachts um 02:45. Gebraucht wird er nach einer Korrektur in Home Assistant (Entwicklerwerkzeuge → Statistik → „Wert anpassen”), statt bis zur Nacht zu warten. Die Rückmeldung nennt, wie viele Abschnitte geprüft wurden und welche ab welcher Stunde neu gespiegelt sind; ohne HA-Spiegel (Standalone) sagt sie das. Stundenwerte und Tageszeile baut er nicht neu — dafür ist „Tag neu aggregieren” da.
„Lücken aus HA-LTS nachfüllen” (Vollbackfill) — ergänzt nur fehlende Tage aus den HA-Long-Term-Statistics. Bestehende Tage bleiben unverändert — es gibt bewusst keinen Overwrite-Modus. Sinnvoll nach Erstinstallation, längerem Stillstand oder einer Datenquellen-Änderung.
„Kraftstoffpreise nachpflegen” — trägt fehlende Benzin-/Dieselpreise (EU Weekly Oil Bulletin) für die E-Auto-Ersparnis nach; strikt additiv.
„Wetterreihe nachziehen” — holt Globalstrahlung, Sonnenstunden und Ø Temperatur aller abgeschlossenen Monate von der Wetterquelle, die an der Anlage eingestellt ist. Die einzige Pflege-Operation, die absichtlich ersetzt — und darum die einzige, deren Vorschau die Zahl der betroffenen Monate und die der überschriebenen nennt, bevor etwas passiert.

Wofür es sie gibt. Eine Monats-Wetterreihe muss auf einem Lineal stehen. Open-Meteo und Bright Sky (DWD) messen Sonnenstunden nicht gleich — für denselben Monat und Ort 380 h gegen 232 h, also fast das Doppelte; bei der Globalstrahlung sind es 12–16 %. Wer seine Monate teils importiert und teils über den Knopf im Monatsabschluss geholt hat, trägt eine gemischte Reihe, und ein Jahresvergleich daraus sagt etwas über die Quelle statt über die Sonne. Der Daten-Checker nennt die betroffenen Monate.

Der laufende Monat bleibt draußen. Die Wetter-Archive liefern ihn erst ein paar Tage nach Monatsende vollständig; ein halber Monat, als ganzer festgeschrieben, wäre eine falsche Zahl, die danach feststeht.

Die Ø Temperatur kommt weiter aus deiner eigenen Messreihe, wenn es sie gibt — der Wetterdienst ist für sie die letzte Stufe, nicht die erste. Ein Nachzug, der das nicht täte, ersetzte deine Messung durch einen Regionalwert.

Ein langjähriges Mittel wird nie geschrieben. Antwortet kein messendes Archiv, bleibt der Monat unberührt und die Vorschau nennt die Zahl. Ein Durchschnitt über viele Jahre machte ein schwaches Jahr unsichtbar — also genau das, was diese Funktion sichtbar machen soll.

Für reine Lücken brauchst du sie nicht: einmal täglich füllt eedc von allein, was in einem abgeschlossenen Monat fehlt — nur Lücken, nie etwas Vorhandenes.

Der Gefahrenbereich „Energieprofil-Daten löschen” entfernt Stunden- und Tageswerte (Monatsdaten bleiben erhalten). Der Scheduler holt die Messwerte anschließend aus der HA-Langzeitstatistik zurück — aber nur so weit, wie deine HA-Statistik reicht; nach einem Recorder-Purge, Sensor-Umbau oder einer Neuinstallation ist sie oft kürzer als dein gepflegtes Profil, und ältere Tage bleiben dann weg. Die aufgezeichneten PV-Prognosen (pv_prognose_final_kwh und die Solcast-/ML-Werte, Grundlage des Genauigkeits-Vergleichs) sind Aufzeichnungen eines vergangenen Zeitpunkts — sie lassen sich nicht neu berechnen und sind endgültig verloren. Ebenso die Betriebsart einer Wärmepumpe oder Klimaanlage für alle Tage, die Home Assistant nicht mehr im Verlauf hat (Standard rund zehn Tage) — sie steht nur in diesen Stundenwerten. Nur nutzen, wenn ein Neuaufbau wirklich gewollt ist.

Vollständige Beschreibung der Pflege-Kachel: Einstellungen → §5.2 Energieprofil-Pflege.

5. Bekannte Fehlerbilder

Symptom	Ursache	Was tun
Tage/Stunden fehlen, „X/24”	Sensor hatte (noch) keine `state_class`; HA-LTS reicht nicht so weit zurück	`state_class` setzen — danach läuft die Erfassung ab jetzt. Rückwirkend ist nichts zu retten.
Verbrauchsspalte leer	`einspeisung` oder `netzbezug` nicht zugeordnet	Beide Basis-Felder unter Einstellungen → Datenquellen ergänzen.
Unmöglich hohe Stundenwerte	Leistungssensor (W/kW) in kWh-Feld, oder Zähler-Sprung nach HA-Neustart	Richtigen kumulativen kWh-Zähler zuordnen; betroffenen Tag neu aggregieren. eedc kappt nur PV und Einspeisung in den Stundenwerten; die Tages- und Monats-Kennzahlen aus dem HA-Spiegel übernehmen die HA-Statistik ohne Deckel, wie das Energie-Dashboard von Home Assistant. Ein Sprung aus HA wird deshalb in HA korrigiert (Entwicklerwerkzeuge → Statistik → „Wert anpassen“); der nächtliche Abgleich übernimmt die Korrektur, sofort geht es mit „HA-Spiegel jetzt abgleichen“ (§4). Der Daten-Checker benennt den Sprung (§4.8b).
HA und eedc zeigen leicht andere Tageswerte	Drift zwischen den beiden Aggregator-Pfaden oder Slot-Versatz	Meist harmlos; bei größerer Abweichung Tag neu aggregieren. Der Daten-Checker protokolliert auffällige Tage.
PV doppelt gezählt	Gerät unter zwei Komponenten-Schlüsseln geschrieben (Altbestand)	In aktuellen Versionen behoben (ein eindeutiger Schreiber pro Komponente). Bei Altbeständen betroffene Tage neu aggregieren.
E-Auto + Wallbox doppelt	Die Wallbox misst bereits die Ladung des E-Autos	E-Auto als „Kind” der Wallbox verknüpfen (Parent-Child, Einstellungen → §3.1) — dann wird es nicht zusätzlich gezählt.

Der Daten-Checker als Frühwarnsystem. Mehrere Kategorien beziehen sich direkt aufs Energieprofil (Zähler-Abdeckung, Plausibilität der Stundenwerte, Datenquelle-Drift im HA-Betrieb) und verlinken bei einem Befund direkt zum betroffenen Tag mit „Tag neu aggregieren”. Details: Handbuch Daten-Checker.

6. Beziehung zu anderen Auswertungen

Das Energieprofil ist die Wurzel des Datenbaums — stimmt es, stimmen die darüberliegenden Ebenen meist von selbst:

→ Cockpit → Monat: Autarkie, Eigenverbrauch, Grundbedarf, Batterie-Wirkungsgrad, Performance Ratio, Kategorien-Anteile, Top-Stunden und §51-Negativpreis werden direkt aus den Stunden-/Tageswerten des Monats gebaut.
→ Monatsabschluss (Rollup): Aus den Tageszusammenfassungen entstehen fünf aggregierte Monatsfelder (Überschuss, Defizit, Batterie-Vollzyklen, Performance Ratio, Peak Netzbezug). Die komponentenweisen kWh werden nicht in die Monatsdaten gespiegelt — die gerätbezogenen Monatswerte für Cockpit und ROI kommen aus einer getrennten Datenquelle (InvestitionMonatsdaten). Grundsatz: Monatsdaten = Zählerwerte, InvestitionMonatsdaten = Komponenten-Details.
→ Prognosen / Genauigkeits-Tracking: Die IST-Werte für den Prognosen-Vergleich und den Lernfaktor stammen aus dem Energieprofil (PV-Tagessumme). Fehlt hier die Zähler-Abdeckung, kann eedc keine Prognose-Genauigkeit berechnen. Siehe Handbuch Prognosen.

Merksatz: Bei Auffälligkeiten zuerst hier schauen — und bei Bedarf gezielt einen Tag neu aggregieren, statt an den abgeleiteten Werten zu drehen. Die zugrunde liegende Rechen-Mechanik (Snapshot-Architektur, Backward-Slot, Aggregationsregel) ist im Hintergrund-Kapitel Einstellungen → §9 und in den Berechnungen beschrieben.

Letzte Aktualisierung: 2026-07-25 (v4.0)