homelab-infra/ops/grafana-influxdb/README.md

Grafana + InfluxDB 3 Core

Vorbereiteter Monitoring-Stack. Noch nicht deployen, bis die Secrets und der erste InfluxDB-Token sauber angelegt sind.

Quellen / Entscheidungen

• Grafana nutzt das offizielle OSS-Image grafana/grafana:12.4.3.
• InfluxDB nutzt influxdb:3.9.1-core, nicht latest, weil latest bei InfluxDB aktiv in Richtung InfluxDB 3 umgestellt wird.
• Grafana wird ueber Traefik + authelia@file,secure-headers@file unter grafana.kaleschke.info veroeffentlicht.
• InfluxDB bleibt ohne direkten Host-Port und ohne Traefik-Route im internen Compose-Netz grafana_influx_internal.
• Grafana provisioning legt eine SQL-Datenquelle fuer InfluxDB 3 Core mit der Datenbank homelab an.

Vor dem ersten Deploy

1. Secret fuer Grafana anlegen:

   install -m 600 /dev/null /mnt/user/appdata/secrets/grafana_admin_password.txt
   

2. Offline-Admin-Token fuer InfluxDB 3 als JSON anlegen:

   {
     "token": "apiv3_REPLACE_WITH_STRONG_RANDOM_TOKEN",
     "name": "admin",
     "description": "Admin token for KalliLab InfluxDB 3 Core"
   }
   

   Pfad: /mnt/user/appdata/secrets/influxdb3_admin_token.json, Rechte 600.

3. In Komodo fuer den Stack GRAFANA_INFLUXDB_TOKEN setzen. Fuer den Start kann das derselbe Token aus influxdb3_admin_token.json sein; sauberer ist spaeter ein eigener Read-Token fuer Grafana.

4. Nach dem ersten Start die Datenbank anlegen:

   docker exec influxdb3-core influxdb3 create database homelab --token "$INFLUXDB3_AUTH_TOKEN"
   

Smoke-Test nach Deploy

• https://grafana.kaleschke.info oeffnet nach Authelia die Grafana-Loginseite.
• Grafana Connections -> Data sources -> InfluxDB 3 Core -> Save & test ist erfolgreich.
• InfluxDB bleibt von aussen nicht direkt erreichbar.

Rollback

• Stack in Komodo stoppen oder Git auf den letzten Stand ohne ops/grafana-influxdb zuruecknehmen.
• Persistente Daten liegen unter /mnt/user/appdata/grafana und /mnt/user/appdata/influxdb3; nicht automatisch loeschen.