# Konfiguration des Public-Data-Collectors

> Die Umgebungsvariablen des Public-Data-Collectors: Land, Schalter für die drei Quellen, Intervall und die Verbindung zur InfluxDB.

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](/docs/referenz/public-data-collector/#einrichtung-mit-helios).

## Umgebungsvariablen

### `COUNTRY`<span class="badge required"></span>

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.

```properties title="Beispiel"
COUNTRY=DE
```

> **HELIOS**
>
>
> HELIOS leitet das Land aus der Zeitzone unter _Konfiguration → Einstellungen → Grundeinstellungen_ ab, aus `Europe/Berlin` etwa `DE`. Einzustellen gibt es nichts.
>

### `ENABLE_FUEL`<span class="badge optional"></span>

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.

```properties title="Beispiel"
ENABLE_FUEL=true
```

> **HELIOS**
>
>
> HELIOS setzt den Schalter immer auf `true`, denn das Dashboard vergleicht mit den Kraftstoffpreisen ein E-Auto mit einem fiktiven Verbrenner. Einzustellen gibt es nichts.
>

### `ENABLE_GAS`<span class="badge optional"></span>

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.

```properties title="Beispiel"
ENABLE_GAS=true
```

> **HELIOS**
>
>
> HELIOS setzt den Schalter nicht, er bleibt beim Standardwert `false`. Einschalten lässt er sich nicht, denn das Dashboard nutzt den Gaspreis noch nicht.
>

### `ENABLE_PUBLIC_GRID`<span class="badge optional"></span>

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`](#interval) Sekunden abgefragt, die beiden anderen nur einmal pro Woche. Beim ersten Start lädt sie außerdem eine große [Historie](/docs/referenz/public-data-collector/#historie) herunter.

```properties title="Beispiel"
ENABLE_PUBLIC_GRID=true
```

> **HELIOS**
>
>
> HELIOS setzt den Schalter nicht, er bleibt beim Standardwert `false`. Einschalten lässt er sich nicht, denn das Dashboard nutzt die Stromwerte noch nicht.
>

### `BIDDING_ZONE`<span class="badge optional"></span>

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`](#country). Die gültigen Codes stehen in der [API von Energy-Charts](https://api.energy-charts.info/v2) beim Parameter `bzn` von `/v2/price`. Ohne `ENABLE_PUBLIC_GRID` liest der Collector die Variable nicht.

```properties title="Beispiel"
BIDDING_ZONE=SE3
```

> **HELIOS**
>
>
> HELIOS setzt die Gebotszone nicht. Sie ist auch nicht nötig, denn HELIOS schaltet die Stromwerte nicht ein.
>

### `INTERVAL`<span class="badge optional"></span>

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`.

```properties title="Beispiel"
INTERVAL=900
```

> **HELIOS**
>
>
> HELIOS setzt das Intervall nicht, es bleibt beim Standardwert `3600`. Ohne die Stromwerte hat es ohnehin keine Wirkung.
>

### `INFLUX_HOST`<span class="badge required"></span>

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`.

```properties title="Beispiel"
INFLUX_HOST=influxdb
```

> **HELIOS**
>
>
> HELIOS setzt den Hostnamen automatisch auf `influxdb`. Der Collector schreibt immer direkt in die InfluxDB, auch bei aktivem [Ingest-Dienst](/docs/referenz/ingest/), denn die Preise haben mit dem Hausverbrauch nichts zu tun.
>

### `INFLUX_SCHEMA`<span class="badge optional"></span>

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

```properties title="Beispiel"
INFLUX_SCHEMA=https
```

> **HELIOS**
>
>
> HELIOS setzt `http`, denn innerhalb des Docker-Netzwerks wird nicht verschlüsselt.
>

### `INFLUX_PORT`<span class="badge optional"></span>

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

```properties title="Beispiel"
INFLUX_PORT=443
```

> **HELIOS**
>
>
> HELIOS setzt den Port automatisch auf `8086`. Einzustellen gibt es nichts.
>

### `INFLUX_TOKEN`<span class="badge required"></span>

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](/docs/referenz/public-data-collector/#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.

```properties title="Beispiel"
INFLUX_TOKEN=my-super-secret-readwrite-token
```

> **HELIOS**
>
>
> HELIOS gibt dem Collector einen Token mit Lese- und Schreibrecht, siehe [`INFLUX_TOKEN_READWRITE`](/docs/referenz/helios/konfiguration/#influx_token_readwrite). Den reinen Schreib-Token der übrigen Kollektoren bekommt er nicht.
>

### `INFLUX_ORG`<span class="badge required"></span>

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](/docs/referenz/influxdb/konfiguration/) 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.

```properties title="Beispiel"
INFLUX_ORG=solectrus
```

> **HELIOS**
>
>
> HELIOS gibt `solectrus` vor, einzustellen gibt es nichts.
>

### `INFLUX_BUCKET`<span class="badge required"></span>

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](/docs/referenz/influxdb/konfiguration/) 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.

```properties title="Beispiel"
INFLUX_BUCKET=solectrus
```

> **HELIOS**
>
>
> HELIOS gibt `solectrus` vor, einzustellen gibt es nichts.
>

### `TZ`<span class="badge optional"></span>

Zeitzone gemäß [Liste](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). 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.

```properties title="Beispiel"
TZ=Europe/Berlin
```

> **HELIOS**
>
>
> HELIOS fragt die Zeitzone unter _Konfiguration → Einstellungen → Grundeinstellungen_ ab, vorbelegt mit `Europe/Berlin`. Aus ihr leitet HELIOS auch [`COUNTRY`](#country) ab.
>
