software:controller:vzlogger
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
software:controller:vzlogger [2020/07/21 13:02] – [APIs] typos boenki | software:controller:vzlogger [2022/06/17 08:15] (aktuell) – [vzlogger] typo boenki | ||
---|---|---|---|
Zeile 5: | Zeile 5: | ||
**vzlogger**... | **vzlogger**... | ||
* 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 | + | * unterstützt |
- | * 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 58: | Zeile 58: | ||
===== Konfiguration ===== | ===== Konfiguration ===== | ||
+ | < | ||
Die Konfiguration erfolgt über eine Datei die nach JSON kodierte Einstellungen enthält. Überlicherweise zu finden unter ''/ | 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 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.1595329330.txt.gz · Zuletzt geändert: 2020/07/21 13:02 von boenki