InfluxDBLogger - Versionsgeschichte

Ph1959de: Sichtung / Überarbeitung der letzten Änderungen

2021-11-29T09:33:45Z

Sichtung / Überarbeitung der letzten Änderungen

← Nächstältere Version		Version vom 29. November 2021, 11:33 Uhr
Zeile 15:		Zeile 15:
	Ein Interface oder eine Möglichkeit, die Daten mittels SVG-Plots darzustellen ist derzeit nicht vorhanden. Alternativ können die Daten mittels [[Grafana]] analysiert und visualisiert werden.		Ein Interface oder eine Möglichkeit, die Daten mittels SVG-Plots darzustellen ist derzeit nicht vorhanden. Alternativ können die Daten mittels [[Grafana]] analysiert und visualisiert werden.

	~~== Allgemein ==~~
	{{Randnotiz\|RNTyp=y\|RNText='''Alternativmodul'''		{{Randnotiz\|RNTyp=y\|RNText='''Alternativmodul'''
	Um Missverständnisse zu vermeiden, sei an dieser Stelle darauf hingewiesen, dass es bereits ein anderes Modul mit den Namen [[InfluxDBLog\|93_InfluxDBLog]] für die Anbindung an eine InfluxDB gibt, das zu diesem Zeitpunkt (11/2021) allerdings nicht weiterentwickelt zu werden scheint und um das es in diesem Artikel definitiv nicht geht.		Um Missverständnisse zu vermeiden, sei an dieser Stelle darauf hingewiesen, dass es bereits ein anderes Modul mit den Namen [[InfluxDBLog\|93_InfluxDBLog]] für die Anbindung an eine InfluxDB gibt, das zu diesem Zeitpunkt (11/2021) allerdings nicht weiterentwickelt zu werden scheint und um das es in diesem Artikel definitiv nicht geht.

	Siehe dazu auch hier: {{Link2Forum\|Topic=71551\|Message=896556\|LinkText=~~Forumsbeitrag~~}}, {{Link2Forum\|Topic=71551\|Message=1071675\|LinkText=~~Forumsbeitrag~~}}, {{Link2Forum\|Topic=71551\|Message=1090783\|LinkText=~~Forumsbeitrag~~}}		Siehe dazu auch hier:
			* {{Link2Forum\|Topic=71551\|Message=896556\|LinkText=Freigabe zum Fork}}
			* {{Link2Forum\|Topic=71551\|Message=1071675\|LinkText=Wartungsstatus}}
			* {{Link2Forum\|Topic=71551\|Message=1090783\|LinkText=Start "InfluxDBLogger}}

	Für die Beschreibung der Einrichtung als native Installation in Verbindung mit einer InfluxDB 1.x sei auf [https://waschto.eu/2018/11/02/fhem-und-grafana-tool-zum-visualisieren-von-messdaten/ ~~diesen Artikel~~] verwiesen. }}		Für die Beschreibung der Einrichtung als native Installation in Verbindung mit einer InfluxDB 1.x sei auf die (externe) Seite [https://waschto.eu/2018/11/02/fhem-und-grafana-tool-zum-visualisieren-von-messdaten/ "FHEM und Grafana"] verwiesen. }}
			== Allgemein ==
	Im Folgenden wird auf die Einrichtung unter Docker (inkl. Docker-Compose) mit einer InfluxDB 2.0 eingegangen.		Im Folgenden wird auf die Einrichtung unter Docker (inkl. Docker-Compose) mit einer InfluxDB 2.0 eingegangen.

Zeile 68:		Zeile 71:
	</syntaxhighlight>		</syntaxhighlight>

	Die Definition des oben genannten Containers "fhem2" ist für die Einrichtung der Datenbank nicht notwendig und ist an dieser Stelle nur der Vollständigkeit halber mit aufgeführt. FHEM kann auch separat installiert sein, es bietet sich aber in diesem Beispiel an, gleich ~~mit~~ in das Docker-Compose-File mit aufgenommen zu werden.		Die Definition des oben genannten Containers "fhem2" ist für die Einrichtung der Datenbank nicht notwendig und ist an dieser Stelle nur der Vollständigkeit halber mit aufgeführt. FHEM kann auch separat installiert sein, es bietet sich aber in diesem Beispiel an, gleich in das Docker-Compose-File mit aufgenommen zu werden.

	An dieser Stelle sei empfohlen, die Zugangsinformationen in eine .env Datei auszulagern, die zugriffsbeschränkt im gleichen Verzeichnis liegt, wie die <code>docker-compose.yml</code> Datei.		An dieser Stelle sei empfohlen, die Zugangsinformationen in eine .env Datei auszulagern, die zugriffsbeschränkt im gleichen Verzeichnis liegt, wie die <code>docker-compose.yml</code> Datei.
Zeile 125:		Zeile 128:

	=== Einschränkung über den zentralen <code>define</code>-Eintrag ===		=== Einschränkung über den zentralen <code>define</code>-Eintrag ===
	Verweis auf die commandref {{Link2CmdRef\|Lang=de\|Anker=InfluxDBLogger\|Label=InfluxDBLogger}} bzgl. der Attribute <code>readingInclude</code> und <code>readingInclude</code> bzw. ein Link ins Forum zu einem ~~Beispiel für dessen Verwendung (~~{{Link2Forum\|Topic=114860\|Message=1119696\|LinkText=~~Forum~~}}).		Verweis auf die commandref {{Link2CmdRef\|Lang=de\|Anker=InfluxDBLogger\|Label=InfluxDBLogger}} bzgl. der Attribute <code>readingInclude</code> und <code>readingInclude</code> bzw. ein Link ins Forum zu einem {{Link2Forum\|Topic=114860\|Message=1119696\|LinkText=Beispiel für dessen Verwendung}}.

	=== Loggen von Zuständen ===		=== Loggen von Zuständen ===
	Wie eingangs erwähnt, ist die Datenbank designt, numerische Werte zu loggen. Nichtnumerische Werte lassen sich nur über ~~dem~~ Umweg „tags“ in der Datenbank ablegen. ({{Link2Forum\|Topic=114860\|Message=1127469\|LinkText=~~Forum~~}})		Wie eingangs erwähnt, ist die Datenbank designt, numerische Werte zu loggen. Nichtnumerische Werte lassen sich nur über den Umweg „tags“ in der Datenbank ablegen (siehe dazu auch {{Link2Forum\|Topic=114860\|Message=1127469\|LinkText=Beitrag 1}} und {{Link2Forum\|Topic=114860\|Message=1131301\|LinkText=Beitrag 2}} im Forum).
	({{Link2Forum\|Topic=114860\|Message=1131301\|LinkText=~~Forum~~}})

	Sollen nun Zustände von z.B. Fenster- oder Türkontakten geloggt werden, kommt das Attribut <code> conversion </code> zum Einsatz. Mit ihm lassen sich Zustände entsprechend in Werte umwandeln.		Sollen nun Zustände von z.B. Fenster- oder Türkontakten geloggt werden, kommt das Attribut <code> conversion </code> zum Einsatz. Mit ihm lassen sich Zustände entsprechend in Werte umwandeln.

	Die jeweiligen Umwandelungen werden kommagetrennt aufgezählt. Mehrere Werte können durch ein pipe getrennt aufgezählt werden. Die Parameteraufzählung enthält dabei keine Leerzeichen.		Die jeweiligen Umwandelungen werden kommagetrennt aufgezählt. Mehrere Werte können durch ein pipe getrennt aufgezählt werden. Die Parameteraufzählung enthält dabei keine Leerzeichen.
	Conversions sind nicht case sensitive ({{Link2Forum\|Topic=114860\|Message=1122035\|LinkText=Forum}}).		Conversions sind nicht case sensitive ({{Link2Forum\|Topic=114860\|Message=1122035\|LinkText=Forum}}).
	Ein entsprechendes Beispiel für die Anwendung ~~befindet~~ sich in der commandref ~~{{Link2CmdRef\|Lang=de\|Anker=InfluxDBLogger\|Label=InfluxDBLogger}}~~.
			Ein entsprechendes Beispiel für die Anwendung findet sich in der commandref.

	=== Mehrere Logging-Devices ===		=== Mehrere Logging-Devices ===
	Um eine weitere Detaillierung des Loggings umzusetzen, bei unterschiedlicher Kombination von devspec, readingInclude, readingExclude, sowie der entsprechenden Limitierung der Events, sei an dieser Stelle ebenfalls darauf verwiesen, mehrere Definitionen des Moduls kombinieren zu können, z.B. 5 separate Logger, einer für Raumsensoren, einer für die Heizung, einer für Energiezähler, einer für das Wetter und ein weiterer für alles weitere Allgemeine.		Um eine weitere Detaillierung des Loggings umzusetzen, bei unterschiedlicher Kombination von devspec, readingInclude, readingExclude, sowie der entsprechenden Limitierung der Events, sei an dieser Stelle ebenfalls darauf verwiesen, mehrere Definitionen des Moduls kombinieren zu können, z.B. fünf separate Logger, einer für Raumsensoren, einer für die Heizung, einer für Energiezähler, einer für das Wetter und ein weiterer für alles weitere Allgemeine.

	=== Weiteres Feinetuning ===		=== Weiteres Feinetuning ===
	Ohne weitere Definition von Attributen werden die numerischen Daten mit <code>Site_name</code> und <code>value</code> in die Datenbank geschrieben. Dieses ist historisch bedingt, siehe ({{Link2Forum\|Topic=71551\|Message=1072372\|LinkText=~~Forum~~}}) und ({{Link2Forum\|Topic=114860\|Message=1090782\|LinkText=~~Forum~~}}).		Ohne weitere Definition von Attributen werden die numerischen Daten mit <code>Site_name</code> und <code>value</code> in die Datenbank geschrieben. Dieses ist historisch bedingt, siehe entsprechende Hinweise im Forum zum {{Link2Forum\|Topic=71551\|Message=1072372\|LinkText="alten" InfluxDBLog}} und im {{Link2Forum\|Topic=114860\|Message=1090782\|LinkText="neuen" InfluxDBLogger}}.

	Als nützlich Kombination hat sich beispielsweise die Definition folgender Attribute herausgestellt:		Als nützlich Kombination hat sich beispielsweise die Definition folgender Attribute herausgestellt:
Zeile 156:		Zeile 159:
	verwendet wird.		verwendet wird.

	Für alternative Verwendung der entsprechenden Attribute sei ebenfalls auf die ComandRef ~~{{Link2CmdRef\|Lang=de\|Anker=InfluxDBLogger\|Label=InfluxDBLogger}}~~ verwiesen.		Für alternative Verwendung der entsprechenden Attribute sei ebenfalls auf die ComandRef verwiesen.

	== Datenbank ==		== Datenbank ==
Zeile 171:		Zeile 174:
	=== Migration von Altdaten ===		=== Migration von Altdaten ===
	Zwei Hinweise ins Forum bzgl.		Zwei Hinweise ins Forum bzgl.
	* Scripte, um filelogs zu migrieren: ({{Link2Forum\|Topic=114860\|Message=1104495\|LinkText=~~Forum~~}}~~) oder (~~{{Link2Forum\|Topic=71551\|Message=732935\|LinkText=~~Forum~~}})		* Scripte, um filelogs zu migrieren:
	* Scripte, um Mysql Daten zu migrieren: ({{Link2Forum\|Topic=118049\|Message=1129622\|LinkText=~~Forum~~}}~~) oder (~~{{Link2Forum\|Topic=71551\|Message=838940\|LinkText=~~Forum~~}}~~) oder (~~{{Link2Forum\|Topic=71551\|Message=895012\|LinkText=~~Forum~~}}~~) oder (~~{{Link2Forum\|Topic=71551\|Message=895764\|LinkText=~~Forum~~}})		** {{Link2Forum\|Topic=114860\|Message=1104495\|LinkText=Beitrag von gvzdus}}
			** {{Link2Forum\|Topic=71551\|Message=732935\|LinkText=Beitrag von fervor}}
			* Scripte, um Mysql Daten zu migrieren:
			** {{Link2Forum\|Topic=118049\|Message=1129622\|LinkText=addlog (import.py)}}
			** {{Link2Forum\|Topic=71551\|Message=838940\|LinkText=Skripte von kadettilac89}}
			** {{Link2Forum\|Topic=71551\|Message=895012\|LinkText=Hinweis zur Anwendung der Skripte von kadettilac89}}
			** {{Link2Forum\|Topic=71551\|Message=895764\|LinkText=weitere Hinweis von kadettilac89}}

	=== Plot-Abrisse vermeiden ===		=== Plot-Abrisse vermeiden ===

Joshi04: Weitere Ergänzungen zur Komplettierung des Artikels

2021-11-28T20:15:37Z

Weitere Ergänzungen zur Komplettierung des Artikels

← Nächstältere Version		Version vom 28. November 2021, 22:15 Uhr
Zeile 1:		Zeile 1:
	~~{{Todo\|Dieser Artikel befindet sich im Aufbau und beschreibt daher anstatt einer kompletten Konfiguration bislang nur Teilabschnitte.}}~~
	{{Infobox Modul		{{Infobox Modul
	\|ModPurpose=Protokolliert Ereignisse in einer Datenbank		\|ModPurpose=Protokolliert Ereignisse in einer Datenbank
Zeile 16:		Zeile 15:
	Ein Interface oder eine Möglichkeit, die Daten mittels SVG-Plots darzustellen ist derzeit nicht vorhanden. Alternativ können die Daten mittels [[Grafana]] analysiert und visualisiert werden.		Ein Interface oder eine Möglichkeit, die Daten mittels SVG-Plots darzustellen ist derzeit nicht vorhanden. Alternativ können die Daten mittels [[Grafana]] analysiert und visualisiert werden.

	== ~~Konfiguration~~ ==		== Allgemein ==
	{{Randnotiz\|RNTyp=y\|RNText='''Alternativmodul'''		{{Randnotiz\|RNTyp=y\|RNText='''Alternativmodul'''
	Um Missverständnisse zu vermeiden sei, an dieser Stelle darauf hingewiesen, dass es bereits ein anderes Modul mit den Namen [[InfluxDBLog\|93_InfluxDBLog]] für die Anbindung an eine InfluxDB gibt, das zu diesem Zeitpunkt (11/2021) allerdings nicht weiterentwickelt zu werden scheint und um das es in diesem Artikel definitiv nicht geht. Siehe dazu auch ~~diesen~~ {{Link2Forum\|Topic=71551\|Message=1090783\|LinkText=Forumsbeitrag}}.		Um Missverständnisse zu vermeiden, sei an dieser Stelle darauf hingewiesen, dass es bereits ein anderes Modul mit den Namen [[InfluxDBLog\|93_InfluxDBLog]] für die Anbindung an eine InfluxDB gibt, das zu diesem Zeitpunkt (11/2021) allerdings nicht weiterentwickelt zu werden scheint und um das es in diesem Artikel definitiv nicht geht.

			Siehe dazu auch hier: {{Link2Forum\|Topic=71551\|Message=896556\|LinkText=Forumsbeitrag}}, {{Link2Forum\|Topic=71551\|Message=1071675\|LinkText=Forumsbeitrag}}, {{Link2Forum\|Topic=71551\|Message=1090783\|LinkText=Forumsbeitrag}}

	Für die Beschreibung der Einrichtung als native Installation in Verbindung mit einer InfluxDB 1.x sei auf [https://waschto.eu/2018/11/02/fhem-und-grafana-tool-zum-visualisieren-von-messdaten/ diesen Artikel] verwiesen. }}		Für die Beschreibung der Einrichtung als native Installation in Verbindung mit einer InfluxDB 1.x sei auf [https://waschto.eu/2018/11/02/fhem-und-grafana-tool-zum-visualisieren-von-messdaten/ diesen Artikel] verwiesen. }}
	Im Folgenden wird auf die Einrichtung unter Docker (inkl. Docker-Compose) mit einer InfluxDB 2.0 eingegangen.		Im Folgenden wird auf die Einrichtung unter Docker (inkl. Docker-Compose) mit einer InfluxDB 2.0 eingegangen.

	=== Einrichtung einer Datenbank ===		== Einrichtung einer Datenbank als Docker Container ==
	Voraussetzungen:		Voraussetzungen:
	* Eine laufende Docker-Umgebung (inkl. Docker-Compose)		* Eine laufende Docker-Umgebung (inkl. Docker-Compose)
Zeile 66:		Zeile 67:
	- DOCKER_INFLUXDB_INIT_ADMIN_TOKEN=${INFLUXDB_TOKEN}		- DOCKER_INFLUXDB_INIT_ADMIN_TOKEN=${INFLUXDB_TOKEN}
	</syntaxhighlight>		</syntaxhighlight>

			Die Definition des oben genannten Containers "fhem2" ist für die Einrichtung der Datenbank nicht notwendig und ist an dieser Stelle nur der Vollständigkeit halber mit aufgeführt. FHEM kann auch separat installiert sein, es bietet sich aber in diesem Beispiel an, gleich mit in das Docker-Compose-File mit aufgenommen zu werden.

	An dieser Stelle sei empfohlen, die Zugangsinformationen in eine .env Datei auszulagern, die zugriffsbeschränkt im gleichen Verzeichnis liegt, wie die <code>docker-compose.yml</code> Datei.		An dieser Stelle sei empfohlen, die Zugangsinformationen in eine .env Datei auszulagern, die zugriffsbeschränkt im gleichen Verzeichnis liegt, wie die <code>docker-compose.yml</code> Datei.
Zeile 88:		Zeile 91:
	gestoppt werden.		gestoppt werden.

	=== Konfiguration des Loggers als Device ===		Nach der Einrichtung der Datenbank wird empfohlen, die Ansprechbarkeit der Datenbank über das Webinterface unter Zuhilfenahme des vergebenen Usernamens und Passworts zu testen.
			<syntaxhighlight lang="HTML">
			http://<ip-des-dockercontainers>:8086
			</syntaxhighlight>

			== Konfiguration des Loggers als Device in FHEM ==
	{{Randnotiz\|RNText='''Unterschiede zur Definition von DBLog'''		{{Randnotiz\|RNText='''Unterschiede zur Definition von DBLog'''
	Um Fehlern bei der Umstellung von DBLog auf InfluxDBLogger zu vermeiden, bitte beachten: anders als bei DBLog werden bei der Definition nur die Devices definiert und nicht zusätzlich auch die Readings {{Link2Forum\|Topic=114860\|Message=1119696\|LinkText=(Forum).}}. }}		Um Fehlern bei der Umstellung von DBLog auf InfluxDBLogger zu vermeiden, bitte beachten: anders als bei DBLog werden bei der Definition nur die Devices definiert und nicht zusätzlich auch die Readings {{Link2Forum\|Topic=114860\|Message=1119696\|LinkText=(Forum).}}. }}
Zeile 106:		Zeile 114:
	</syntaxhighlight>		</syntaxhighlight>

	=== Finetuning des Loggings ===		== Finetuning des Loggings ==
	Bei der Optimierung ist der Einschränkung an der Quelle (am jeweiligen Device) immer der Vorzug zu geben vor der Einschränkung an zentraler Stelle, um unnötig entstehende Daten zu vermeiden. Allerdings kann es Fälle geben, in denen eine Whitelist oder Blacklist bzgl. der Definition, welche der entstandenen Events geloggt werden sollen, sinnvoll sein kann.		Bei der Optimierung ist der Einschränkung an der Quelle (am jeweiligen Device) immer der Vorzug zu geben vor der Einschränkung an zentraler Stelle, um unnötig entstehende Daten zu vermeiden. Allerdings kann es Fälle geben, in denen eine Whitelist oder Blacklist bzgl. der Definition, welche der entstandenen Events geloggt werden sollen, sinnvoll sein kann.

	Dieses kann exklusiv oder zusätzlich zu den im Folgenden genannten Einschränkungen über die jeweiligen Devices an zentraler Stelle geschehen.		Dieses kann exklusiv oder zusätzlich zu den im Folgenden genannten Einschränkungen über die jeweiligen Devices an zentraler Stelle geschehen.

	==== Einschränkung über die jeweiligen Devices ====		=== Einschränkung über die jeweiligen Devices ===
	Da in Abhängigkeit von Events Einträge in die Datenbank geschrieben werden, lassen sich die gleichen Prinzipien anwenden, wie bei [[DbLog]] und [[FileLog]] um Events zu unterdrücken:		Da in Abhängigkeit von Events Einträge in die Datenbank geschrieben werden, lassen sich die gleichen Prinzipien anwenden, wie bei [[DbLog]] und [[FileLog]] um Events zu unterdrücken:
	* event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. {{Link2CmdRef\|Lang=de\|Anker=event-on-update-reading}})		* event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. {{Link2CmdRef\|Lang=de\|Anker=event-on-update-reading}})
	* event-aggregator ({{Link2Forum\|Topic=114860\|Message=1110435\|LinkText=Forum}})		* event-aggregator ({{Link2Forum\|Topic=114860\|Message=1110435\|LinkText=Forum}})

	==== Einschränkung über den zentralen <code>define</code>-Eintrag ====		=== Einschränkung über den zentralen <code>define</code>-Eintrag ===
	Verweis auf die commandref {{Link2CmdRef\|Lang=de\|Anker=InfluxDBLogger\|Label=InfluxDBLogger}} bzgl. der Attribute <code>readingInclude</code> und <code>readingInclude</code> bzw. ein Link ins Forum zu einem Beispiel für dessen Verwendung ({{Link2Forum\|Topic=114860\|Message=1119696\|LinkText=Forum}}).		Verweis auf die commandref {{Link2CmdRef\|Lang=de\|Anker=InfluxDBLogger\|Label=InfluxDBLogger}} bzgl. der Attribute <code>readingInclude</code> und <code>readingInclude</code> bzw. ein Link ins Forum zu einem Beispiel für dessen Verwendung ({{Link2Forum\|Topic=114860\|Message=1119696\|LinkText=Forum}}).

			=== Loggen von Zuständen ===
			Wie eingangs erwähnt, ist die Datenbank designt, numerische Werte zu loggen. Nichtnumerische Werte lassen sich nur über dem Umweg „tags“ in der Datenbank ablegen. ({{Link2Forum\|Topic=114860\|Message=1127469\|LinkText=Forum}})
			({{Link2Forum\|Topic=114860\|Message=1131301\|LinkText=Forum}})

			Sollen nun Zustände von z.B. Fenster- oder Türkontakten geloggt werden, kommt das Attribut <code> conversion </code> zum Einsatz. Mit ihm lassen sich Zustände entsprechend in Werte umwandeln.

			Die jeweiligen Umwandelungen werden kommagetrennt aufgezählt. Mehrere Werte können durch ein pipe getrennt aufgezählt werden. Die Parameteraufzählung enthält dabei keine Leerzeichen.
			Conversions sind nicht case sensitive ({{Link2Forum\|Topic=114860\|Message=1122035\|LinkText=Forum}}).
			Ein entsprechendes Beispiel für die Anwendung befindet sich in der commandref {{Link2CmdRef\|Lang=de\|Anker=InfluxDBLogger\|Label=InfluxDBLogger}}.

			=== Mehrere Logging-Devices ===
			Um eine weitere Detaillierung des Loggings umzusetzen, bei unterschiedlicher Kombination von devspec, readingInclude, readingExclude, sowie der entsprechenden Limitierung der Events, sei an dieser Stelle ebenfalls darauf verwiesen, mehrere Definitionen des Moduls kombinieren zu können, z.B. 5 separate Logger, einer für Raumsensoren, einer für die Heizung, einer für Energiezähler, einer für das Wetter und ein weiterer für alles weitere Allgemeine.

			=== Weiteres Feinetuning ===
			Ohne weitere Definition von Attributen werden die numerischen Daten mit <code>Site_name</code> und <code>value</code> in die Datenbank geschrieben. Dieses ist historisch bedingt, siehe ({{Link2Forum\|Topic=71551\|Message=1072372\|LinkText=Forum}}) und ({{Link2Forum\|Topic=114860\|Message=1090782\|LinkText=Forum}}).

			Als nützlich Kombination hat sich beispielsweise die Definition folgender Attribute herausgestellt:
			<syntaxhighlight lang="Text">
			attr influxDB fields $READINGNAME=$READINGVALUE
			attr influxDB measurement $DEVICE
			attr influxDB tags device={my $str = AttrVal($device,"alias",$device);; $str =~ s/\s/_/g;; return $str;;}
			</syntaxhighlight>

			Dieses führt dazu, dass
			* das durch Unterstriche verbundene Alias als "_Device",
			* der Devicename als "_Measurement",
			* der Readingsname als "_Field"
			verwendet wird.

			Für alternative Verwendung der entsprechenden Attribute sei ebenfalls auf die ComandRef {{Link2CmdRef\|Lang=de\|Anker=InfluxDBLogger\|Label=InfluxDBLogger}} verwiesen.

	== Datenbank ==		== Datenbank ==
Zeile 132:		Zeile 171:
	=== Migration von Altdaten ===		=== Migration von Altdaten ===
	Zwei Hinweise ins Forum bzgl.		Zwei Hinweise ins Forum bzgl.
	* ~~Ein Script~~, um filelogs zu migrieren ({{Link2Forum\|Topic=114860\|Message=1104495\|LinkText=Forum}}).		* Scripte, um filelogs zu migrieren: ({{Link2Forum\|Topic=114860\|Message=1104495\|LinkText=Forum}}) oder ({{Link2Forum\|Topic=71551\|Message=732935\|LinkText=Forum}})
	* ~~Ein Script~~, um Mysql Daten zu migrieren ({{Link2Forum\|Topic=118049\|Message=1129622\|LinkText=Forum}})		* Scripte, um Mysql Daten zu migrieren: ({{Link2Forum\|Topic=118049\|Message=1129622\|LinkText=Forum}}) oder ({{Link2Forum\|Topic=71551\|Message=838940\|LinkText=Forum}}) oder ({{Link2Forum\|Topic=71551\|Message=895012\|LinkText=Forum}}) oder ({{Link2Forum\|Topic=71551\|Message=895764\|LinkText=Forum}})

	=== Plot-Abrisse vermeiden ===		=== Plot-Abrisse vermeiden ===

Ph1959de: Sichtung / Bearbeitung der letzten Änderung; "altes" Modul verlinkt

2021-11-25T09:50:57Z

Sichtung / Bearbeitung der letzten Änderung; "altes" Modul verlinkt

← Nächstältere Version		Version vom 25. November 2021, 11:50 Uhr
Zeile 5:		Zeile 5:
	\|ModForumArea=Unterstützende Dienste		\|ModForumArea=Unterstützende Dienste
	\|ModTechName=93_InfluxDBLogger.pm		\|ModTechName=93_InfluxDBLogger.pm
	\|ModOwner={{Link2FU\|41939\|timmib}}		\|ModOwner={{Link2FU\|41939\|timmib}}}}
	}}

	Genau wie mit dem Modul [[DbLog]] lassen sich mit [[InfluxDBLogger]] Daten in einer Datenbank speichern.		Genau wie mit dem Modul [[DbLog]] lassen sich mit [[InfluxDBLogger]] Daten in einer Datenbank speichern.

Zeile 19:		Zeile 17:

	== Konfiguration ==		== Konfiguration ==
	{{Randnotiz\|RNText='''Alternativmodul'''		{{Randnotiz\|RNTyp=y\|RNText='''Alternativmodul'''
	Um Missverständnisse zu vermeiden sei an dieser Stelle darauf hingewiesen, dass es bereits ein anderes Modul mit den Namen 93_InfluxDBLog für die Anbindung an eine InfluxDB gibt, das zu diesem Zeitpunkt (11/2021) allerdings ~~scheint,~~ nicht weiterentwickelt zu werden und um das es in diesem Artikel definitiv nicht geht. {{Link2Forum\|Topic=71551\|Message=1090783\|LinkText=~~(Forum)~~}}		Um Missverständnisse zu vermeiden sei, an dieser Stelle darauf hingewiesen, dass es bereits ein anderes Modul mit den Namen [[InfluxDBLog\|93_InfluxDBLog]] für die Anbindung an eine InfluxDB gibt, das zu diesem Zeitpunkt (11/2021) allerdings nicht weiterentwickelt zu werden scheint und um das es in diesem Artikel definitiv nicht geht. Siehe dazu auch diesen {{Link2Forum\|Topic=71551\|Message=1090783\|LinkText=Forumsbeitrag}}.

	Für die Beschreibung der Einrichtung als native Installation in Verbindung mit einer InfluxDB 1.x sei auf [https://waschto.eu/2018/11/02/fhem-und-grafana-tool-zum-visualisieren-von-messdaten/ diesen Artikel] verwiesen. }}		Für die Beschreibung der Einrichtung als native Installation in Verbindung mit einer InfluxDB 1.x sei auf [https://waschto.eu/2018/11/02/fhem-und-grafana-tool-zum-visualisieren-von-messdaten/ diesen Artikel] verwiesen. }}
			Im Folgenden wird auf die Einrichtung unter Docker (inkl. Docker-Compose) mit einer InfluxDB 2.0 eingegangen.

	Im ~~folgenden~~ wird auf die Einrichtung unter Docker (inkl. Docker-Compose) mit einer InfluxDB 2.0 eingegangen.

	=== Einrichtung einer Datenbank ===		=== Einrichtung einer Datenbank ===
Zeile 94:		Zeile 90:
	=== Konfiguration des Loggers als Device ===		=== Konfiguration des Loggers als Device ===
	{{Randnotiz\|RNText='''Unterschiede zur Definition von DBLog'''		{{Randnotiz\|RNText='''Unterschiede zur Definition von DBLog'''
	Um Fehlern bei der Umstellung von DBLog auf InfluxDBLogger zu vermeiden, anders als bei DBLog werden bei der Definition nur die Devices definiert und nicht zusätzlich auch die Readings {{Link2Forum\|Topic=114860\|Message=1119696\|LinkText=(Forum).}}. }}		Um Fehlern bei der Umstellung von DBLog auf InfluxDBLogger zu vermeiden, bitte beachten: anders als bei DBLog werden bei der Definition nur die Devices definiert und nicht zusätzlich auch die Readings {{Link2Forum\|Topic=114860\|Message=1119696\|LinkText=(Forum).}}. }}


	Das InfluxDBLogger Device wird dann definiert mit		Das InfluxDBLogger Device wird dann definiert mit
	:<code>define <Device-name> InfluxDBLogger [http\|https]://IP_or_Hostname:port dbname devspec,devspec,<weitere devspec></code>		:<code>define <Device-name> InfluxDBLogger [http\|https]://IP_or_Hostname:port dbname devspec,devspec,<weitere devspec></code>

	wobei bei der Verwendung der InfluxDB Version 2 folgende Attributfestlegungen notwendig werden:		wobei bei der Verwendung der InfluxDB Version 2 folgende Attributfestlegungen notwendig werden:
	* Das Attribut api=v2, ~~dass~~ die ~~InfluxDV~~ Version 2 festlegt. Hiermit wird auch das ~~Setzten~~ der Org mit dem folgenden Attribut notwendig, wie auch die Verknüpfung des Buckets als ''dbname''.		* Das Attribut api=v2, das die InfluxDB Version 2 festlegt. Hiermit wird auch das Setzen der Org mit dem folgenden Attribut notwendig, wie auch die Verknüpfung des Buckets als ''dbname''.
	* Das Attribut org=myorg, ~~dass~~ die vergebene Org festlegt.		* Das Attribut org=myorg, das die vergebene Org festlegt.
	* Das Attribut security=token, ~~dass~~ die Verwendung eines Tokens festlegt. Hiermit ist ebenfalls das Definieren eines Users als Attribut und das Setzen eines Passwortes überflüssig. Der Token wird über <code> set <Device-name> token <mytoken></code> festlegt.		* Das Attribut security=token, das die Verwendung eines Tokens festlegt. Hiermit ist ebenfalls das Definieren eines Users als Attribut und das Setzen eines Passwortes überflüssig. Der Token wird über <code> set <Device-name> token <mytoken></code> festlegt.

	Ein Beispiel für eine Konfiguration wäre:		Ein Beispiel für eine Konfiguration wäre:
	<~~pre~~>		<syntaxhighlight lang="Text">
	define influxDB InfluxDBLogger http://10.10.120.106:8086 FHEM-bucket DB_Temp_Hum,KU_Temp_Hum,FL_Temp_Hum		define influxDB InfluxDBLogger http://10.10.120.106:8086 FHEM-bucket DB_Temp_Hum,KU_Temp_Hum,FL_Temp_Hum
	attr influxDB api v2		attr influxDB api v2
	attr influxDB org myorg		attr influxDB org myorg
	attr influxDB security token		attr influxDB security token
	</~~pre~~>		</syntaxhighlight>

	=== Finetuning des Loggings ===		=== Finetuning des Loggings ===
	Bei der Optimierung ist der Einschränkung an der Quelle (am jeweiligen Device) immer der Vorzug zu geben vor ~~der~~ der Einschränkung an zentraler Stelle um unnötig entstehende Daten zu vermeiden. Allerdings kann es Fälle geben, in denen eine Whitelist oder Blacklist bzgl. der Definition, welche der entstandenen ~~Event~~ geloggt werden sollen, sinnvoll sein kann.		Bei der Optimierung ist der Einschränkung an der Quelle (am jeweiligen Device) immer der Vorzug zu geben vor der Einschränkung an zentraler Stelle, um unnötig entstehende Daten zu vermeiden. Allerdings kann es Fälle geben, in denen eine Whitelist oder Blacklist bzgl. der Definition, welche der entstandenen Events geloggt werden sollen, sinnvoll sein kann.

	Dieses kann exklusiv oder zusätzlich zu den im Folgenden genannten Einschränkungen über die jeweiligen Devices an zentraler Stelle geschehen.		Dieses kann exklusiv oder zusätzlich zu den im Folgenden genannten Einschränkungen über die jeweiligen Devices an zentraler Stelle geschehen.
Zeile 121:		Zeile 114:
	Da in Abhängigkeit von Events Einträge in die Datenbank geschrieben werden, lassen sich die gleichen Prinzipien anwenden, wie bei [[DbLog]] und [[FileLog]] um Events zu unterdrücken:		Da in Abhängigkeit von Events Einträge in die Datenbank geschrieben werden, lassen sich die gleichen Prinzipien anwenden, wie bei [[DbLog]] und [[FileLog]] um Events zu unterdrücken:
	* event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. {{Link2CmdRef\|Lang=de\|Anker=event-on-update-reading}})		* event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. {{Link2CmdRef\|Lang=de\|Anker=event-on-update-reading}})
	* event-aggregator		* event-aggregator ({{Link2Forum\|Topic=114860\|Message=1110435\|LinkText=Forum}})
	{{Link2Forum\|Topic=114860\|Message=1110435\|LinkText=(Forum)}}

	==== Einschränkung über den zentralen <code>define</code>-Eintrag ====		==== Einschränkung über den zentralen <code>define</code>-Eintrag ====
			Verweis auf die commandref {{Link2CmdRef\|Lang=de\|Anker=InfluxDBLogger\|Label=InfluxDBLogger}} bzgl. der Attribute <code>readingInclude</code> und <code>readingInclude</code> bzw. ein Link ins Forum zu einem Beispiel für dessen Verwendung ({{Link2Forum\|Topic=114860\|Message=1119696\|LinkText=Forum}}).
	Verweis auf die commandref {{Link2CmdRef\|Lang=de\|Anker=InfluxDBLogger\|Label=InfluxDBLogger}} bzgl. der Attribute <code>readingInclude</code> und <code>readingInclude</code> bzw. ein Link ins Forum zu einem Beispiel für dessen Verwendung {{Link2Forum\|Topic=114860\|Message=1119696\|LinkText=(Forum)}}.


	== Datenbank ==		== Datenbank ==
Zeile 135:		Zeile 125:

	== Zusätzliches ==		== Zusätzliches ==

	=== Probleme bei der Authentifizierung ===		=== Probleme bei der Authentifizierung ===
	Bei der Ersteinrichtung des Moduls scheint es Konfigurations-Zustände zu geben, in denen die Authentifizierung trotz richtiger Zugangsdaten zunächst fehlschlägt (aufgetreten bei der Verwendung von Api v2) {{Link2Forum\|Topic=121454\|Message=1160757\|LinkText=(Forum)}}. Dabei scheint es zu helfen, das Modul zu löschen und neu einzurichten.		Bei der Ersteinrichtung des Moduls scheint es Konfigurations-Zustände zu geben, in denen die Authentifizierung trotz richtiger Zugangsdaten zunächst fehlschlägt (aufgetreten bei der Verwendung von Api v2) {{Link2Forum\|Topic=121454\|Message=1160757\|LinkText=(Forum)}}. Dabei scheint es zu helfen, das Modul zu löschen und neu einzurichten.
Zeile 143:		Zeile 132:
	=== Migration von Altdaten ===		=== Migration von Altdaten ===
	Zwei Hinweise ins Forum bzgl.		Zwei Hinweise ins Forum bzgl.
	* Ein Script, um filelogs zu migrieren {{Link2Forum\|Topic=114860\|Message=1104495\|LinkText=(Forum)}}.		* Ein Script, um filelogs zu migrieren ({{Link2Forum\|Topic=114860\|Message=1104495\|LinkText=Forum}}).
	* Ein Script, um Mysql Daten zu migrieren {{Link2Forum\|Topic=118049\|Message=1129622\|LinkText=(Forum)}}		* Ein Script, um Mysql Daten zu migrieren ({{Link2Forum\|Topic=118049\|Message=1129622\|LinkText=Forum}})

	=== Plot-Abrisse vermeiden ===		=== Plot-Abrisse vermeiden ===
Zeile 152:		Zeile 141:

	Ein entsprechendes DOIF müsste dann so aussehen:		Ein entsprechendes DOIF müsste dann so aussehen:
	<~~pre~~>		<syntaxhighlight lang="Text">
	define addlog DOIF ([23:59:59] or [00:00:00])(set influxDB write)		define addlog DOIF ([23:59:59] or [00:00:00])(set influxDB write)
	attr addlog do always		attr addlog do always
	</~~pre~~>		</syntaxhighlight>

	=== Device Alias mit Leerzeichen als tag ===		=== Device Alias mit Leerzeichen als tag ===
	Über das Attribut <code>tags</code> lassen sich weitere Informationen den Daten hinzufügen wie z.B. die vergebenen Aliase der Devices. Haben diese allerdings Leerzeichen, schlägt das logging fehl. Eine Ersetzung der Leerzeichen in Aliasen und der Verwendung als tag kann über diese Attributdefinition realisiert werden {{Link2Forum\|Topic=114860\|Message=1108269\|LinkText=(Forum)}}:		Über das Attribut <code>tags</code> lassen sich weitere Informationen den Daten hinzufügen wie z.B. die vergebenen Aliase der Devices. Haben diese allerdings Leerzeichen, schlägt das logging fehl. Eine Ersetzung der Leerzeichen in Aliasen und der Verwendung als tag kann über diese Attributdefinition realisiert werden ({{Link2Forum\|Topic=114860\|Message=1108269\|LinkText=Forum}}):
	<~~pre~~>		<syntaxhighlight lang="Text">
	attr influxDB tags device={my $str = AttrVal($device,"alias",$device);; $str =~ s/\s/_/g;; return $str;;}		attr influxDB tags device={my $str = AttrVal($device,"alias",$device);; $str =~ s/\s/_/g;; return $str;;}
	</~~pre~~>		</syntaxhighlight>

			== Links ==
			* https://www.influxdata.com/

	[[Kategorie:Logging]]		[[Kategorie:Logging]]

Joshi04: Mehrere kleinere Ergänzungen und Korrekturen

2021-11-25T03:32:06Z

Mehrere kleinere Ergänzungen und Korrekturen

← Nächstältere Version		Version vom 25. November 2021, 05:32 Uhr
Zeile 7:		Zeile 7:
	\|ModOwner={{Link2FU\|41939\|timmib}}		\|ModOwner={{Link2FU\|41939\|timmib}}
	}}		}}

	Genau wie mit dem Modul [[DbLog]] lassen sich mit [[InfluxDBLogger]] Daten in einer Datenbank speichern.		Genau wie mit dem Modul [[DbLog]] lassen sich mit [[InfluxDBLogger]] Daten in einer Datenbank speichern.

Zeile 18:		Zeile 19:

	== Konfiguration ==		== Konfiguration ==
	Für die Beschreibung der Einrichtung als native Installation in Verbindung mit einer InfluxDB 1.x sei auf [https://waschto.eu/2018/11/02/fhem-und-grafana-tool-zum-visualisieren-von-messdaten/ diesen Artikel] verwiesen.		{{Randnotiz\|RNText='''Alternativmodul'''
			Um Missverständnisse zu vermeiden sei an dieser Stelle darauf hingewiesen, dass es bereits ein anderes Modul mit den Namen 93_InfluxDBLog für die Anbindung an eine InfluxDB gibt, das zu diesem Zeitpunkt (11/2021) allerdings scheint, nicht weiterentwickelt zu werden und um das es in diesem Artikel definitiv nicht geht. {{Link2Forum\|Topic=71551\|Message=1090783\|LinkText=(Forum)}}

			Für die Beschreibung der Einrichtung als native Installation in Verbindung mit einer InfluxDB 1.x sei auf [https://waschto.eu/2018/11/02/fhem-und-grafana-tool-zum-visualisieren-von-messdaten/ diesen Artikel] verwiesen. }}


	Im folgenden wird auf die Einrichtung unter Docker (inkl. Docker-Compose) mit einer InfluxDB 2.0 eingegangen.		Im folgenden wird auf die Einrichtung unter Docker (inkl. Docker-Compose) mit einer InfluxDB 2.0 eingegangen.
Zeile 88:		Zeile 93:

	=== Konfiguration des Loggers als Device ===		=== Konfiguration des Loggers als Device ===
			{{Randnotiz\|RNText='''Unterschiede zur Definition von DBLog'''
			Um Fehlern bei der Umstellung von DBLog auf InfluxDBLogger zu vermeiden, anders als bei DBLog werden bei der Definition nur die Devices definiert und nicht zusätzlich auch die Readings {{Link2Forum\|Topic=114860\|Message=1119696\|LinkText=(Forum).}}. }}


	Das InfluxDBLogger Device wird dann definiert mit		Das InfluxDBLogger Device wird dann definiert mit
	:<code>define <Device-name> InfluxDBLogger [http\|https]://IP_or_Hostname:port dbname devspec,devspec,<weitere devspec></code>		:<code>define <Device-name> InfluxDBLogger [http\|https]://IP_or_Hostname:port dbname devspec,devspec,<weitere devspec></code>

	wobei bei der Verwendung der InfluxDB Version 2		wobei bei der Verwendung der InfluxDB Version 2 folgende Attributfestlegungen notwendig werden:
	* ''dbname'' dem vergebenen Bucket entspricht.		* Das Attribut api=v2, dass die InfluxDV Version 2 festlegt. Hiermit wird auch das Setzten der Org mit dem folgenden Attribut notwendig, wie auch die Verknüpfung des Buckets als ''dbname''.
	* Das Attribut api=v2 die InfluxDV Version 2 festlegt.		* Das Attribut org=myorg, dass die vergebene Org festlegt.
	* Das Attribut org=myorg die vergebene Org festlegt.		* Das Attribut security=token, dass die Verwendung eines Tokens festlegt. Hiermit ist ebenfalls das Definieren eines Users als Attribut und das Setzen eines Passwortes überflüssig. Der Token wird über <code> set <Device-name> token <mytoken></code> festlegt.
	* Das Attribut security=token die Verwendung eines Tokens festlegt.

	Der Token wird über <code> set <Device-name> token <mytoken></code> festlegt.

	Ein Beispiel für eine Konfiguration wäre:		Ein Beispiel für eine Konfiguration wäre:
Zeile 108:		Zeile 114:

	=== Finetuning des Loggings ===		=== Finetuning des Loggings ===
	~~{{Todo\|Todo}}~~		Bei der Optimierung ist der Einschränkung an der Quelle (am jeweiligen Device) immer der Vorzug zu geben vor der der Einschränkung an zentraler Stelle um unnötig entstehende Daten zu vermeiden. Allerdings kann es Fälle geben, in denen eine Whitelist oder Blacklist bzgl. der Definition, welche der entstandenen Event geloggt werden sollen, sinnvoll sein kann.

	~~==== Einschränkung~~ über ~~den zentralen <code>define</code>-Eintrag ====~~		Dieses kann exklusiv oder zusätzlich zu den im Folgenden genannten Einschränkungen über die jeweiligen Devices an zentraler Stelle geschehen.
	~~{{Todo\|Todo}}~~

	==== Einschränkung über die jeweiligen Devices ====		==== Einschränkung über die jeweiligen Devices ====
	Da in Abhängigkeit von Events Einträge in die Datenbank geschrieben werden, lassen sich die gleichen Prinzipien anwenden, wie bei [[DbLog]] und [[FileLog]] um Events zu unterdrücken:		Da in Abhängigkeit von Events Einträge in die Datenbank geschrieben werden, lassen sich die gleichen Prinzipien anwenden, wie bei [[DbLog]] und [[FileLog]] um Events zu unterdrücken:
	* event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. {{Link2CmdRef\|Lang=de\|Anker=event-on-update-reading}})		* event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. {{Link2CmdRef\|Lang=de\|Anker=event-on-update-reading}})
			* event-aggregator
			{{Link2Forum\|Topic=114860\|Message=1110435\|LinkText=(Forum)}}

			==== Einschränkung über den zentralen <code>define</code>-Eintrag ====

			Verweis auf die commandref {{Link2CmdRef\|Lang=de\|Anker=InfluxDBLogger\|Label=InfluxDBLogger}} bzgl. der Attribute <code>readingInclude</code> und <code>readingInclude</code> bzw. ein Link ins Forum zu einem Beispiel für dessen Verwendung {{Link2Forum\|Topic=114860\|Message=1119696\|LinkText=(Forum)}}.


	== Datenbank ==		== Datenbank ==
Zeile 123:		Zeile 135:

	== Zusätzliches ==		== Zusätzliches ==

			=== Probleme bei der Authentifizierung ===
			Bei der Ersteinrichtung des Moduls scheint es Konfigurations-Zustände zu geben, in denen die Authentifizierung trotz richtiger Zugangsdaten zunächst fehlschlägt (aufgetreten bei der Verwendung von Api v2) {{Link2Forum\|Topic=121454\|Message=1160757\|LinkText=(Forum)}}. Dabei scheint es zu helfen, das Modul zu löschen und neu einzurichten.

			Da dieses nur bei der Ersteinrichtung aufzutreten scheint, konnte die Ursache bislang noch nicht genauer identifiziert werden.

			=== Migration von Altdaten ===
			Zwei Hinweise ins Forum bzgl.
			* Ein Script, um filelogs zu migrieren {{Link2Forum\|Topic=114860\|Message=1104495\|LinkText=(Forum)}}.
			* Ein Script, um Mysql Daten zu migrieren {{Link2Forum\|Topic=118049\|Message=1129622\|LinkText=(Forum)}}

	=== Plot-Abrisse vermeiden ===		=== Plot-Abrisse vermeiden ===
	Mit der Verwendung einer vollkommen neuen Datenverarbeitung, wird auch die Problematik der Plot-Abrisse an Datumsübergängen wieder zum Thema. Da das Modul [[logProxy]] direkt auf der Ebene der Darstellung (SVG-Plot Definition) ansetzt, kann es hier nicht eingesetzt werden.		Mit der Verwendung einer vollkommen neuen Datenverarbeitung, wird auch die Problematik der Plot-Abrisse an Datumsübergängen wieder zum Thema. Da das Modul [[logProxy]] direkt auf der Ebene der Darstellung (SVG-Plot Definition) ansetzt, kann es hier nicht eingesetzt werden.
Zeile 134:		Zeile 157:
	</pre>		</pre>

	=== ~~Probleme bei der Authentifizierung~~ ===		=== Device Alias mit Leerzeichen als tag ===
	~~Bei~~ der ~~Ersteinrichtung des Moduls scheint es Konfigurations-Zustände zu geben~~, in ~~denen die Authentifizierung trotz richtiger Zugangsdaten zunächst fehlschlägt (aufgetreten bei~~ der Verwendung ~~von Api v2)~~ {{Link2Forum\|Topic=~~121454~~\|Message=~~1160757~~\|LinkText=(Forum)}}~~. Dabei scheint es zu helfen, das Modul zu löschen und neu einzurichten.~~		Über das Attribut <code>tags</code> lassen sich weitere Informationen den Daten hinzufügen wie z.B. die vergebenen Aliase der Devices. Haben diese allerdings Leerzeichen, schlägt das logging fehl. Eine Ersetzung der Leerzeichen in Aliasen und der Verwendung als tag kann über diese Attributdefinition realisiert werden {{Link2Forum\|Topic=114860\|Message=1108269\|LinkText=(Forum)}}:
			<pre>
	~~Da dieses nur bei der Ersteinrichtung aufzutreten scheint~~, ~~konnte die Ursache bislang noch nicht genauer identifiziert werden.~~		attr influxDB tags device={my $str = AttrVal($device,"alias",$device);; $str =~ s/\s/_/g;; return $str;;}
			</pre>

	[[Kategorie:Logging]]		[[Kategorie:Logging]]

Ph1959de: Tippfehler korrigiert

2021-11-22T13:53:24Z

Tippfehler korrigiert

← Nächstältere Version		Version vom 22. November 2021, 15:53 Uhr
Zeile 66:		Zeile 66:
	</syntaxhighlight>		</syntaxhighlight>

	An dieser Stelle sei empfohlen, die Zugangsinformationen in eine .env Datei auszulagern, die zugriffsbeschränkt im gleichen Verzeichnis liegt, wie die <code>docker-~~complose~~.yml</code> Datei.		An dieser Stelle sei empfohlen, die Zugangsinformationen in eine .env Datei auszulagern, die zugriffsbeschränkt im gleichen Verzeichnis liegt, wie die <code>docker-compose.yml</code> Datei.
	<syntaxhighlight lang="YAML">		<syntaxhighlight lang="YAML">
	INFLUXDB_USERNAME=myusername		INFLUXDB_USERNAME=myusername
Zeile 79:		Zeile 79:
	Der Eintrag "DOCKER_INFLUXDB_INIT_MODE=setup" führt dazu, dass die Datenbank beim ersten Starten initialisiert wird, dieses aber nur, falls keine Datenbank gefunden wird. So kann dieser Eintrag für die spätere Verwendung in der Konfiguration verbleiben und muss nicht entfernt werden.		Der Eintrag "DOCKER_INFLUXDB_INIT_MODE=setup" führt dazu, dass die Datenbank beim ersten Starten initialisiert wird, dieses aber nur, falls keine Datenbank gefunden wird. So kann dieser Eintrag für die spätere Verwendung in der Konfiguration verbleiben und muss nicht entfernt werden.

	Mit dieser Konfiguration ist ~~fhem~~ über <code><ip-des-docker-servers>:8083</code> erreichbar, das Webinterface von InfluxDB über <code><ip-des-docker-servers>:8086</code> erreichbar.		Mit dieser Konfiguration ist FHEM über <code><ip-des-docker-servers>:8083</code> erreichbar, das Webinterface von InfluxDB über <code><ip-des-docker-servers>:8086</code> erreichbar.

	Die gesamte Konfiguration kann über		Die gesamte Konfiguration kann über

Joshi04: Schreibfehler korrigiert / Verwendung von .env für "Geheimnisse" / Prob bei Ersteinrichtungsauthentifizierung

2021-11-21T13:45:43Z

Schreibfehler korrigiert / Verwendung von .env für "Geheimnisse" / Prob bei Ersteinrichtungsauthentifizierung

← Nächstältere Version		Version vom 21. November 2021, 15:45 Uhr
Zeile 18:		Zeile 18:

	== Konfiguration ==		== Konfiguration ==
	Für die Beschreibung der Einrichtung als native Installation in Verbindung mit einer ~~InflixDB~~ 1.x sei auf [https://waschto.eu/2018/11/02/fhem-und-grafana-tool-zum-visualisieren-von-messdaten/ diesen Artikel] verwiesen.		Für die Beschreibung der Einrichtung als native Installation in Verbindung mit einer InfluxDB 1.x sei auf [https://waschto.eu/2018/11/02/fhem-und-grafana-tool-zum-visualisieren-von-messdaten/ diesen Artikel] verwiesen.

	Im folgenden wird auf die Einrichtung unter Docker (inkl. Docker-Compose) mit einer ~~InflixDB~~ 2.0 eingegangen.		Im folgenden wird auf die Einrichtung unter Docker (inkl. Docker-Compose) mit einer InfluxDB 2.0 eingegangen.

	=== Einrichtung einer Datenbank ===		=== Einrichtung einer Datenbank ===
Zeile 59:		Zeile 59:
	environment:		environment:
	- DOCKER_INFLUXDB_INIT_MODE=setup		- DOCKER_INFLUXDB_INIT_MODE=setup
	- DOCKER_INFLUXDB_INIT_USERNAME=~~myusername~~		- DOCKER_INFLUXDB_INIT_USERNAME=${INFLUXDB_USERNAME}
	- DOCKER_INFLUXDB_INIT_PASSWORD=~~passwordpasswordpassword~~		- DOCKER_INFLUXDB_INIT_PASSWORD=${INFLUXDB_PASSWORD}
	- DOCKER_INFLUXDB_INIT_ORG=~~myorg~~		- DOCKER_INFLUXDB_INIT_ORG=${INFLUXDB_ORG}
	- DOCKER_INFLUXDB_INIT_BUCKET=~~mybucket~~		- DOCKER_INFLUXDB_INIT_BUCKET=${INFLUXDB_BUCKET}
	- DOCKER_INFLUXDB_INIT_ADMIN_TOKEN=mytoken		- DOCKER_INFLUXDB_INIT_ADMIN_TOKEN=${INFLUXDB_TOKEN}
			</syntaxhighlight>

			An dieser Stelle sei empfohlen, die Zugangsinformationen in eine .env Datei auszulagern, die zugriffsbeschränkt im gleichen Verzeichnis liegt, wie die <code>docker-complose.yml</code> Datei.
			<syntaxhighlight lang="YAML">
			INFLUXDB_USERNAME=myusername
			INFLUXDB_PASSWORD=passwordpasswordpassword
			INFLUXDB_ORG=myorg
			INFLUXDB_BUCKET=mybucket
			INFLUXDB_ADMIN_TOKEN=mytoken
	</syntaxhighlight>		</syntaxhighlight>

Zeile 97:		Zeile 106:
	attr influxDB security token		attr influxDB security token
	</pre>		</pre>

	[[Benutzer Diskussion:Joshi04\|Ich]] bin mir nicht sicher, ob das Setzen eines Passwords und Users in Verbindung mit der oben beschriebenen Authentifizierungsmethodik (v2 mit Token) dazu führt, dass die Authentifizierung damit fehlschlägt.

	=== Finetuning des Loggings ===		=== Finetuning des Loggings ===
Zeile 126:		Zeile 133:
	attr addlog do always		attr addlog do always
	</pre>		</pre>

			=== Probleme bei der Authentifizierung ===
			Bei der Ersteinrichtung des Moduls scheint es Konfigurations-Zustände zu geben, in denen die Authentifizierung trotz richtiger Zugangsdaten zunächst fehlschlägt (aufgetreten bei der Verwendung von Api v2) {{Link2Forum\|Topic=121454\|Message=1160757\|LinkText=(Forum)}}. Dabei scheint es zu helfen, das Modul zu löschen und neu einzurichten.

			Da dieses nur bei der Ersteinrichtung aufzutreten scheint, konnte die Ursache bislang noch nicht genauer identifiziert werden.

	[[Kategorie:Logging]]		[[Kategorie:Logging]]

Ph1959de: Tippfehler korrigiert

2021-11-21T09:22:42Z

Tippfehler korrigiert

← Nächstältere Version		Version vom 21. November 2021, 11:22 Uhr
Zeile 9:		Zeile 9:
	Genau wie mit dem Modul [[DbLog]] lassen sich mit [[InfluxDBLogger]] Daten in einer Datenbank speichern.		Genau wie mit dem Modul [[DbLog]] lassen sich mit [[InfluxDBLogger]] Daten in einer Datenbank speichern.

	Für die Vorteile der Speicherung von Daten in einer Datenbank sei die Beschreibung des Moduls ''DbLog'' verwiesen.		Für die Vorteile der Speicherung von Daten in einer Datenbank sei auf die Beschreibung des Moduls ''DbLog'' verwiesen.

	Einer der größten Unterschiede zu einer SQL-Datenbank ist die Tatsache, dass influxDB speziell darauf ausgelegt ist, große Messdatenmengen in kurzer Zeit zusammen mit einem Zeitstempel des Messzeitpunkts zu verarbeiten.		Einer der größten Unterschiede zu einer SQL-Datenbank ist die Tatsache, dass influxDB speziell darauf ausgelegt ist, große Messdatenmengen in kurzer Zeit zusammen mit einem Zeitstempel des Messzeitpunkts zu verarbeiten.

Ph1959de: Sichtung / Bearbeitung der letzten Änderungen

2021-11-21T09:21:59Z

Sichtung / Bearbeitung der letzten Änderungen

← Nächstältere Version		Version vom 21. November 2021, 11:21 Uhr
Zeile 1:		Zeile 1:
			{{Todo\|Dieser Artikel befindet sich im Aufbau und beschreibt daher anstatt einer kompletten Konfiguration bislang nur Teilabschnitte.}}
	{{Infobox Modul		{{Infobox Modul
	\|ModPurpose=Protokolliert Ereignisse in einer Datenbank		\|ModPurpose=Protokolliert Ereignisse in einer Datenbank
Zeile 4:		Zeile 5:
	\|ModForumArea=Unterstützende Dienste		\|ModForumArea=Unterstützende Dienste
	\|ModTechName=93_InfluxDBLogger.pm		\|ModTechName=93_InfluxDBLogger.pm
	\|ModOwner=~~timmib (~~{{Link2FU\|41939\|~~Forum~~}})		\|ModOwner={{Link2FU\|41939\|timmib}}
	}}		}}
			Genau wie mit dem Modul [[DbLog]] lassen sich mit [[InfluxDBLogger]] Daten in einer Datenbank speichern.

	~~{{Todo\|Dieser Artikel befindet sich im Aufbau und beschreibt daher anstatt einer kompletten Konfiguration bislang nur Teilabschnitte.}}~~		Für die Vorteile der Speicherung von Daten in einer Datenbank sei die Beschreibung des Moduls ''DbLog'' verwiesen.

	~~== Einleitung ==~~
	~~Genauso, wie das Modul {{Link2CmdRef\|Lang=de\|Anker=DbLog\|Label=DbLog}} lassen sich mit dem Modul {{Link2CmdRef\|Lang=de\|Anker=InfluxDBLogger\|Label=InfluxDBLogger}} Daten in einer Datenbank speichern.~~

	Für die Vorteile der Speicherung von Daten in einer Datenbank sei ~~auf den Artikel über das Modul [[~~DbLog]] verwiesen.

	Einer der größten Unterschiede zu einer SQL-Datenbank ist die Tatsache, dass influxDB speziell darauf ausgelegt ist, große Messdatenmengen in kurzer Zeit zusammen mit einem Zeitstempel des Messzeitpunkts zu verarbeiten.		Einer der größten Unterschiede zu einer SQL-Datenbank ist die Tatsache, dass influxDB speziell darauf ausgelegt ist, große Messdatenmengen in kurzer Zeit zusammen mit einem Zeitstempel des Messzeitpunkts zu verarbeiten.
Zeile 31:		Zeile 28:
	* Die FHEM Konfiguration im Unterordner ./fhem/conf		* Die FHEM Konfiguration im Unterordner ./fhem/conf
	* Das folgende file <code>docker-compose.yml</code> im Ausgangsordner		* Das folgende file <code>docker-compose.yml</code> im Ausgangsordner
	<~~pre~~>		<syntaxhighlight lang="YAML">
	version: '2.4'		version: '2.4'
	services:		services:
Zeile 67:		Zeile 64:
	- DOCKER_INFLUXDB_INIT_BUCKET=mybucket		- DOCKER_INFLUXDB_INIT_BUCKET=mybucket
	- DOCKER_INFLUXDB_INIT_ADMIN_TOKEN=mytoken		- DOCKER_INFLUXDB_INIT_ADMIN_TOKEN=mytoken
	</~~pre~~>		</syntaxhighlight>

	Die Unterverzeichnisse für die InfluxDB Datenbank (./influxdb/data), sowie die Konfiguration (./influxdb/config) werden automatisch ~~bei~~ ersten Starten erstellt.		Die Unterverzeichnisse für die InfluxDB Datenbank (./influxdb/data), sowie die Konfiguration (./influxdb/config) werden automatisch beim ersten Starten erstellt.

	Der Eintrag "DOCKER_INFLUXDB_INIT_MODE=setup" führt dazu, dass die Datenbank beim ersten Starten initialisiert wird, dieses aber nur, falls keine Datenbank gefunden wird. So kann dieser Eintrag für die spätere Verwendung in der Konfiguration verbleiben und muss nicht entfernt werden.		Der Eintrag "DOCKER_INFLUXDB_INIT_MODE=setup" führt dazu, dass die Datenbank beim ersten Starten initialisiert wird, dieses aber nur, falls keine Datenbank gefunden wird. So kann dieser Eintrag für die spätere Verwendung in der Konfiguration verbleiben und muss nicht entfernt werden.
Zeile 76:		Zeile 73:

	Die gesamte Konfiguration kann über		Die gesamte Konfiguration kann über
			:<code>docker-compose up -d </code>
	<code>
	docker-compose up -d
	</code>
	gestartet, bzw. über		gestartet, bzw. über
			:<code>docker-compose down </code>
	<code>
	docker-compose down
	</code>
	gestoppt werden.		gestoppt werden.

Zeile 107:		Zeile 98:
	</pre>		</pre>

	Ich bin mir nicht sicher, ob das Setzen eines Passwords und Users in Verbindung mit der oben beschriebenen Authentifizierungsmethodik (v2 mit Token) dazu führt, dass die Authentifizierung damit fehlschlägt.		[[Benutzer Diskussion:Joshi04\|Ich]] bin mir nicht sicher, ob das Setzen eines Passwords und Users in Verbindung mit der oben beschriebenen Authentifizierungsmethodik (v2 mit Token) dazu führt, dass die Authentifizierung damit fehlschlägt.

	=== Finetuning des Loggings ===		=== Finetuning des Loggings ===
Zeile 114:		Zeile 105:
	==== Einschränkung über den zentralen <code>define</code>-Eintrag ====		==== Einschränkung über den zentralen <code>define</code>-Eintrag ====
	{{Todo\|Todo}}		{{Todo\|Todo}}


	==== Einschränkung über die jeweiligen Devices ====		==== Einschränkung über die jeweiligen Devices ====
	Da in Abhängigkeit von Events Einträge in die Datenbank geschrieben werden, lassen sich die gleichen Prinzipien anwenden, wie bei [[DbLog]] und [[FileLog]] ~~und~~ Events zu unterdrücken:		Da in Abhängigkeit von Events Einträge in die Datenbank geschrieben werden, lassen sich die gleichen Prinzipien anwenden, wie bei [[DbLog]] und [[FileLog]] um Events zu unterdrücken:
	* event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. {{Link2CmdRef\|Lang=de\|Anker=event-on-update-reading}})		* event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. {{Link2CmdRef\|Lang=de\|Anker=event-on-update-reading}})

Joshi04: Hinweis für "Plot-Abrisse vermeiden" hinzugefügt.

2021-11-21T08:29:24Z

Hinweis für "Plot-Abrisse vermeiden" hinzugefügt.

@@ Zeile 124: / Zeile 124: @@
 * influxDB 1.x
 * influxDB 2.x
 [[Kategorie:Logging]]

Joshi04: Kleinigkeitenkorrektur

2021-11-20T22:20:20Z

Kleinigkeitenkorrektur

← Nächstältere Version		Version vom 21. November 2021, 00:20 Uhr
Zeile 16:		Zeile 16:
	Einer der größten Unterschiede zu einer SQL-Datenbank ist die Tatsache, dass influxDB speziell darauf ausgelegt ist, große Messdatenmengen in kurzer Zeit zusammen mit einem Zeitstempel des Messzeitpunkts zu verarbeiten.		Einer der größten Unterschiede zu einer SQL-Datenbank ist die Tatsache, dass influxDB speziell darauf ausgelegt ist, große Messdatenmengen in kurzer Zeit zusammen mit einem Zeitstempel des Messzeitpunkts zu verarbeiten.

	Des Weiteren ist ein sehr wichtiger Unterschied, dass nur Werte verarbeitet werden. Dies kann die Kombination mit anderen Loggingmethodiken situationsabhängig sinnvoll machen.		Des Weiteren ist ein sehr wichtiger Unterschied, dass nur numerische Werte verarbeitet werden. Dies kann die Kombination mit anderen Loggingmethodiken situationsabhängig sinnvoll machen. Textbasierte Werte können aber auch durch numerische Werte ersetzt werden.

	Ein Interface oder eine Möglichkeit, die Daten mittels SVG-Plots darzustellen ist derzeit nicht vorhanden. Alternativ können die Daten mittels [[Grafana]] analysiert und visualisiert werden.		Ein Interface oder eine Möglichkeit, die Daten mittels SVG-Plots darzustellen ist derzeit nicht vorhanden. Alternativ können die Daten mittels [[Grafana]] analysiert und visualisiert werden.