From 53679f81014427e8478ca4b90feb9568b2f64a89 Mon Sep 17 00:00:00 2001
From: Georg Ledermann <georg@ledermann.dev>
Date: Sat, 5 Oct 2024 17:50:13 +0200
Subject: [PATCH] InfluxDB

---
 referenz/influxdb/direktzugriff.md | 22 ++++++++++++++++++++++
 referenz/influxdb/index.md         | 28 +++++++++++++++++++++++++++-
 referenz/influxdb/konfiguration.md |  5 +++++
 3 files changed, 54 insertions(+), 1 deletion(-)
 create mode 100644 referenz/influxdb/direktzugriff.md

diff --git a/referenz/influxdb/direktzugriff.md b/referenz/influxdb/direktzugriff.md
new file mode 100644
index 0000000..cff78e3
--- /dev/null
+++ b/referenz/influxdb/direktzugriff.md
@@ -0,0 +1,22 @@
+---
+title: Direktzugriff
+layout: page
+parent: InfluxDB
+nav_order: 2
+---
+
+# Zugriff auf die Weboberfläche von InfluxDB
+
+Es kann praktisch sein, auf InfluxDB auch direkt zugreifen zu können, um beispielsweise ganz spezielle Abfragen zu machen oder auszugsweise Daten zu exportieren.
+
+InfluxDB bietet dafür eine sehr benutzerfreundliche Weboberfläche, die über den Browser erreichbar ist. Dazu muss der Port `8086` nach außen geöffnet werden, was durch folgende Ergänzung in der `compose.yaml` gelingt:
+
+```yaml
+services:
+  influxdb:
+    # ...
+    ports:
+      - 8086:8086
+```
+
+Der Zugriff erfolgt dann über die URL `http://<IP-Adresse>:8086`. Es erscheint dann ein Login-Formular, in das die Zugangsdaten des Administrators von InfluxDB eingetragen werden müssen. Diese sind in der `.env`-Datei zu finden (`INFLUX_USERNAME` und `INFLUX_PASSWORD`).
diff --git a/referenz/influxdb/index.md b/referenz/influxdb/index.md
index 6f221c1..0b37fd1 100644
--- a/referenz/influxdb/index.md
+++ b/referenz/influxdb/index.md
@@ -5,7 +5,33 @@ parent: Referenz
 nav_order: 10
 ---
 
-SOLECTRUS speichert sämtliche Messwerte in der OpenSource-Zeitreihendatenbank **InfluxDB** ab. Es kommt die aktuelle Version **2.7** zum Einsatz, die Vorgängerversion v1 wird nicht unterstützt.
+# InfluxDB v2
+
+SOLECTRUS speichert sämtliche Messwerte in der OpenSource-Zeitreihendatenbank **InfluxDB** ab. Es kommt die aktuelle Version **2.7** zum Einsatz, die Vorgängerversion v1 wird **nicht** unterstützt.
+
+## Protokollierung
+
+Wie alle Docker-Container schreibt auch InfluxDB ein Protokoll ins Docker-Log, das im Normalfall so aussieht:
+
+```plaintext
+{
+  "bolt-path": "/var/lib/influxdb2/influxd.bolt",
+  "engine-path": "/var/lib/influxdb2/engine",
+  "nats-port": 4222,
+  "http-bind-address": ":9999"
+}
+2024-10-05T15:47:32.	info	booting influxd server in the background	{"system": "docker"}
+ts=2024-10-05T15:47:32.396061Z lvl=info msg="Welcome to InfluxDB" log_id=0s3Lf~fl000 version=v2.7.10 commit=f302d9730c build_date=2024-08-16T20:19:39Z log_level=info
+...
+```
+
+Das Protokoll kann über folgenden Befehl abgerufen werden:
+
+```bash
+docker logs [container-name]
+```
+
+Dass es hier Probleme gibt, ist sehr unwahrscheinlich. Dennoch sollte im Zweifelsfall das Protokoll geprüft werden.
 
 Offizielles Docker-Image: \
 [https://hub.docker.com/\_/influxdb](https://hub.docker.com/_/influxdb)
diff --git a/referenz/influxdb/konfiguration.md b/referenz/influxdb/konfiguration.md
index aa4fce1..34dda5d 100644
--- a/referenz/influxdb/konfiguration.md
+++ b/referenz/influxdb/konfiguration.md
@@ -2,8 +2,13 @@
 title: Konfiguration
 layout: page
 parent: InfluxDB
+nav_order: 1
 ---
 
+# Konfigurieren von InfluxDB
+
+InfluxDB wird üblicherweise in die Gesamtkonfiguration von SOLECTRUS integriert, d.h. die bestehenden Dateien `compose.yaml` und `.env` sind zu erweitern.
+
 ## compose.yaml
 
 ```yaml