Konfiguration für Solcast

Diese Seite beschreibt die Umgebungsvariablen für den Anbieter Solcast. Sie beschränken sich auf den API-Key und die Site-IDs. Standort, Ausrichtung und Leistung der Anlage liegen im Solcast-Portal, nicht in der Konfiguration des Collectors.

Dazu kommen die allgemeinen Einstellungen, allen voran FORECAST_PROVIDER=solcast.

Vollständiges Beispiel

.env

# Anbieter
FORECAST_PROVIDER=solcast

# Zeitzone
TZ=Europe/Berlin

# Solcast-Zugangsdaten
SOLCAST_APIKEY=my-solcast-api-key

# Dachflächen (Site-IDs aus dem Solcast-Portal)
FORECAST_CONFIGURATIONS=2
SOLCAST_0_SITE=1111-1111-1111-1111
SOLCAST_1_SITE=2222-2222-2222-2222

# Abfrageintervall (zwei Dachflächen: 2 × 8640)
FORECAST_INTERVAL=17280

# InfluxDB
INFLUX_HOST=influxdb
INFLUX_SCHEMA=http
INFLUX_PORT=8086
INFLUX_TOKEN=my-super-secret-write-token
INFLUX_ORG=solectrus
INFLUX_BUCKET=solectrus
INFLUX_MEASUREMENT=Forecast

API-Zugang

SOLCAST_APIKEY

API-Key des Solcast-Kontos, im Solcast-Dashboard unter Your API key zu finden.

Ohne gültigen Key weist Solcast jede Abfrage ab. Der Collector läuft dann weiter, protokolliert aber Fehler, und im Dashboard bleibt die Prognosekurve leer.

Beispiel

SOLCAST_APIKEY=my-solcast-api-key

HELIOS

HELIOS fragt den API-Key unter Konfiguration → Datenquellen → Forecast-Collector ab.

Dachflächen

Eine Dachfläche entspricht bei Solcast einer Rooftop Site. Ihre ID steht im Solcast-Portal, die Anlagendaten dahinter ebenfalls. Der Collector kennt nur die ID.

FORECAST_CONFIGURATIONS

Anzahl der Dachflächen. Standardwert ist 1.

Für jede Dachfläche fragt der Collector Solcast einzeln ab und addiert die Prognosen. Steht hier eine zu kleine Zahl, bleiben die Site-IDs der übrigen Dachflächen unbeachtet — SOLCAST_1_SITE etwa wirkt erst ab FORECAST_CONFIGURATIONS=2.

Beispiel

FORECAST_CONFIGURATIONS=2

HELIOS

HELIOS fragt die Anzahl der Dachflächen unter Konfiguration → Datenquellen → Forecast-Collector ab, nimmt für Solcast aber höchstens zwei Site-IDs entgegen. Bei einer einzelnen Dachfläche lässt HELIOS die Variable weg. Der Collector selbst kennt keine Obergrenze, im kostenlosen Tarif setzt jedoch das Abfragelimit die Grenze.

SOLCAST_SITE

ID der Dachfläche bei Solcast, im Format xxxx-xxxx-xxxx-xxxx. Der Wert gilt für jede Dachfläche, die keine eigene SOLCAST_X_SITE hat. Bei einer einzelnen Dachfläche ist er damit Pflicht.

Beispiel

SOLCAST_SITE=1111-1111-1111-1111

HELIOS

HELIOS fragt die Ressourcen-ID unter Konfiguration → Datenquellen → Forecast-Collector ab und setzt die Variable immer.

SOLCAST_X_SITE

ID der Dachfläche X, gezählt ab 0, im Format xxxx-xxxx-xxxx-xxxx. Pflicht, sobald mehr als eine Dachfläche konfiguriert ist.

Fehlt eine der indizierten Variablen, greift SOLCAST_SITE. Der Collector fragt dann still dieselbe Site zweimal ab und zählt ihre Prognose doppelt.

Beispiel

SOLCAST_0_SITE=1111-1111-1111-1111
SOLCAST_1_SITE=2222-2222-2222-2222

HELIOS

HELIOS setzt SOLCAST_0_SITE und SOLCAST_1_SITE, sobald zwei Dachflächen eingetragen sind.

Abfrageintervall

FORECAST_INTERVAL

Abstand zwischen zwei Abfragen in Sekunden, eine positive Ganzzahl. Fehlt die Variable oder steht dort keine positive Zahl, bricht der Collector beim Start ab.

Solcast erlaubt im kostenlosen Tarif 10 Abfragen pro Tag, also frühestens alle 8640 Sekunden. Der Collector fragt jede Dachfläche einzeln ab, das Limit teilt sich also auf: Bei zwei Dachflächen sind mindestens 17280 Sekunden nötig.

Beispiel

FORECAST_INTERVAL=17280

HELIOS

HELIOS fragt das Intervall unter Konfiguration → Datenquellen → Forecast-Collector ab. Bleibt das Feld leer, setzt HELIOS 900 — für den kostenlosen Solcast-Tarif viel zu wenig.