Lokales Dashboard für Neoom Solaranlagen mit Prometheus

GitHub Neoom

In der heutigen Zeit, in der Energie-Monitoring und Smart-Home-Systeme immer wichtiger werden, ist der direkte Zugriff auf die Daten der eigenen Solaranlage ein entscheidender Faktor. Viele Cloud-basierte Lösungen bieten oft nur begrenzte Möglichkeiten zur Datenanalyse und -visualisierung. Mit unserem Open-Source Neoom Beaam Exporter für Prometheus ermöglichen wir es Ihnen, die volle Kontrolle über Ihre Anlagendaten zu erhalten – lokal, sicher und in Echtzeit.

In diesem Beitrag führen wir Sie durch die komplette Installation und Einrichtung des Exporters. Am Ende werden Sie ein voll funktionsfähiges Grafana-Dashboard haben, das Ihnen detaillierte Einblicke in Ihre Neoom-Solaranlage gibt.

Warum ein lokaler Prometheus-Exporter?

Die Vorteile eines eigenen, lokalen Monitoringsystems sind vielfältig:

• Datenhoheit: Alle Ihre wertvollen Energiedaten bleiben in Ihrem lokalen Netzwerk. Es gibt keine Abhängigkeit von Cloud-Diensten Dritter, und Ihre Privatsphäre bleibt gewahrt.
• Echtzeit-Daten: Sie können die Abfrageintervalle selbst bestimmen und erhalten so hochauflösende Daten ohne Verzögerung.
• Flexibilität und Anpassbarkeit: Mit der Kombination aus Prometheus und Grafana können Sie Dashboards, Alarme und Benachrichtigungen exakt nach Ihren Wünschen gestalten.
• Integration: Binden Sie die Daten Ihrer Solaranlage nahtlos in Ihr bestehendes Smart-Home-System (z.B. Home Assistant) ein und schaffen Sie intelligente Automatisierungen.
• Kosteneffizient: Die gesamte Lösung ist Open Source und kann auf kostengünstiger Hardware wie einem Raspberry Pi betrieben werden.

Was wird benötigt? (Voraussetzungen)

Bevor wir starten, stellen Sie sicher, dass Sie die folgenden Dinge zur Hand haben:

1. Docker: Eine laufende Docker-Umgebung ist erforderlich. Falls Sie Docker noch nicht installiert haben, finden Sie hier eine Anleitung.
2. Neoom BEAAM Anlage: Sie benötigen eine Solaranlage, die mit dem Neoom BEAAM Energiemanagementsystem ausgestattet ist.
3. API-Zugangsdaten: Sie benötigen die lokale IP-Adresse Ihres BEAAM-Systems sowie ein gültiges API-Token für den Zugriff. Diese erhalten Sie üblicherweise von Ihrem Installateur oder dem Neoom-Support.

Schritt 1: Installation und Konfiguration des Exporters

Wir haben den Exporter als Docker-Image verpackt, um die Installation so einfach wie möglich zu gestalten. Sie haben zwei Möglichkeiten, den Container zu starten.

Umgebungsvariablen

Der Exporter wird über die folgenden Umgebungsvariablen konfiguriert:

• BEAAM_API_URL: Die URL Ihrer Beaam-API (z. B. http://172.26.3.61)
• BEAAM_API_TOKEN: Ihr Authentifizierungstoken für die Beaam-API
• PORT: (Optional) Der Port, auf dem der Exporter lauschen soll (Standard: 3000)
• DEBUG: (Optional) Auf true setzen, um detailliertes Debug-Logging zu aktivieren

Option A: Docker Run (Der schnelle Weg)

Für einen schnellen Start können Sie den Exporter mit einem einzigen Docker-Befehl ausführen. Ersetzen Sie die Platzhalter mit Ihren eigenen Daten.

docker run -d \
  --name neoom-beaam-exporter \
  -p 3000:3000 \
  -e BEAAM_API_URL="http://IHRE-BEAAM-IP" \
  -e BEAAM_API_TOKEN="IHR-API-TOKEN" \
  --restart unless-stopped \
  ghcr.io/b-it-projects-gmbh/neoom-beaam-exporter:main
Copy

Option B: Docker Compose (Die empfohlene Methode)

Für eine bessere Verwaltung, insbesondere wenn Sie mehrere Container betreiben, empfehlen wir die Verwendung von Docker Compose. Erstellen Sie eine Datei namens docker-compose.yml mit folgendem Inhalt:

version: '3'
services:
  neoom-beaam-exporter:
    image: ghcr.io/b-it-projects-gmbh/neoom-beaam-exporter:main
    container_name: neoom-beaam-exporter
    ports:
      - "3000:3000"
    environment:
      - BEAAM_API_URL=http://IHRE-BEAAM-IP
      - BEAAM_API_TOKEN=IHR-API-TOKEN
    restart: unless-stopped
Copy

Starten Sie den Container anschließend mit dem Befehl docker-compose up -d im selben Verzeichnis.

Nach wenigen Sekunden sollte der Exporter laufen. Sie können die Metriken überprüfen, indem Sie http://<Ihre-Docker-Host-IP>:3000/metrics im Browser öffnen. Sie sollten eine lange Liste von Metriken im Prometheus-Format sehen.

Schritt 2: Prometheus einrichten

Nun müssen wir Prometheus anweisen, die Daten von unserem neuen Exporter abzurufen. Fügen Sie dazu den folgenden "Job" zu Ihrer Prometheus-Konfigurationsdatei (prometheus.yml) hinzu:

scrape_configs:
  - job_name: 'neoom-beaam'
    static_configs:
      - targets: ['<Ihre-Docker-Host-IP>:3000']
Copy

Wenn Prometheus und der Exporter auf demselben Host im selben Docker-Netzwerk laufen, können Sie auch den Container-Namen (neoom-beaam-exporter:3000) als Ziel verwenden. Starten Sie Prometheus neu, damit die Änderungen wirksam werden.

Schritt 3: Das Grafana Dashboard importieren

Der letzte Schritt ist die Visualisierung der Daten. Wir haben ein fertiges Grafana-Dashboard vorbereitet, das die wichtigsten Kennzahlen Ihrer Anlage anzeigt.

1. Laden Sie die Dashboard-Datei grafana-dashboard.json aus unserem GitHub-Repository herunter.
2. Öffnen Sie Ihr Grafana-Dashboard.
3. Navigieren Sie zu Dashboards → Import.
4. Kopieren Sie den Inhalt der heruntergeladenen JSON-Datei in das Textfeld.
5. Wählen Sie Ihre Prometheus-Datenquelle aus und klicken Sie auf "Import".

Das Dashboard zeigt Ihnen nun unter anderem:

• Echtzeit-Leistungsflüsse (Produktion, Verbrauch, Netz, Speicher)
• Autarkiegrad und Eigenverbrauchsquote
• Ladezustand der Batterie
• Spannungen und Leistungen pro Phase
• Historische Verlaufsdaten

Fazit

Herzlichen Glückwunsch! Sie haben erfolgreich ein lokales Monitoring-System für Ihre Neoom-Solaranlage eingerichtet. Sie haben nun die volle Kontrolle über Ihre Daten und können Ihr Energiemanagement auf das nächste Level heben.

Wir freuen uns über Feedback und Beiträge zur Weiterentwicklung des Projekts. Besuchen Sie uns auf GitHub und werden Sie Teil der Community.

• Neoom Beaam Exporter auf GitHub
• Neoom für Entwickler