Zum Inhalt springen

Konfiguration des Public-Data-Collectors

Der Public-Data-Collector wird über Umgebungsvariablen konfiguriert.

HELIOS richtet ihn ohne eigene Eingabemaske ein. Unter welchen Bedingungen er läuft, steht in der Übersicht.

Land, für das der Collector die Preise und Werte holt, als zweistelliger Ländercode nach ISO 3166, etwa DE, AT oder NL. Groß- und Kleinschreibung spielt keine Rolle. Für Griechenland gilt neben GR auch EL, die Schreibweise der EU.

Ohne die Variable bricht der Collector beim Start ab. Hat eine Quelle keine Werte für das Land, protokolliert der Collector den Fehler bei dieser Quelle, die übrigen laufen weiter. Kraftstoffpreise gibt es nur für die Mitgliedstaaten der EU, die CO₂-Intensität nur für Deutschland.

Beispiel
COUNTRY=DE

Schaltet die Preise für Benzin, Diesel, Autogas und Heizöl aus dem Weekly Oil Bulletin ein. Erlaubt sind true und false. Standardwert ist false.

Mindestens einer der drei Schalter ENABLE_FUEL, ENABLE_GAS und ENABLE_PUBLIC_GRID muss true sein, sonst bricht der Collector beim Start ab. Das gilt auch für einen anderen Wert als true oder false, damit ein Tippfehler die Quelle nicht unbemerkt ausschaltet.

Beispiel
ENABLE_FUEL=true

Schaltet den Erdgaspreis von Eurostat ein. Erlaubt sind true und false. Standardwert ist false.

Mindestens einer der drei Schalter ENABLE_FUEL, ENABLE_GAS und ENABLE_PUBLIC_GRID muss true sein, sonst bricht der Collector beim Start ab. Ein anderer Wert als true oder false lässt ihn ebenfalls abbrechen.

Beispiel
ENABLE_GAS=true

Schaltet die Stromwerte von Energy-Charts ein: Day-Ahead-Preis, Anteil erneuerbarer Energien und CO₂-Intensität. Erlaubt sind true und false. Standardwert ist false.

Mindestens einer der drei Schalter ENABLE_FUEL, ENABLE_GAS und ENABLE_PUBLIC_GRID muss true sein, sonst bricht der Collector beim Start ab. Ein anderer Wert als true oder false lässt ihn ebenfalls abbrechen.

Diese Quelle wird alle INTERVAL Sekunden abgefragt, die beiden anderen nur einmal pro Woche. Beim ersten Start lädt sie außerdem eine große Historie herunter.

Beispiel
ENABLE_PUBLIC_GRID=true

Gebotszone für den Day-Ahead-Preis. Eine Gebotszone ist ein Gebiet mit einem gemeinsamen Strompreis an der Börse, Deutschland bildet etwa mit Luxemburg die Zone DE-LU. Pflicht ist die Variable nur, wenn ENABLE_PUBLIC_GRID=true gesetzt ist und das Land mehrere Gebotszonen hat: Dänemark (DK1, DK2), Italien, Norwegen (NO1 bis NO5) und Schweden (SE1 bis SE4).

Fehlt sie dort, bricht der Collector beim Start ab. Für alle anderen Länder ermittelt er die Zone selbst aus COUNTRY. Die gültigen Codes stehen in der API von Energy-Charts beim Parameter bzn von /v2/price. Ohne ENABLE_PUBLIC_GRID liest der Collector die Variable nicht.

Beispiel
BIDDING_ZONE=SE3

Abstand in Sekunden, in dem der Collector die Stromwerte von Energy-Charts liest. Erlaubt ist eine Ganzzahl. Standardwert ist 3600, also eine Stunde.

Kraftstoff- und Gaspreise betrifft das Intervall nicht, sie kommen immer freitags um 6:00 Uhr. Ist ENABLE_PUBLIC_GRID=true gesetzt, muss der Wert mindestens 60 sein, sonst bricht der Collector beim Start ab. Ein nicht numerischer Wert zählt dabei als 0.

Beispiel
INTERVAL=900

Hostname des InfluxDB-Servers. Läuft InfluxDB im selben Docker-Netzwerk, ist das der Name des Docker-Services, also influxdb. Es kann aber auch ein externer Server sein, etwa influxdb.example.com.

Beispiel
INFLUX_HOST=influxdb

Schema für die Verbindung zu InfluxDB, http oder https. Standardwert ist http. Bei einer externen InfluxDB mit TLS gehört hier https hin.

Beispiel
INFLUX_SCHEMA=https

Port für die Verbindung zu InfluxDB, eine Ganzzahl. Standardwert ist 8086. Bei einer externen, per TLS abgesicherten InfluxDB ist es oft 443.

Beispiel
INFLUX_PORT=443

Token, mit dem sich der Collector bei InfluxDB anmeldet. Er muss dort existieren und das Recht haben, den angegebenen Bucket zu lesen und in ihn zu schreiben. Gelesen wird nur einmal beim Start: Der Collector ermittelt, wo die übrigen Daten im Bucket beginnen, und schreibt die Historie ab diesem Zeitpunkt.

Fehlt das Leserecht, schreibt der Collector nur die neuesten Werte und meldet das im Protokoll. Fehlt das Schreibrecht, landen gar keine Werte in der Datenbank.

Beispiel
INFLUX_TOKEN=my-super-secret-readwrite-token

Organisation in InfluxDB, unter der die Werte gespeichert werden. Eine Organisation ist der Mandant, dem Benutzer, Buckets und Tokens gehören. InfluxDB legt sie beim ersten Start an. In einer SOLECTRUS-Installation heißt sie solectrus.

Der Name muss zu der Organisation passen, die in InfluxDB tatsächlich existiert. Ein anderer Wert benennt sie nicht um, er lässt den Collector nur ins Leere schreiben.

Beispiel
INFLUX_ORG=solectrus

Bucket in InfluxDB, in den der Collector die Werte schreibt. Ein Bucket ist das, was anderswo die Datenbank wäre: ein benannter Speicher mit eigener Aufbewahrungsdauer. Auch ihn legt InfluxDB beim ersten Start an. Eine SOLECTRUS-Installation kommt mit einem einzigen aus, er heißt solectrus.

Aus demselben Bucket liest der Collector, wo die übrigen Daten beginnen. Gibt es den Bucket nicht, lehnt InfluxDB die Zugriffe ab. Ist er leer, schreibt der Collector keine Historie, sondern nur die neuesten Werte.

Beispiel
INFLUX_BUCKET=solectrus

Zeitzone gemäß Liste. Standardwert ist UTC.

Sie legt fest, wann „freitags um 6:00 Uhr“ ist, der Zeitpunkt für Kraftstoff- und Gaspreise. Außerdem bestimmt sie die Zeitstempel im Protokoll. Die Werte selbst speichert InfluxDB immer in UTC.

Beispiel
TZ=Europe/Berlin