Was ist der Public-Data-Collector?
Der Public-Data-Collector holt öffentliche Preise und Werte und schreibt sie in die InfluxDB. Jede Gruppe von Werten dient einem eigenen Zweck:
- Benzin, Diesel und Autogas: Mit ihren Preisen lässt sich ein E-Auto mit einem fiktiven Verbrenner vergleichen, der dieselbe Strecke fährt.
- Heizöl und Erdgas: Mit ihren Preisen lässt sich eine Wärmepumpe mit einer Öl- oder Gasheizung vergleichen.
- Börsenstrompreis und Anteil erneuerbarer Energien: Sie zeigen, wann Strom aus dem Netz günstig oder grün ist.
- CO₂-Intensität des Netzstroms, bislang nur für Deutschland: Mit ihr lässt sich je Viertelstunde berechnen, wie viel CO₂ der Netzbezug verursacht und die PV-Anlage eingespart hat. Heute rechnet das Dashboard die Einsparung mit einem festen CO₂-Faktor.
Quellen
Abschnitt betitelt „Quellen“Der Collector liest drei Quellen. Alle sind kostenlos und brauchen weder ein Konto noch einen API-Key. Jede wird mit einem eigenen Schalter eingeschaltet:
| Quelle | Werte | Schalter |
|---|---|---|
| Weekly Oil Bulletin | Kraftstoffe und Heizöl | ENABLE_FUEL |
| Eurostat | Erdgas | ENABLE_GAS |
| Energy-Charts | Strom aus dem öffentlichen Netz | ENABLE_PUBLIC_GRID |
Das Weekly Oil Bulletin gibt die Europäische Kommission heraus, Eurostat ist das Statistikamt der EU. Energy-Charts betreibt das Fraunhofer ISE. Alle drei decken die Mitgliedstaaten der EU ab, Eurostat und Energy-Charts zusätzlich einige weitere Länder in Europa.
Geschriebene Werte
Abschnitt betitelt „Geschriebene Werte“Die Namen in der InfluxDB sind fest vorgegeben. Das Dashboard findet die Werte deshalb ohne eigene Konfiguration.
| Measurement:Field | Wert | Einheit | Ein Wert je |
|---|---|---|---|
Fuel:price_petrol |
Benzin | EUR/l | Woche |
Fuel:price_diesel |
Diesel | EUR/l | Woche |
Fuel:price_lpg |
Autogas | EUR/l | Woche |
Fuel:price_heating_oil |
Heizöl | EUR/l | Woche |
Gas:price |
Erdgas | EUR/kWh | Monat |
PublicGrid:price |
Day-Ahead-Preis | EUR/kWh | Viertelstunde |
PublicGrid:renewable_share |
Anteil erneuerbarer Energien | Prozent | Viertelstunde |
PublicGrid:co2_intensity |
CO₂-Intensität | g/kWh | Viertelstunde |
Kraftstoffe und Heizöl
Abschnitt betitelt „Kraftstoffe und Heizöl“Die Preise sind Landesdurchschnitte, alle Steuern sind enthalten. Sie zeigen, was ein Jahr Fahren oder Heizen kostet, aber nicht, wo das Tanken heute am günstigsten ist.
Für Benzin meldet das Bulletin nur einen einzigen Preis, den für Super mit 95 Oktan. In Deutschland gibt es davon zwei Sorten: Super E5 mit bis zu 5 Prozent Ethanol und das meist günstigere Super E10 mit bis zu 10 Prozent. Der Wert für Deutschland entspricht dem Preis für E5. Wer E10 tankt, zahlt weniger, am 14. September 2026 etwa 9 Cent je Liter. Der Vergleich mit dem fiktiven Verbrenner rechnet deshalb mit dem etwas teureren E5.
Meldet ein Land ein Produkt nicht, bekommt dieses Produkt für die Woche keinen Wert.
Der Preis ist der Durchschnitt, den Haushalte je kWh zahlen, inklusive aller Steuern und Abgaben. Eurostat ermittelt ihn für einen Jahresverbrauch von 5.556 bis 55.556 kWh, das passt zu einem Einfamilienhaus. Die Grundgebühr ist auf die kWh umgelegt und darf nicht noch einmal dazugerechnet werden.
Eurostat misst den Preis nur halbjährlich und veröffentlicht ihn etwa sechs Monate später. Für die Monate danach schreibt der Collector den Preis mit dem monatlichen Preisindex für Erdgas fort. Diese Werte sind Schätzungen. Sobald Eurostat ein neues Halbjahr veröffentlicht, ersetzt dessen Messwert die geschätzten Monate. Auswertungen der letzten Monate können sich dadurch noch ändern.
Der Day-Ahead-Preis ist das Ergebnis der täglichen Auktion an der Strombörse für den Folgetag. Netzentgelte, Abgaben und Steuern sind nicht enthalten. Bis zum 30. September 2025 gab es einen Preis je Stunde, die Historie hat bis dahin deshalb einen Wert je Stunde. Die Preise des Tibber-Collectors sind etwas anderes: Sie enthalten alle Bestandteile des Tibber-Tarifs und landen im Measurement Prices. Beide Collectoren können nebeneinander laufen.
Der Anteil erneuerbarer Energien bezieht sich auf den Stromverbrauch des Landes. Die Werte reichen bis zum Ende des Folgetags, die künftigen sind eine Prognose des Fraunhofer ISE. Über 100 Prozent sind kein Fehler: Dann erzeugen Wind und Sonne mehr, als das Land gerade verbraucht.
Die CO₂-Intensität gibt an, wie viel Gramm CO₂ eine kWh Strom in Deutschland verursacht hat. Energy-Charts liefert diesen Wert nicht. Der Collector berechnet ihn aus der Erzeugung je Kraftwerkstyp und den Emissionsfaktoren des Umweltbundesamts. Er existiert nur für Deutschland, und der neueste Wert ist etwa zwei Stunden alt.
Zeitplan
Abschnitt betitelt „Zeitplan“Beim Start liest der Collector jede eingeschaltete Quelle. Danach liest er die Stromwerte alle INTERVAL Sekunden. Kraftstoff- und Gaspreise ändern sich höchstens einmal pro Woche. Sie kommen deshalb freitags um 6:00 Uhr in der Zeitzone aus TZ.
Bei den Kraftstoffpreisen schreibt jeder Abruf die letzten acht Wochen neu. Korrigiert die Europäische Kommission eine ältere Woche, kommt die Korrektur mit dem nächsten Start.
Historie
Abschnitt betitelt „Historie“Beim ersten Start schreibt der Collector auch die vergangenen Werte, und zwar ab dem Zeitpunkt, an dem die übrigen Daten im Bucket beginnen. Ältere Werte würden die InfluxDB mehr Speicher kosten und hätten nichts, womit sie sich vergleichen ließen. Für Deutschland reichen die Kraftstoffpreise bis 2005 zurück, der Gaspreis bis 2007. Bei den Stromwerten beginnen Anteil und CO₂-Intensität 2015, der Day-Ahead-Preis 2018.
Wo die Daten beginnen, liest der Collector beim Start aus der InfluxDB. Dazu braucht der Token Leserecht, siehe INFLUX_TOKEN. Ohne Leserecht schreibt er nur die neuesten Werte.
Kommen später ältere Messwerte in den Bucket, etwa über den CSV-Importer, füllt ein Neustart des Collectors die Historie bis dorthin auf. In HELIOS lässt er sich dazu unter Dienste stoppen und wieder starten.
Die Historie der Stromwerte ist groß. Beginnen die Daten 2020, lädt der erste Start mit ENABLE_PUBLIC_GRID=true etwa 260 MB herunter und braucht einige Minuten. Spätere Starts holen nur die fehlenden Tage.
Einrichtung mit HELIOS
Abschnitt betitelt „Einrichtung mit HELIOS“HELIOS richtet den Collector selbst ein, eine Eingabemaske gibt es nicht. Er läuft, sobald alle drei Bedingungen erfüllt sind:
- Das Dashboard steht unter Konfiguration → Einstellungen → Software-Stand auf dem Kanal Develop, denn nur dort gibt es Version 1.4.
- Unter Konfiguration → Sensoren ist der Kilometerstand eines Fahrzeugs zugeordnet.
- Die Zeitzone unter Konfiguration → Einstellungen → Grundeinstellungen gehört zu einem Mitgliedstaat der EU. Aus ihr leitet HELIOS das Land ab.
HELIOS schaltet nur die Kraftstoffpreise ein. Gaspreis und Stromwerte bleiben aus, denn das Dashboard nutzt sie noch nicht.
Logging
Abschnitt betitelt „Logging“Der Collector schreibt ein Protokoll ins Docker-Log, das im Normalfall so aussieht:
Public-data collector for SOLECTRUS, Version v0.1.1, built at 2026-11-19T09:12:25.971Zhttps://github.com/solectrus/public-data-collectorCopyright (c) 2026 Georg Ledermann, released under the MIT License
Using Ruby 4.0.10 on platform aarch64-linux-muslPushing to InfluxDB at http://influxdb:8086, bucket solectrusReading at start, then on Friday at 06:00: fuel prices for DE from EU Weekly Oil Bulletin => Fuel:price_petrol, Fuel:price_diesel, Fuel:price_heating_oil, Fuel:price_lpg
Wait until InfluxDB is ready ... OK
The other data in the bucket begins on Sat 2022-01-01 at 00:00:00, so the history starts there.
Cycle #1 at 2026-11-19 10:56:31 +0100 EU Weekly Oil Bulletin ✓ fuel prices for DE: 257 weeks, latest 2026-11-16: petrol 2.03, diesel 2.215 EUR/l (from 2021-12-20) Next cycle on Fri 2026-11-20 at 06:00:00Je Quelle steht dort eine Zeile mit ✓ oder ✗. Hat eine Quelle keinen Wert für das Land oder antwortet sie nicht, zeigt die Zeile mit ✗ den Grund. Die übrigen Quellen laufen weiter. Der Collector versucht es später erneut, nach jedem weiteren Fehler in größerem Abstand.
Antwortet die InfluxDB beim Start nicht innerhalb einer Minute, bricht der Collector ab, und Docker startet ihn neu. Scheitert später ein Schreibzugriff, versucht er es bis zu fünfmal. Gelingt auch das nicht, schreibt der nächste Abruf dieselben Werte erneut.
Quelltext
Abschnitt betitelt „Quelltext“Der Public-Data-Collector ist in Ruby implementiert, der Quelltext ist auf GitHub verfügbar:
github.com/solectrus/public-data-collector