Moin,
ich habe heute mal etwas herumgespielt und mir einen Stack gebaut, der jetzt erst einmal so funktioniert, es sind noch Kleinigkeiten, wie z. B. alles über Environment zu steuern, anstatt alles im compose.yml hineinzuschreiben, auch gibt es noch ein Schönheitsfehler, der influxDB Container wird als unhealthy angezeigt, daher können auch die zwei anderen Container nicht gebaut werden, daher ist dieser Test kommentiert.
Die Dokumentation hat mir die KI geschrieben, da bin ich ja faul 
Nachtrag
das Problem mit dem Health Check habe ich gelöst
InfluxDB v3 Core Monitoring Stack – Dokumentation
Diese Dokumentation beschreibt ein lokales Monitoring-Setup unter Verwendung von InfluxDB v3 Core als Zeitreihendatenbank, InfluxDB Data Explorer für Datenexploration und Grafana für Visualisierungen. Daten können von einem externen Telegraf-Agenten (z.B. auf Ihrem Host-PC) an InfluxDB gesendet werden.
1. Überblick der Komponenten
- InfluxDB v3 Core (
influxdb:3-core): Die Time-Series-Datenbank, die für die Speicherung aller Metriken zuständig ist. Lauscht auf Port 8181 (intern und extern).
- InfluxDB Data Explorer (
influxdata/influxdb3-ui:1.0.0): Eine Web-Oberfläche zur direkten Interaktion mit InfluxDB v3, zum Abfragen und Anzeigen von Daten. Erreichbar über Port 8888 auf Ihrem Host.
- Grafana (
grafana/grafana:latest): Eine leistungsstarke Plattform zum Erstellen von Dashboards und Visualisierungen. Erreichbar über Port 3000 auf Ihrem Host.
- Telegraf (extern): Ein Metrik-Collector, der auf Ihrem Host-System läuft und Daten an die InfluxDB-Instanz im Docker-Stack sendet.
2. Verzeichnisstruktur auf dem Host
Stellen Sie sicher, dass die folgenden Verzeichnisse auf Ihrem Host-System existieren, bevor Sie den Stack starten. Diese werden für die persistente Speicherung von Daten und Konfigurationen verwendet, z. B.:
/mnt/docker/appdata/my_tig/
├── influxdb3_data/ # Persistente Daten für InfluxDB v3 Core
├── influxdb3_plugins/ # Plugins für InfluxDB v3 Core (optional)
├── grafana_data/ # Persistente Daten für Grafana (Dashboards, Benutzer etc.)
└── grafana_provisioning/
└── datasources/ # Konfigurationsdateien für Grafana Datenquellen
Erstellen Sie diese Verzeichnisse bei Bedarf:
mkdir -p /mnt/docker/appdata/my_tig/influxdb3_data /mnt/docker/appdata/my_tig/influxdb3_plugins /mnt/docker/appdata/my_tig/grafana_data /mnt/docker/appdata/my_tig/grafana_provisioning/datasources
3. InfluxDB v3 Core Initialisierung
Nach dem allerersten Start der InfluxDB v3 Core Instanz müssen Sie manuell einen Operator-Token erstellen. Dieser Token ist entscheidend für die Authentifizierung aller Clients.
- Starte NUR den InfluxDB-Container:
docker compose up -d influxdb
- Gehe in den Container:
docker exec -it influxdb-v3-core bash
- Erstelle den Operator-Token:
influxdb3 create token --admin
Wichtig: Der hier ausgegebene Token ist Ihr Operator-Token. Kopieren Sie ihn sofort und sorgfältig! Sie benötigen ihn für alle weiteren Schritte.
- Verlasse den Container:
exit
4. Konfiguration der Dienste
Alle Dienste benötigen den von Ihnen erstellten Operator-Token zur Authentifizierung bei InfluxDB.
4.1. docker-compose.yml
Aktualisieren Sie die Platzhalter in der docker-compose.yml mit Ihrem generierten Operator-Token. Die Tokens müssen in den environment-Sektionen der jeweiligen Dienste eingefügt werden.
4.2. Grafana Datenquelle
4.3. Telegraf Konfiguration (telegraf.conf)
Diese Datei wird vom externen Telegraf-Agenten auf Ihrem Host verwendet, um Daten an InfluxDB zu senden.
# Beispiel: Input-Plugin für Systemmetriken
[[inputs.cpu]]
percpu = true
totalcpu = true
fielddrop = ["time_guest", "time_guest_nice", "time_steal"]
[[inputs.mem]]
[[inputs.disk]]
ignore_fs = ["tmpfs", "devtmpfs", "devfs"]
[[inputs.diskio]]
[[inputs.net]]
# Output-Plugin für InfluxDB v2/v3
[[outputs.influxdb_v2]]
urls = ["http://localhost:8181"] # Wenn Telegraf auf dem Host läuft, ist es localhost
token = "tokentokentokentokentokentokentokentokentokentokentokentoken" # Ihr Operator-Token
organization = "my_org" # Ihre Organisation kann man mit Dummy ausfüllen z. B. "telegraf"
bucket = "my_bucket" # Ihr Bucket, ich nehme der Einfachheithalber "telegraf"
5. Starten des Stacks
Nachdem Sie alle Konfigurationen vorgenommen und die Platzhalter durch Ihre tatsächlichen Werte ersetzt haben:
- Bereinigen Sie alte Container und Daten (optional, aber empfohlen bei Problemen):
docker compose down -v
sudo rm -rf /mnt/docker/appdata/my_tig/influxdb3_data/* (falls Sie einen ganz sauberen Start wünschen)
- Starten Sie den gesamten Stack:
docker compose up -d
6. Zugriffs-URLs
- InfluxDB v3 Core UI:
http://ip.vom.docker:8181
- InfluxDB Data Explorer:
http://ip.vom.docker:8888
- Grafana Dashboard:
http://ip.vom.docker:3000 (Standard-Login: admin/admin), bitte gleich ändern!
Docker Compose File (docker-compose.yml)
version: '3.8'
services:
# InfluxDB v3 Core (Single Node)
# Datenbank für Zeitreihendaten
influxdb:
image: influxdb:3-core
container_name: influxdb-v3-core
ports:
- "8181:8181" # Exponiert den InfluxDB HTTP/API-Port
command:
# Startbefehle für InfluxDB v3 Core
- influxdb3
- serve
- --node-id=node0 # Eindeutige ID für diesen einzelnen Knoten
- --object-store=file # Konfiguriert die Speicherung im lokalen Dateisystem
- --data-dir=/var/lib/influxdb3/data # Pfad für die Daten im Container
- --plugin-dir=/var/lib/influxdb3/plugins # Pfad für Plugins im Container
volumes:
# Bind-Mounts für die persistente Speicherung auf dem Host-Verzeichnis
- type: bind
source: /mnt/docker/appdata/my_tig/influxdb3_data
target: /var/lib/influxdb3/data
- type: bind
source: /mnt/docker/appdata/my_tig/influxdb3_plugins
target: /var/lib/influxdb3/plugins
environment:
# Dein Operator Token: UNBEDINGT MIT DEINEM ECHTEN TOKEN ERSETZEN!
- INFLUXDB3_AUTH_TOKEN=tokentokentokentokentokentokentokentokentokentokentokentokentokentokentokentokentokentokentokentoken
healthcheck:
# Healthcheck sendet den Token im Authorization Header mit, da /health Authentifizierung benötigt, dazu aber nicht die Variable nutzen, sonder nden Token direkt eintragen!
test: ["CMD-SHELL", "curl -f -H 'Authorization: Bearer tokentokentokentokentokentokentokentokentokentokentokentokentokentokentoken' http://localhost:8181/health || exit 1"]
interval: 10s
timeout: 5s
retries: 5
start_period: 90s # Lange Startphase, um InfluxDB Zeit zum Initialisieren zu geben
networks:
- monitoring_net
# InfluxDB Data Explorer
# Web-UI zur Interaktion mit InfluxDB v3 Daten
influxdb-explorer:
image: influxdata/influxdb3-ui:1.0.0 # Offizielles Image für InfluxDB 3 UI
container_name: influxdb-data-explorer
ports:
- "8888:80" # Host 8888 auf Container 80 mappen, wie in der Doku
command: ["--mode=admin"] # Startet den Explorer im Admin-Modus
environment:
# Konfiguration der Verbindung zum InfluxDB v3 Core
- INFLUXDB_URL=http://influxdb:8181 # URL des InfluxDB-Dienstes im Docker-Netzwerk
- INFLUXDB_VERSION=3 # Informiert den Explorer über die InfluxDB-Version
# Token für den Explorer: UNBEDINGT MIT DEINEM ECHTEN TOKEN ERSETZEN!
- INFLUXDB_TOKEN=tokentokentokentokentokentokentokentokentokentokentokentokentokentokentokentokentokentokentokentoken
depends_on:
# Abhängigkeit vom InfluxDB-Container, wartet nur bis dieser gestartet ist
# (Service Healthy könnte zu Problemen führen, wenn Healthcheck instabil ist)
influxdb:
condition: service_started
networks:
- monitoring_net
# Grafana
# Dashboard- und Visualisierungsplattform
grafana:
image: grafana/grafana:latest # Offizielles Grafana-Image
container_name: grafana
ports:
- "3033:3000" # Exponiert den Grafana Web-UI-Port (Host 3033 auf Container 3000)
volumes:
# Bind-Mount für die persistenten Grafana-Daten
- type: bind
source: /mnt/docker/appdata/my_tig/grafana_data
target: /var/lib/grafana
# Bind-Mount für das Grafana Provisioning (Datenquellen, Dashboards etc.)
- type: bind
source: /mnt/docker/appdata/my_tig/grafana_provisioning
target: /etc/grafana/provisioning
environment:
# Standard-Admin-Zugangsdaten (BITTE IN PRODUKTION ÄNDERN!)
- GF_SECURITY_ADMIN_USER=admin
- GF_SECURITY_ADMIN_PASSWORD=admin
- GF_USERS_ALLOW_SIGN_UP=false # Deaktiviert die Benutzerregistrierung
depends_on:
# Abhängigkeit vom InfluxDB-Container, wartet nur bis dieser gestartet ist
influxdb:
condition: service_started
networks:
- monitoring_net
# Docker Netzwerke für die interne Kommunikation der Dienste
networks:
monitoring_net:
driver: bridge # Standard-Bridge-Netzwerk
by HarryP: