Documentation, fix config flag for logging

boswatch/router/routerManager.py

@@ -118,7 +118,7 @@ class RouterManager:
             else:
                 logging.warning("unknown router: %s", routerName)
 
-        if self.config.get('server.logging', False):
+        if self.config.get("server", "logging", default=False):
             self._saveStats()  # write stats to stats file
 
     def cleanup(self):

config/server.yaml

@@ -11,7 +11,7 @@ server:
   port: 8080
   name: BW3 Server        # name of the BW3 Server instance
   useBroadcast: no        # serve server ip on broadcast request
-  log: false              # enable log file
+  logging: False          # enable log file
 
 alarmRouter:
 - Router 1

docu/docs/config.md

@@ -157,7 +157,7 @@ decoder:
 ```
 
 ---
-## Server
+<h2 id="server-configuration">Server</h2>
 Nachfolgend alle Paramater der Server Konfiguration
 
 ### `server:`
@@ -166,6 +166,7 @@ Nachfolgend alle Paramater der Server Konfiguration
 |port|Port auf dem der Server lauscht| 8080  
 |name|Name zur Identifizierung der Server Instanz||
 |useBroadcast|Verbindungsdaten per Broadcast Server bereitstellen|no|
+|logging|Aktivieren / Deaktivieren des Schreibens von Statistik-Dateien|False|
 
 ---
 ### `alarmRouter:`
@@ -215,3 +216,16 @@ router:
 ## Module/Plugins
 
 Die möglichen Einstellungen der einzelnen Module und Plugins sind im jeweiligen Kapitel aufgelistet.
+
+---
+## Logging
+
+Um den Datenträger, auf dem Boswatch läuft, zu schützen ist das Logging in
+Dateien standartmäßig auf Fehlermeldungen begrenzt.
+In den Dateien `logger_client.ini` bzw `logger_server.ini` kann dies
+entsprechend im Bereich `handler_file` unter `level=` angepasst werden.
+
+Das Schreiben einer Statistik-Datei, welche die Durchläufe aller Module
+und Plugins dokumentiert, kann in der Server-Konfiguration über den Parameter
+`logging` aktiviert werden.
+(siehe [Server-Konfiguration](#server-configuration))