wiki.volkszaehler.org

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Zuletzt angesehen:
software:controller:vzlogger:conf_parameter

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
Letzte ÜberarbeitungBeide Seiten der Revision
software:controller:vzlogger:conf_parameter [2017/03/19 11:52] – log bei S0 jausoftware:controller:vzlogger:conf_parameter [2017/11/04 14:25] – interner link zum Push-Server jau
Zeile 2: Zeile 2:
 Eine Beschreibung der Konfigurationsdatei von [[software:controller:vzlogger|vzlogger]], der Übersichtlichkeit halber in Abschnitte aufgeteilt.\\ Eine Beschreibung der Konfigurationsdatei von [[software:controller:vzlogger|vzlogger]], der Übersichtlichkeit halber in Abschnitte aufgeteilt.\\
  
-Formatiert ist sie nach [[https://de.wikipedia.org/wiki/JavaScript_Object_Notation|JSON]]; kompakt, manuell lesbar und einfach zu parsen. Entgegen dem Standard unterstützt vzlogger auch Kommentare /*...*/ oder %%//%% innerhalb der Konfigurationsdatei.\\ +Formatiert ist sie nach [[https://de.wikipedia.org/wiki/JavaScript_Object_Notation|JSON]]; kompakt, manuell lesbar und einfach zu parsen. Entgegen dem Standard unterstützt vzlogger auch Kommentare **/*...*/** oder **%%//%%** innerhalb der Konfigurationsdatei.\\ 
-Korrekte Kommata und Klammerung ist zwingend. Der [[http://volkszaehler.github.io/vzlogger/|JSON-Editor]] hilft dabei. Er bietet auch eine meter- und channel-Vorauswahl und blendet dann Schlüssel aus die nicht benötigt werden.\\+Korrekte Kommata und Klammerung ist zwingend. Der [[http://volkszaehler.github.io/vzlogger/|vzlogger.conf-Editor]] hilft dabei. Er bietet auch eine meter- und channel-Vorauswahl und blendet dann Schlüssel aus die nicht benötigt werden.\\
 Zeichenketten (String) müssen in Klammern gesetzt werden, Ganzzahlen (Integer) und Logische Ausdrücke (Bool) dürfen nicht. Gruppen **{}** und Schlüssel dürfen in root nur einmalig verwendet werden, in Arrays **[]** aber mehrmals.\\ Zeichenketten (String) müssen in Klammern gesetzt werden, Ganzzahlen (Integer) und Logische Ausdrücke (Bool) dürfen nicht. Gruppen **{}** und Schlüssel dürfen in root nur einmalig verwendet werden, in Arrays **[]** aber mehrmals.\\
  
Zeile 14: Zeile 14:
   "daemon": true,   "daemon": true,
   "verbosity": 0,   "verbosity": 0,
-  "log": "/tmp/vzlogger.conf",+  "log": "/var/log/vzlogger.conf",
 </code> </code>
  
Zeile 23: Zeile 23:
 ^ Empfehlung | 0 | ^ Empfehlung | 0 |
  
-=== deamon === +=== daemon === 
-Verschiebt vzlogger als Dienst (deamon) in den Hintergrund.+Betreibt vzlogger als Dienst (daemon) in den Hintergrund.
 ^ Typ | Bool | ^ Typ | Bool |
 ^ Wert | true/false | ^ Wert | true/false |
Zeile 30: Zeile 30:
  
 === verbosity === === verbosity ===
-Auführlichkeit des Fehlerlogs.+Ausführlichkeit des Fehlerlogs.
 ^ Typ | Integer | ^ Typ | Integer |
 ^ Wert | 0 = Alarme | ^ Wert | 0 = Alarme |
Zeile 40: Zeile 40:
 ^ Empfehlung | 15 zu Beginn | ^ Empfehlung | 15 zu Beginn |
 ^ ::: | 0 wenn alles fehlerfrei läuft | ^ ::: | 0 wenn alles fehlerfrei läuft |
 +
   
 === log === === log ===
Zeile 46: Zeile 47:
 ^ Wert | Muss eine vorhandenes Verzeichnis sein auf dem schreibender Zugriff erlaubt ist. | ^ Wert | Muss eine vorhandenes Verzeichnis sein auf dem schreibender Zugriff erlaubt ist. |
 ^ Empfehlung | "/var/log/vzlogger.log" im Regelfall | ^ Empfehlung | "/var/log/vzlogger.log" im Regelfall |
-^ ::: | "" wenn S0-Impulse in schneller Folge geloggt werden da Schreibzugriffe auf SD-Karte das loggen stören können. |+^ ::: | "" wenn S0-Impulse in schneller Folge geloggt werden da Schreibzugriffe auf SD-Karte das loggen stören können |
  
 ---- ----
    
 ====== push ====== ====== push ======
-Konfiguration des [[https://de.wikipedia.org/wiki/Push-Pull-Strategie|Push]]-Dienstes.\\ +Empfangsort des VZ-[[https://de.wikipedia.org/wiki/Push-Pull-Strategie|Push]]-Servers.\\ 
-Damit ist es möglich Daten an die VZ-Middleware zu schicken die zwar dargestellt, aber nicht gespeichert werden sollen.+Über den Dienst ist es zum Beispiel möglich Daten an die VZ-Middleware zu schicken die zwar dargestellt, aber nicht gespeichert werden sollen. Es muss parallel dazu der [[software/middleware/push-server|Push-Server der Middleware]] aktiviert werden.
 <code> <code>
   "push": [   "push": [
     {     {
-      "url": "http://localhost/push/data.json"+      "url": ""http://127.0.0.1:5582""
     }     }
 </code> </code>
Zeile 68: Zeile 69:
 ^ Typ | String | ^ Typ | String |
 ^ Wert | eine gültige URL | ^ Wert | eine gültige URL |
-^ Empfehlung | http://localhost/push/data.json für VZ |+^ Empfehlung | "http://127.0.0.1:5582" für VZ |
  
 ---- ----
Zeile 74: Zeile 75:
 ====== local ====== ====== local ======
 HTTP-Dienst (httpd) für Daten-[[https://de.wikipedia.org/wiki/Push-Pull-Strategie|Pull]]. HTTP-Dienst (httpd) für Daten-[[https://de.wikipedia.org/wiki/Push-Pull-Strategie|Pull]].
-Stellt die Daten der konfigurierten //meter// zu manuellen Kontrolle oder für andere Anwendungen bereit. Erspart einem z.B einen das Parsen des SML-Telegramms von einem eHz.+Stellt die Daten der konfigurierten //meter// zu manuellen Kontrolle oder für andere Anwendungen bereit. Erspart einem z.B das Parsen des SML-Telegramms von einem eHz.
 <code> <code>
   "local": {   "local": {
Zeile 101: Zeile 102:
  
 === index === === index ===
-Normal sollte die Anfrage die UUID des gewünschten channel enthalten, wird der Index aktiviert werden alle //channel// dargestellt.+Normal sollte die Anfrage die UUID des gewünschten //channel// enthalten, wird der Index aktiviert werden alle //channel// dargestellt.
 ^ Typ | Bool | ^ Typ | Bool |
 ^ Wert | true/false | ^ Wert | true/false |
Zeile 113: Zeile 114:
  
 === buffer === === buffer ===
-?+? Größe des Ringspeichers ?
 ^ Typ | Integer | ^ Typ | Integer |
 ^ Wert | 0-? | ^ Wert | 0-? |
Zeile 176: Zeile 177:
           "api": "volkszaehler",           "api": "volkszaehler",
           "middleware": "http://localhost/middleware.php",           "middleware": "http://localhost/middleware.php",
 +          "host": "127.0.0.1",
           "secretKey": "",           "secretKey": "",
           "type": "device",           "type": "device",
Zeile 196: Zeile 198:
 ^ //protocol// ^ Wert ^ Hinweise ^ //protocol// ^ Wert ^ Hinweise
 | //s0// | "Impulse" oder "Impulse_neg" | für Impulse | | //s0// | "Impulse" oder "Impulse_neg" | für Impulse |
-| //s0// | "Power" oder "Power_neg" | dabei werden die Impulse auf Basis von //resolution// in Leistung umgerechnet |+| //s0// | "Power" oder "Power_neg" | dabei werden die Impulse auf Basis der //resolution// von Arbeit (kWh) in Leistung (W) umgerechnet |
 | //d0// |z.B. "1-0:1.8.0" | [[software:obis|OBIS-Codes]] | | //d0// |z.B. "1-0:1.8.0" | [[software:obis|OBIS-Codes]] |
 | //sml// |z.B. "1-0:1.8.0" | [[software:obis|OBIS-Codes]] | | //sml// |z.B. "1-0:1.8.0" | [[software:obis|OBIS-Codes]] |
Zeile 213: Zeile 215:
 ^ Wert | "volkszaehler" für die VZ-Middleware | ^ Wert | "volkszaehler" für die VZ-Middleware |
 ^ ::: | "mysmartgrid" vzlogger kann auch [[https://www.mysmartgrid.de|mySmartGrid]] mit Daten beliefern | ^ ::: | "mysmartgrid" vzlogger kann auch [[https://www.mysmartgrid.de|mySmartGrid]] mit Daten beliefern |
-^ ::: | "none" wenn die Werte nur über den integrierte //httpd// bereitgestellt werden sollen |+^ ::: | "influxdb" vzlogger kann auch [[https://en.wikipedia.org/wiki/InfluxDB|InfluxDB]] mit Daten beliefern | 
 +^ ::: | "null" wenn die Werte nur über den integrierten //httpd// oder //push// bereitgestellt werden sollen |
 ^ Empfehlung | "volkszaehler" | ^ Empfehlung | "volkszaehler" |
  
Zeile 222: Zeile 225:
 ^ ::: | z.B. "https://demo.volkszaehler.org/middleware.php" für den VZ Demo Server | ^ ::: | z.B. "https://demo.volkszaehler.org/middleware.php" für den VZ Demo Server |
 ^ Empfehlung | "http://localhost/middleware.php" | ^ Empfehlung | "http://localhost/middleware.php" |
 +
 +=== host ===
 +Die [[https://de.wikipedia.org/wiki/Uniform_Resource_Locator|URL]] über welche die InfluxDB //api// zu erreichen ist.
 +^ Typ | String |
 +^ Wert | z.B. "127.0.0.1" für eine  InfluxDB auf der selben Maschine |
 +^ Empfehlung | "127.0.0.1" |
 +
 +<note>Für InfluxDB gibt es eine Reihe weiterer, optionaler Parameter. Siehe dazu den [[http://volkszaehler.github.io/vzlogger/|vzlogger.conf-Editor]] oder die [[https://github.com/volkszaehler/vzlogger/blob/master/etc/vzlogger.conf.InfluxDB|Beipielkonfguration im Git]]</note>
  
 === secretKey === === secretKey ===
Zeile 244: Zeile 255:
 Mathematische Art der Aggregation die der vzlogger vornehmen soll. Nur wirksam in Verbindung mit //aggtime// größer als 0. Mathematische Art der Aggregation die der vzlogger vornehmen soll. Nur wirksam in Verbindung mit //aggtime// größer als 0.
 ^ Typ | String | ^ Typ | String |
-^ Wert | "avg" Durchschnitt, zu verwenden bei Aktualwerte wie Strom, Spannung oder Temperatur |+^ Wert | "avg" Durchschnitt, zu verwenden bei Aktualwerten wie Strom, Spannung oder Temperatur |
 ^ ::: | "max" Maximal, zu verwenden bei Zählerständen | ^ ::: | "max" Maximal, zu verwenden bei Zählerständen |
 ^ ::: | "sum" Summe, zu verwenden bei Impulsen | ^ ::: | "sum" Summe, zu verwenden bei Impulsen |
Zeile 444: Zeile 455:
       "pullseq": "",       "pullseq": "",
       "baudrate": 9600,       "baudrate": 9600,
-      "parity": "8n1"+      "parity": "8n1", 
 +      "use_local_time": false
 </code> </code>
  
Zeile 480: Zeile 492:
 ^ Empfehlung | "8n1" | ^ Empfehlung | "8n1" |
  
 +=== use_local_time ===
 +Nutzt zur Erstellung des Timestamp die aktuelle Uhrzeit des Rechners statt des Zählers.\\
 +Wenn ein Zähler im Datenstrom eine Uhrzeit mitliefert wird diese verwendet um Zeitverschiebungen durch FiFo-Puffer auszuschließen. Es sind allerdings Zähler im Umlauf bei denen vergessen wurde die Zeit bei Inbetriebnahme einzustellen, in diesen Fällen sollte der vzlogger die lokale Rechnerzeit verwenden.
 +^ Typ | Bool |
 +^ Wert | true/false |
 +^ Empfehlung | false |
 ---- ----
 ==== random ==== ==== random ====
software/controller/vzlogger/conf_parameter.txt · Zuletzt geändert: 2017/12/14 23:03 von jau