wiki.volkszaehler.org

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Zuletzt angesehen:
software:controller:vzlogger:overview_en

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
software:controller:vzlogger:overview_en [2021/01/11 18:17] – Port 8081 jausoftware:controller:vzlogger:overview_en [2022/04/21 20:09] (aktuell) – draw even with german version jau
Zeile 3: Zeile 3:
 **vzlogger**... **vzlogger**...
   * is a tool to read and log measurements of a wide variety of smartmeters and sensors to the volkszaehler.org middleware.   * is a tool to read and log measurements of a wide variety of smartmeters and sensors to the volkszaehler.org middleware.
-  * can run as a daemon in background or via cron.+  * runs as a daemon in background.
   * includes a tiny onboard HTTPd to serve realtime readings to the AJAX web frontend.   * includes a tiny onboard HTTPd to serve realtime readings to the AJAX web frontend.
  
 ===== Features ===== ===== Features =====
   * evaluates middleware return code   * evaluates middleware return code
-  * buffering readings in case of: +  * buffering readings to RAM in case of: 
     * network timeout     * network timeout
     * invalid middleware return code/exception or misconfiguration     * invalid middleware return code/exception or misconfiguration
Zeile 51: Zeile 51:
  
 ===== Configuration ===== ===== Configuration =====
 +<note>Example configuration is not runable, all the ''meter'' are deactivated</note>
 The vzlogger configuration is done with a file containing JSON encoded settings. General settings also can be set via the [[#command_line_parameters|command line]]. You must have at least one meter in your configuration. Channels are optional. A meter can have more channels. Ex. if you want to log to multiple middleware servers. The vzlogger configuration is done with a file containing JSON encoded settings. General settings also can be set via the [[#command_line_parameters|command line]]. You must have at least one meter in your configuration. Channels are optional. A meter can have more channels. Ex. if you want to log to multiple middleware servers.
  
Zeile 80: Zeile 80:
 ^long^short| | | ^long^short| | |
 |%%--%%config|-c|/etc/vzlogger.conf|configuration file| |%%--%%config|-c|/etc/vzlogger.conf|configuration file|
-|%%--%%log|-o|/var/log/vzlogger.log|log file| +|%%--%%log|-o|/var/log/vzlogger/vzlogger.log|log file|
-|%%--%%daemon|-d|//off//|run in background|+
 |%%--httpd%%|-l|//off//|activate local interface (tiny HTTPd which serves live readings)| |%%--httpd%%|-l|//off//|activate local interface (tiny HTTPd which serves live readings)|
 |%%--httpd-port%%|-p|8081|TCP port for HTTPd| |%%--httpd-port%%|-p|8081|TCP port for HTTPd|
Zeile 87: Zeile 86:
 |%%--%%verbose|-v//level//|0|enable verbose output (0-15; 0 = log_alert, 1 = log_error, 3 = log-warning, 5 = log_info, 10 = log-debug, 15 = log_finest)| |%%--%%verbose|-v//level//|0|enable verbose output (0-15; 0 = log_alert, 1 = log_error, 3 = log-warning, 5 = log_info, 10 = log-debug, 15 = log_finest)|
 |%%--%%version|-V| |show version of vzlogger| |%%--%%version|-V| |show version of vzlogger|
 +
 +===== Exit-Codes =====
 +For diagnostics usally the logfile is used because of vzlogger running under control of systemd. In cases this is not possible exit-codes will be shown.\\
 +E.g. calling ''systemctl status vzlogger'' shows something like: ''Main process exited, code=exited, status=1/FAILURE''
 +^code^text^meaning^
 +|1|FAILURE|generic failure, is also generated by unfeasible configuration when vzlogger is closed because of no active meters (example config from git)|
 +|64|USAGE|cli argument is bad|
 +|71|OSERR|moving service to background (daemon) didn't work out|
 +|73|CANTCREAT|vzlogger lacks the rights to write logfile|
 +|78|CONFIG|brocken syntax in config-file|
  
 ===== Links ===== ===== Links =====
software/controller/vzlogger/overview_en.txt · Zuletzt geändert: 2022/04/21 20:09 von jau