InfluxDB

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`).

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)

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