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.
Umgebungsvariablen
Abschnitt betitelt „Umgebungsvariablen“COUNTRY
Abschnitt betitelt „COUNTRY“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.
COUNTRY=DEENABLE_FUEL
Abschnitt betitelt „ENABLE_FUEL“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.
ENABLE_FUEL=trueENABLE_GAS
Abschnitt betitelt „ENABLE_GAS“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.
ENABLE_GAS=trueENABLE_PUBLIC_GRID
Abschnitt betitelt „ENABLE_PUBLIC_GRID“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.
ENABLE_PUBLIC_GRID=trueBIDDING_ZONE
Abschnitt betitelt „BIDDING_ZONE“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.
BIDDING_ZONE=SE3INTERVAL
Abschnitt betitelt „INTERVAL“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.
INTERVAL=900INFLUX_HOST
Abschnitt betitelt „INFLUX_HOST“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.
INFLUX_HOST=influxdbINFLUX_SCHEMA
Abschnitt betitelt „INFLUX_SCHEMA“Schema für die Verbindung zu InfluxDB, http oder https. Standardwert ist http. Bei einer externen InfluxDB mit TLS gehört hier https hin.
INFLUX_SCHEMA=httpsINFLUX_PORT
Abschnitt betitelt „INFLUX_PORT“Port für die Verbindung zu InfluxDB, eine Ganzzahl. Standardwert ist 8086. Bei einer externen, per TLS abgesicherten InfluxDB ist es oft 443.
INFLUX_PORT=443INFLUX_TOKEN
Abschnitt betitelt „INFLUX_TOKEN“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.
INFLUX_TOKEN=my-super-secret-readwrite-tokenINFLUX_ORG
Abschnitt betitelt „INFLUX_ORG“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.
INFLUX_ORG=solectrusINFLUX_BUCKET
Abschnitt betitelt „INFLUX_BUCKET“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.
INFLUX_BUCKET=solectrusZeitzone 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.
TZ=Europe/Berlin