software:controller:vzlogger
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision | ||
software:controller:vzlogger [2019/01/24 21:22] – [Identifier] link obis-codes cweiske | software:controller:vzlogger [2022/04/21 20:09] – Tabellenheader jau | ||
---|---|---|---|
Zeile 6: | Zeile 6: | ||
* ist ein Werkzeug zum Lesen der Messwerte von Sensoren und Smartmeter um sie an die volkszahler.org Middleware weiterzureichen | * ist ein Werkzeug zum Lesen der Messwerte von Sensoren und Smartmeter um sie an die volkszahler.org Middleware weiterzureichen | ||
* unterstütz auch [[https:// | * unterstütz auch [[https:// | ||
- | * kann als daemon im Hintergrund | + | * läuft |
* enthält einen kleinen eingebauten httpd um Echtzeitwerte als AJAX-Frontend bereitzustellen | * enthält einen kleinen eingebauten httpd um Echtzeitwerte als AJAX-Frontend bereitzustellen | ||
* liefert die Daten auch über einen zweiten, zusätzlichen Push-Kanal aus. | * liefert die Daten auch über einen zweiten, zusätzlichen Push-Kanal aus. | ||
Zeile 12: | Zeile 12: | ||
===== Features ===== | ===== Features ===== | ||
* wertet den Return Code der Middleware aus | * wertet den Return Code der Middleware aus | ||
- | * puffert die Werte in Falle von: | + | * puffert die Werte (im RAM) im Falle von: |
* Netzwerktimeout | * Netzwerktimeout | ||
* ungültigem Middleware Return Code, Fehlern oder Fehlkonfigurationen | * ungültigem Middleware Return Code, Fehlern oder Fehlkonfigurationen | ||
Zeile 53: | Zeile 53: | ||
===== APIs ===== | ===== APIs ===== | ||
- | Vzlogger ist in der Lage die erfassten Daten an verschiedene Endsysteme, zur weitere | + | Vzlogger ist in der Lage die erfassten Daten an verschiedene Endsysteme, zur weiteren |
Vzloggers Standard-Endsystem ist die Middleware eines volkszaehler. Weitere Endsysteme sind MySmartGrid, | Vzloggers Standard-Endsystem ist die Middleware eines volkszaehler. Weitere Endsysteme sind MySmartGrid, | ||
===== Konfiguration ===== | ===== Konfiguration ===== | ||
- | + | < | |
- | Die Konfiguration erfolgt über eine Datei die nach JSON kodierte Einstellungen enthält. Einige grundlegende Parameter lassen sich auch über [[# | + | Die Konfiguration erfolgt über eine Datei die nach JSON kodierte Einstellungen enthält. Überlicherweise zu finden unter ''/ |
Es sind ein oder mehr meter in der Konfiguration erforderlich. Channels sind optional. Ein meter kann mehrere channel enthalten und damit auch mehrere Middlewares bedienen. | Es sind ein oder mehr meter in der Konfiguration erforderlich. Channels sind optional. Ein meter kann mehrere channel enthalten und damit auch mehrere Middlewares bedienen. | ||
Zeile 65: | Zeile 65: | ||
Die einzelnen Parameter sind hier im Wiki nochmal in deutsch beschrieben: | Die einzelnen Parameter sind hier im Wiki nochmal in deutsch beschrieben: | ||
- | Konfigurationen diverser Nutzer finden sich im Bereich [[// | + | Konfigurationen diverser Nutzer finden sich im Bereich [[// |
Als Unterstützung bei der Syntax dient der [[http:// | Als Unterstützung bei der Syntax dient der [[http:// | ||
Zeile 87: | Zeile 87: | ||
^lang^kurz| | | | ^lang^kurz| | | | ||
|%%--%%config|-c|/ | |%%--%%config|-c|/ | ||
- | |%%--%%log|-o|/ | + | |%%--%%log|-o|/ |
- | |%%--%%daemon|-d|// | + | |
|%%--httpd%%|-l|// | |%%--httpd%%|-l|// | ||
- | |%%--httpd-port%%|-p|8080|TCP-Port des httpd| | + | |%%--httpd-port%%|-p|8081|TCP-Port des httpd| |
|%%--%%help|-h| |Kurzhilfe| | |%%--%%help|-h| |Kurzhilfe| | ||
|%%--%%verbose|-v// | |%%--%%verbose|-v// | ||
|%%--%%version|-V| |Version des vzlogger ausgeben| | |%%--%%version|-V| |Version des vzlogger ausgeben| | ||
+ | |||
+ | ===== Exit-Codes ===== | ||
+ | Da vzlogger als Hintergrunddienst konzipiert ist wird primär über das Logfile diagnostiziert. In Fällen bei denen dies nicht möglich ist werden Standard Exit-Codes ausgegeben.\\ | ||
+ | Z.B. bei Aufruf von '' | ||
+ | ^Code^Text^Bedeutung^ | ||
+ | |1|FAILURE|generischer Fehler, dieser tritt auch auf wenn die Konfiguration unlogisch ist und vzlogger ohne definierte Aufgaben (Beispielconfig im git) beendet wird| | ||
+ | |64|USAGE|Kommandozeilenargument war nicht ausführbar| | ||
+ | |71|OSERR|die Verschiebung in den Hintergrund (daemon) schlug fehl| | ||
+ | |73|CANTCREAT|vzlogger hat nicht die nötigen Rechte das Logfile an der konfigurierten Stelle zu schreiben| | ||
+ | |78|CONFIG|Syntaxfehler in der Konfiguration oder Datei nicht vorhanden| | ||
===== Links ===== | ===== Links ===== |
software/controller/vzlogger.txt · Zuletzt geändert: 2024/05/12 19:30 von jau