Benutzer-Werkzeuge

Webseiten-Werkzeuge


software:controller:vzlogger

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
software:controller:vzlogger [2021/01/11 18:17] – Port 8081 jausoftware: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 auch [[https://www.mysmartgrid.de/|MySmartGrid]] und [[https://en.wikipedia.org/wiki/InfluxDB|InfluxDB]] +  * unterstützt auch [[https://www.mysmartgrid.de/|MySmartGrid]] und [[https://en.wikipedia.org/wiki/InfluxDB|InfluxDB]] 
-  * kann als daemon im Hintergrund arbeiten oder per cron aufgerufen werden.+  * läuft als daemon im Hintergrund
   * 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 =====
 +<note>Die Standardkonfiguration ist nicht funktional, die ''meter'' sind alle deaktiviert</note>
 Die Konfiguration erfolgt über eine Datei die nach JSON kodierte Einstellungen enthält. Überlicherweise zu finden unter ''/etc/vzlogger.conf''. Einige grundlegende Parameter lassen sich auch über [[#Kommandozeilenparameter|Kommandozeile]] bestimmen. Die Konfiguration erfolgt über eine Datei die nach JSON kodierte Einstellungen enthält. Überlicherweise zu finden unter ''/etc/vzlogger.conf''. Einige grundlegende Parameter lassen sich auch über [[#Kommandozeilenparameter|Kommandozeile]] bestimmen.
 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|/etc/vzlogger.conf|Konfigurationsdatei| |%%--%%config|-c|/etc/vzlogger.conf|Konfigurationsdatei|
-|%%--%%log|-o|/var/log/vzlogger.log|Logfile+|%%--%%log|-o|/var/log/vzlogger/vzlogger.log|Logfile|
-|%%--%%daemon|-d|//off//|im Hintergrund ausführen|+
 |%%--httpd%%|-l|//off//|lokales Interface aktivieren (kleiner httpd für Echtzeitwerte)| |%%--httpd%%|-l|//off//|lokales Interface aktivieren (kleiner httpd für Echtzeitwerte)|
 |%%--httpd-port%%|-p|8081|TCP-Port des httpd| |%%--httpd-port%%|-p|8081|TCP-Port des httpd|
Zeile 94: Zeile 93:
 |%%--%%verbose|-v//level//|0|tiefe der Ausgabe erhöhen (0-15; 0 = log_alert, 1 = log_error, 3 = log-warning, 5 = log_info, 10 = log-debug, 15 = log_finest)| |%%--%%verbose|-v//level//|0|tiefe der Ausgabe erhöhen (0-15; 0 = log_alert, 1 = log_error, 3 = log-warning, 5 = log_info, 10 = log-debug, 15 = log_finest)|
 |%%--%%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 ''systemctl status vzlogger'' in der Form: ''Main process exited, code=exited, status=1/FAILURE''
 +^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.1610385421.txt.gz · Zuletzt geändert: 2021/01/11 18:17 von jau