Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- software:controller:vzlogger:overview_en [2021/01/11 18:17] – Port 8081 jau
+++ software:controller:vzlogger:overview_en [2022/04/21 20:09] (aktuell) – draw even with german version jau
@@ Zeile 3: / Zeile 3: @@
 **vzlogger**...
   * 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.
 ===== Features =====
   * evaluates middleware return code
-  * buffering readings in case of:
+  * buffering readings to RAM in case of:
     * network timeout
     * invalid middleware return code/exception or misconfiguration
@@ Zeile 51: / Zeile 51: @@
 ===== 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.
@@ Zeile 80: / Zeile 80: @@
 ^long^short| | |
 |%%--%%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-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)|
 |%%--%%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 =====