ViEventLog Tool für das Ereignissprotokoll / VICARE Dashboard Ersatz

[mschneider82]

Da mir das Ereignisprotokoll mit das Wichtigste am ViGuide war, habe ich mithilfe AI ein Open-Source-Tool entwickelt, das die Events über die Viessmann Developer API wieder zugänglich macht.

ViEventLog ist ein lokaler Webserver mit Timeline-Visualisierung, der zeigt wann eure Anlage heizt, Warmwasser bereitet und wie häufig sie taktet - Informationen die Viessmann
selbst nicht anzeigt. 

Installation: Binary herunterladen, entpacken, starten und im Browser http://localhost:5000 öffnen.

https://github.com/mschneider82/vieventlog

Hinweis: Ihr benötigt eine eigene Client-ID aus dem Viessmann Developer Portal. Anleitung steht in der README.

Feedback und Bugs bitte über die GitHub Issues melden.

viel spaß euch, ich freu mich auf eure Testberichte! Man kann auch mehrere Accounts hinzufügen (da Viessman ein 2 Anlagen limit pro account hat), endlich kann ich damit alle event logs meiner 3 anlagen sehen ohne immer den viguide zugang wechseln zu müssen. 

NEU: jetzt auch mit DASHBOARD und Einstellmöglichkeiten um div. settings zu ändern!

[TuXHeat]

Hallo,

gibt es auch ein Binary für opensuse leap 15.6/16.0?

[mschneider82]

Hast du denn die binarys unter Suse probiert? Ansonsten steht noch docker zur Verfügung, aber normal sollten die binarys funktionieren, da sie statisch verlinkt sind.

[Neuetherme]

Hallo Herr Schneider,

vielen Dank für die Antwort!

Ich tue mich allerdins etwas schwer mit den ganzen Begriffen: BInary und was lade ich herunter und GitHUb Issues...

Viele Grüße!

[millih2g]

Neue Funktionen

1. Zusätzliches Panel "LZ/Tag
   zeigt die durchschnittliche Laufzeit pro Tag im (Kalender-) Monat oder (Kalender-) Jahr oder im Wirtschaftsjahr (12 Monatszeitraum ab Datum "Beginn Wirtschaftsjahr) --> unterste Zeile

Diese Kennziffer hilft bei der Einschätzung der Wirtschaftlichkeit der Wärmepumpe im Zusammenwirken mit dem "durchschnittlichen Stromverbrauch pro Tag" (KWh / Tag) und der Visualisierung der Kompressorstarts. Die beiden Kennziffern dienen außerdem der Vergleichbarkeit innerhalb eines (Kalender-)Jahres sowie zwischen verschiedenen (Kalender-)Jahren. Sie bilden zudem wichtige Kenngrößen bei der Planung des Stromverbrauchs der Wärmepumpe.

2. Auswahl "Wirtschaftsjahr" zusätzlich zu Monat/Jahr - Wechsel folgender Panels in die 12-Monatsbetrachtung ab "Beginn Wirtschaftsjahr mit Wirkung für

• Monats-Arbeitszahl (wir zur Jahresarbeitszahl Wirtschaftsjahr - entspricht damit dem Panel JAZ Wirtschaftsjahr
• KW/h pro Tag
• Tage ohne Laufzeit
• Leistungsaufnahme
• Wärmeleistung

Soweit das Tagesdatum vor dem Ende des 12-Monats-Wirtschaftsjahr liegt, werden die Daten in der Ansicht "Wirtschaftsjahr" nur bis zum Tagesdatum gerechnet.

Damit werden die wichtigsten Statistikwerte auch bei einem vom Kalenderjahr abweichenden Wirtschaftsjahr (12-Monats-Zeitraum) unmittelbar angezeigt. Im Zusammenspiel Tagesdatum und "Beginn Wirtschaftsjahr lassen sich zudem Zeitraum-bezogene Auswertungen generieren.

3. Layout-Anpassung an zusätzliches Panel

Das Bild zeigt das Dashboard in der Timeline von gestern (Grafana: Auswahl "Yersterday") im aktuell ausgeschalteten Zustand in der Ansicht "Wirtschaftsjahr" (ab 16.12.2025)

Anmerkung

Inhaltlich ist das Alternative Dashboard für meine Bedürfnisse damit grundsätzlich aus-entwickelt. Aufgrund der Grafana-Plattform, kann sich jeder Nutzer darauf aufbauend sein individuelles Dashboard zusammenstellen. Es wäre sehr nett, wenn alternative Entwürfe hier für alle Community-Mitglieder veröffentlicht würden.

[millih2g]

Das Dashboard kann man unter 

https://github.com/hrsnsvh2pd-png/Alternatives-Dashboard/releases

herunterladen. Es läuft unter der kostenlosen OpenSource-Software Grafana OSS, einem Produkt von Grafana Labs, lizenziert unter der GNU Affero General Public License v3.0 (AGPLv3).

Der vollständige Quellcode von Grafana ist verfügbar unter: 

https://github.com/grafana/grafana.

Die Lizenzbedingungen sind einsehbar unter: https://www.gnu.org/licenses/agpl-3.0.txt

Dieses Dashboard nutzt Grafana unverändert, sodass eine private Nutzung ohne Offenlegungspflichten möglich ist. Jeder Benutzer muss eine eigene Grafana-Instanz herunterladen und installieren.

Das für die Anbindung der viessmann_events-Datenbank erforderliche SQLite-Plugin ist Bestandteil der Grafana-Standard-Distribution und verursacht keine zusätzlichen Lizenzanforderungen.

vieventlog Das Dashboard greift auf die Datei viessmann_events.db zu, die durch die Software vieventlog erzeugt und fortgeschrieben wird.

vieventlog ist ein Open-Source-Projekt von Matthias Schneider. Ein besonderer Dank gilt ihm für die Entwicklung und Bereitstellung dieses Projekts für die Community.

Der vollständige Quellcode ist verfügbar unter: 

https://github.com/mschneider82/vieventlog/releases

vieventlog ist unter der MIT-Lizenz lizenziert. Lizenzbedingungen: https://mit-license.org

Die in diesem Repository enthaltenen Grafana-Dashboard-JSON-Dateien stehen unter der Creative Commons Attribution 4.0 International (CC BY 4.0).

Die Lizenzbedingungen können hier abgerufen werden: 

https://creativecommons.org/licenses/by/4.0/legalcode

Dieses Dashboard ist ein eigenständiges Community-Projekt und steht in keiner offiziellen Verbindung zu vieventlog oder dessen Autor.

Für weitere Informationen und zur Unterstützung der Installation bitte unbedingt die README.md- Datei lesen.

[Neuetherme]

Wo bekomme ich ein solches Dashboard her? Mit welchem Programm komme ich zur Bedienung? 

Meine Therme ist bereit über wlan verbunden.

Danke und Grüße

[millih2g]

Lies mal bitte meinen 2. Post (direkt dahinter). Da steht alles drin (inkl. Link zum letzten Release). 

Hier nochmal der Link:

https://github.com/hrsnsvh2pd-png/Alternatives-Dashboard/releases

[millih2g]

@Neuetherme 

@Vielleicht zum besseren Verständnis nochmal die prinzipiell Installationsreihenfolge:

1. vieventlog herunterladen und installieren

—> Download —> siehe dort: https://github.com/mschneider82/vieventlog/releases

—> Installation —> siehe dort: https://github.com/mschneider82/vieventlog

      —> README.md- Datei lesen

2. In vieventlog Verbindung zur Datenbank herstellen und Datenbankzugriffe einstellen (

     —> Account-Verwaltung (README.md lesen)

     —> Einträge unter „Event-Archivierung“ und „Temperatur-Logging & Visualisierung“

3. Warten, ob Werte in die Datenbank geschrieben werden (Zähler in Accountverwaltung beobachten)

3. Grafana OSS (nur diese Version ist kostenlos) herunterladen und installieren 

    —> Download hier:  https://grafana.com/grafana/download?edition=oss

    —-> Installationsleitfaden hier: https://github.com/hrsnsvh2pd-png/Alternatives-Dashboard

           —> README.md lesen

4. Drei zusätzliche Views in der Viessmann_events.db (das ist vieventlog-Datenbank) erzeugen

    —> Tools hier:  https://github.com/hrsnsvh2pd-png/Alternatives-Dashboard

           README.md-Datei lesen

    —>  SQL-Statement hier https://github.com/hrsnsvh2pd-png/Alternatives-Dashboard

           README.md-Datei lesen 

5. JSON-Datei aus GitHub herunterladen

    —> Datei hier:  https://github.com/hrsnsvh2pd-png/Alternatives-Dashboard/releases

    —> Vorgehen hier:  https://github.com/hrsnsvh2pd-png/Alternatives-Dashboard

          README.md- Datei lesen

    —> Verbindung zu viessmann_events.db einrichten (neue Datasource anlegen

           —> Vorgehen hier:  https://github.com/hrsnsvh2pd-png/Alternatives-Dashboard

           README.md-Datei lesen

—-> jetzt öffnet sich das Dashboard noch ohne Werte

6. Im Dashboard die Variable „anlage_id“ einrichten (SQL-Statement eintragen)

    —> Vorgehen und Statement hier:  https://github.com/hrsnsvh2pd-png/Alternatives-Dashboard

          README-md-Datei lesen

—-> jetzt füllt sich das Dashboard mit vorhandenen Daten 

7. Read only- User anlegen 

    —> Vorgehen hier:  https://github.com/hrsnsvh2pd-png/Alternatives-Dashboard

          README-md-Datei lesen

Ich hoffe, ich habe nichts vergessen. Steht aber alles ausführlich in meiner README.md-Datei. 

[Neuetherme]

Vielen Dank! Ich habe mittlerweile festgestellt das meine elektronische Infrastruktur nicht geeignet ist, weil veraltetes Betriebsystem.

Ebenso mein Smartphone (Windows  7).

Gleich kommt der Techniker und zeigt mir Selbsthilfe.

Grüße

[millih2g]

Ok, verstehe. Ich darf Die aber sagen, dass es sich auf jeden Fall lohnt - mindestens vieventlog. Und wenn das läuft, ist das Dashboard auch nicht mehr weit weg.

Ich helfe gerne - auch per PN. Es sind zwar einige Schritte bis zum Ziel, aber bei Weitem kein Hexenwerk.  Das kriegt man wirklich hin! Rühr Dich einfach, wenn Du magst bzw. soweit bist. 

[Neuetherme]

Das mache ich gerne! Der Installateur war heute hier und stand vor einem Rätsel, er kam auch nicht weiter als ich. Er wird mit VIessmann telefonieren...

Schönes Wochenende und Grüße!

[TuXHeat]

das Procedere scheitert bei mir schon bei dem Versuch, wie im README.md beschrieben, mich

hier https://app.developer.viessmann-climatesolutions.com

mit meinen VICare Zugangsdaten anmelde. Ich finde hier nichts, wo ich einen API Client erstellen könnte.

Es gibt: dashboard.user.greeting und darunter

- dashboard.user_information.card.title

- dashboard.api_clients.card.title (ist leer)

- dashboard.transaction-summary.card.title (nur zwei graue Felder die leer sind)

- dashboard.documentation.card.title

und oben rechts, kann ich auf meinen Account gehen und sehe darin meine Daten.

[mschneider82]

In "Your clients" musst du einen client anlegen, wie beschrieben, ggf bitte screenshot posten.

[PeterS64]

Hallo,

ich habe folgendes Problem und hoffe das mir hier einer helfen kann 😎

Ich habe ViEventLog auf meinem Raspberry Pi 4 über die grafische Oberfläche installiert und kann auch ViEventLog über Localhost5000 im Raspberry OS Browser aufrufen und auch über meinem Laptop und Mac mit http://<IP-Adresse>:5000

Es öffnet sich die Event-Seite und ich sehe die Timeline sowie die Events (Logs) unterhalb.

Aber wenn ich auf Dashboard klicke kommt eine Fehlermeldung mit „Fehler beim Laden der Daten: Gerät nicht gefunden: 0 @“ obwohl im Listfeld Installation die WP und Gastherme angezeigt werden.

Was läuft bei mir falsch bzw. was ist mein Problem und wie kann ich es lösen 🤷‍♂️

Danke für eure Unterstützung 😃

[TuXHeat]

nach etwas warten konnte ich das. Was muss bei Redirect URIs stehen

http://localhost:5000/ oder voreingestellt http://localhost:42000/ ?
Ich habe beides probiert, doch wenn ich dann im Browser http://localhost:5000/login starte und mich mit meinen ViCare Zugansdaten und der generierten Client-ID versuche anzumelden, erscheint:

✗ Fehler: Authentication failed: authentication failed: no redirect location in response (status 400): {"error":"invalid_request", "error_description":"Invalid redirection URI."}

was tun?

[mschneider82]

siehe https://github.com/mschneider82/vieventlog?tab=readme-ov-file#voraussetzungen

Da steht auch die redirect uri

[mschneider82]

hier wäre ggf das konsolen log von vieventlog hilfreich, Ich glaube manche haben auch schon durch neuanlage des client secrets das problem behoben.

[PeterS64]

Lieben Dank für das schnelle Feedback… aber kannst du das bitte etwas verständlicher für mich erklären 🫣 Ich bin ja schon stolz darauf das ich es bis hierhin geschafft habe 😎

Lieben Dank

[mschneider82]

wenn vieventlog läuft siehst du so ein schwarzes konsolenfenster bei dem vieventlog text ausgibt, dieser text ist ggf nützlich zur fehlersuche. (natürlich den fehler kurz nachstellen und dann schauen was im text steht)

[TuXHeat]

ok, hat geklappt und ich komme auch ins Portal.

Nun habe ich noch nach der Anleitung aus meinen Repo

grafana-11.5.10-150200.3.80.1.x86_64 installiert. Aus den README.md werde ich nicht recht schlau, was ich mit grafana machen soll. Und wie komme ich zur Viessmann_events.db um drei zusätzliche Views zu erzeugen.

[PeterS64]

was bzw. wo genau meinst du? 🤷‍

[TuXHeat]

na ich wollte die obige Anleitung durchlaufen. Im Moment sehe ich dies hier.

Kann ich da auch eine Art Historie mir als Diagramme anzeigen lassen und brauche ich da die oben erwähnten zusätzlichen Tools?

[mschneider82]

auf der startseite von vieventlog rechts oben die account verwaltung und die Archivierung aktivieren, dann hast du in zukunft die historie, sofern dein pc und vieventlog immer läuft.   

[TuXHeat]

Ich dachte ich kann die Daten aus der Viessmann Cloud beziehen, so wie mein Heizungsbauer. Der Rechner läuft natürlich nicht permanent und auch nicht vieventlog, das habe ich auch nicht vor. Schade, dachte das wäre einfacher.

[mschneider82]

Viessmann liefert keine Charts oder Daten über die Temperatur werte, nur die aktuellen werte, daher speichert vieventlog diese in einer lokalen Datenbank und muss natürlich immer laufen wenn du charts über die Temperaturwerte willst.