Professionelles Monitoring Setup 2025

Ich betreibe seit 2019 mehrere Server (Raspberry Pis, VPS, Dedicated Server) und hatte alle klassischen Probleme:

• 2020: Raspberry Pi überhitzt regelmäßig im Sommer → Hätte ich mit Temp-Monitoring sofort gesehen
• 2021: WordPress-Site wird langsam über Wochen → MySQL slow queries, aber erst nach User-Beschwerden erkannt
• 2022: Docker-Container läuft voll, lädt aber weiter Daten → Festplatte nach 3 Tagen voll
• 2023: API-Response-Zeiten verdoppeln sich schleichend → Erst nach Monitoring-Setup erkannt: Database-Connection-Pool zu klein

Das Muster: Alle Probleme waren schleichend und hätten mit Monitoring Wochen früher erkannt werden können.

Gute Frage! Prometheus ist definitiv der Standard in der Kubernetes-Welt. Aber für kleinere Setups (1-10 Server) hat der TIG-Stack einige Vorteile:

Meine Empfehlung: TIG für Homelab/kleinere Setups, Prometheus für Production/Kubernetes.

# Hauptverzeichnis für Monitoring-Stack
mkdir -p ~/monitoring/{influxdb,telegraf,grafana}
cd ~/monitoring

# InfluxDB Datenverzeichnisse
mkdir -p influxdb/{data,config}

# Konfigurationsverzeichnisse
mkdir -p telegraf/config
mkdir -p grafana/{data,dashboards,provisioning}

# Berechtigungen setzen (wichtig für Container!)
sudo chown -R 1000:1000 ~/monitoring
chmod -R 755 ~/monitoring

# Struktur prüfen
sudo apt install tree
tree ~/monitoring
# monitoring/
# ├── influxdb/
# │   ├── data/
# │   └── config/
# ├── telegraf/
# │   └── config/
# └── grafana/
#     ├── data/
#     ├── dashboards/
#     └── provisioning/

# ~/monitoring/docker-compose.yml erstellen
cat > docker-compose.yml << 'EOF'
version: '3.8'

services:
  influxdb:
    image: influxdb:2.7-alpine
    container_name: influxdb
    restart: unless-stopped
    ports:
      - "8086:8086"
    volumes:
      - ./influxdb/data:/var/lib/influxdb2
      - ./influxdb/config:/etc/influxdb2
    environment:
      # Initial Setup - WICHTIG: Nur beim ersten Start
      - DOCKER_INFLUXDB_INIT_MODE=setup
      - DOCKER_INFLUXDB_INIT_USERNAME=admin
      - DOCKER_INFLUXDB_INIT_PASSWORD=monitoring2025!
      - DOCKER_INFLUXDB_INIT_ORG=homelab
      - DOCKER_INFLUXDB_INIT_BUCKET=metrics
      - DOCKER_INFLUXDB_INIT_RETENTION=365d
      - DOCKER_INFLUXDB_INIT_ADMIN_TOKEN=super-secret-auth-token-change-me
    networks:
      - monitoring

networks:
  monitoring:
    driver: bridge
EOF

# InfluxDB starten
docker compose up -d influxdb

# Container-Status prüfen
docker compose ps
# Sollte zeigen: influxdb running

# Logs prüfen - wichtig für Troubleshooting
docker compose logs influxdb

# InfluxDB UI öffnen
Öffne: http://YOUR-SERVER-IP:8086
Login: admin / monitoring2025! (was du natürlich anpassen solltest!)

# CLI-Test (optional)
docker exec -it influxdb influx auth list
# Sollte deinen Token zeigen

Retention Policy: 365 Tage

Warum 1 Jahr? Für Monitoring brauchst du längere Trends. Beispiele aus der Praxis:

• Saisonale Patterns: Website-Traffic im Dezember vs. Januar
• Hardware-Trends: RAM-Verbrauch steigt über Monate
• Kapazitätsplanung: „Wann ist die Festplatte voll?“ → Trend über 6 Monate

Alpine Image: Ressourcenschonend

InfluxDB 2.7-alpine anstelle eines Standard-Images: Nur 150MB Speicherverbrauch statt 300MB. Besonders wichtig bei Raspberry Pi oder VPS mit begrenztem RAM.

# ~/monitoring/telegraf/config/telegraf.conf
cat > ~/monitoring/telegraf/config/telegraf.conf << 'EOF'
[global_tags]
  # Wichtig: Eindeutige Identifikation des Servers
  host = "$HOSTNAME"
  datacenter = "homelab"

[agent]
  interval = "10s"          # Alle 10 Sekunden sammeln
  round_interval = true     # Auf volle 10s runden (wichtig für Grafana!)
  metric_batch_size = 1000  # Batch-Größe für bessere Performance
  metric_buffer_limit = 10000
  collection_jitter = "0s"  # Kein Jitter bei einzelnem Host
  flush_interval = "10s"    # Sofort an InfluxDB senden
  flush_jitter = "0s"

# OUTPUT: Verbindung zu InfluxDB
[[outputs.influxdb_v2]]
  urls = ["http://influxdb:8086"]
  token = "super-secret-auth-token-change-me"  # Dein InfluxDB Token
  organization = "homelab"
  bucket = "metrics"
  timeout = "5s"

# INPUT 1: System-Metriken (CPU, RAM, Disk)
[[inputs.cpu]]
  percpu = true             # Pro CPU-Core einzeln
  totalcpu = true          # + Gesamt-CPU
  collect_cpu_time = false # CPU-Zeit brauchen wir nicht
  report_active = false    # Active/Idle-Ratio nicht nötig

[[inputs.disk]]
  ignore_fs = ["tmpfs", "devtmpfs", "devfs", "iso9660", "overlay", "aufs", "squashfs"]
  # Nur echte Filesysteme, nicht temporäre

[[inputs.diskio]]
  # Disk I/O ist oft der Flaschenhals
  
[[inputs.kernel]]
  # Kernel-Statistiken

[[inputs.mem]]
  # RAM-Verbrauch

[[inputs.processes]]
  # Anzahl Prozesse

[[inputs.swap]]
  # Swap-Verbrauch (wichtig bei wenig RAM)

[[inputs.system]]
  # System Load, Uptime etc.

# INPUT 2: CPU-Temperatur (wichtig für Raspberry Pi & Co.)
[[inputs.file]]
  files = ["/sys/class/thermal/thermal_zone0/temp"]
  name_override = "cpu_temperature"
  data_format = "value"
  data_type = "integer"

[[inputs.exec]]
  # Für ein 32bit System (welches überwacht werden soll)
  commands = ["/opt/vc/bin/vcgencmd measure_temp"]
  # Oder für ein 64bit System (welches überwacht werden soll), dann die Raute(#) entfernen und bei 32bit die Raute hinzufügen
  # commands = ["/usr/bin/vcgencmd measure_temp"]
  name_override = "cpu_temperature"
  data_format = "value"
  data_type = "string"

# INPUT 3: Netzwerk
[[inputs.net]]
  interfaces = ["eth*", "en*", "wlan*"]  # Nur echte Interfaces
  ignore_protocol_stats = false

[[inputs.netstat]]
  # TCP-Verbindungen

# INPUT 4: Docker (wenn vorhanden)
[[inputs.docker]]
  endpoint = "unix:///var/run/docker.sock"
  gather_services = false  # Services nicht nötig
  container_names = []     # Alle Container
  container_name_include = []
  container_name_exclude = []
  timeout = "5s"
  perdevice = true        # Per Container einzeln
  total = false           # Gesamt nicht nötig
EOF

# ~/monitoring/docker-compose.yml erweitern
# WICHTIG: Stelle sicher, dass die Einrückung korrekt ist!

cat >> ~/monitoring/docker-compose.yml << 'EOF'

  telegraf:
    image: telegraf:1.28-alpine
    container_name: telegraf
    restart: unless-stopped
    volumes:
      # Konfiguration
      - ./telegraf/config/telegraf.conf:/etc/telegraf/telegraf.conf:ro
      # Host-System-Zugriff für Metriken
      - /:/hostfs:ro
      - /etc:/hostfs/etc:ro
      - /proc:/hostfs/proc:ro
      - /sys:/hostfs/sys:ro
      - /var:/hostfs/var:ro
      - /run:/hostfs/run:ro
      # Docker-Socket für Container-Metriken
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      # Wichtig: Host-Pfade für System-Metriken
      - HOST_ETC=/hostfs/etc
      - HOST_PROC=/hostfs/proc
      - HOST_SYS=/hostfs/sys
      - HOST_VAR=/hostfs/var
      - HOST_RUN=/hostfs/run
      - HOST_MOUNT_PREFIX=/hostfs
    networks:
      - monitoring
    depends_on:
      - influxdb
    user: telegraf:docker  # Docker-Gruppe für Socket-Zugriff
EOF

# Alternative: Vollständige docker-compose.yml erstellen
# Falls das Append nicht funktioniert, erstelle die Datei komplett neu:
cat > ~/monitoring/docker-compose.yml << 'EOF'
version: '3.8'

services:
  influxdb:
    image: influxdb:2.7-alpine
    container_name: influxdb
    restart: unless-stopped
    ports:
      - "8086:8086"
    volumes:
      - ./influxdb/data:/var/lib/influxdb2
      - ./influxdb/config:/etc/influxdb2
    environment:
      - DOCKER_INFLUXDB_INIT_MODE=setup
      - DOCKER_INFLUXDB_INIT_USERNAME=admin
      - DOCKER_INFLUXDB_INIT_PASSWORD=monitoring2025!
      - DOCKER_INFLUXDB_INIT_ORG=homelab
      - DOCKER_INFLUXDB_INIT_BUCKET=metrics
      - DOCKER_INFLUXDB_INIT_RETENTION=365d
      - DOCKER_INFLUXDB_INIT_ADMIN_TOKEN=super-secret-auth-token-change-me
    networks:
      - monitoring

  telegraf:
    image: telegraf:1.28-alpine
    container_name: telegraf
    restart: unless-stopped
    volumes:
      - ./telegraf/config/telegraf.conf:/etc/telegraf/telegraf.conf:ro
      - /:/hostfs:ro
      - /etc:/hostfs/etc:ro
      - /proc:/hostfs/proc:ro
      - /sys:/hostfs/sys:ro
      - /var:/hostfs/var:ro
      - /run:/hostfs/run:ro
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      - HOST_ETC=/hostfs/etc
      - HOST_PROC=/hostfs/proc
      - HOST_SYS=/hostfs/sys
      - HOST_VAR=/hostfs/var
      - HOST_RUN=/hostfs/run
      - HOST_MOUNT_PREFIX=/hostfs
    networks:
      - monitoring
    depends_on:
      - influxdb
    user: telegraf:docker

networks:
  monitoring:
    driver: bridge
EOF

Telegraf hat 200+ Input-Plugins. Aber 90% brauchst du nie. Hier meine Erfahrung aus 5 Jahren:

# Telegraf starten
cd ~/monitoring
docker compose up -d telegraf

# Logs prüfen - wichtig!
docker compose logs telegraf
# Sollte zeigen: "Starting Telegraf " und keine Errors

# Verbindung zu InfluxDB prüfen
docker compose logs telegraf | grep "Error"
# Sollte NICHTS zeigen

# Container-Status
docker compose ps
# Beide Container sollten "Up" sein

# Quick-Test: Daten in InfluxDB angekommen?
docker exec -it influxdb influx query 'from(bucket:"metrics") |> range(start:-1m) |> limit(n:5)'
# Sollte aktuelle Metriken zeigen

# ~/monitoring/docker-compose.yml - Vollständige Version
# WICHTIG: Korrekte YAML-Einrückung verwenden!

cat > ~/monitoring/docker-compose.yml << 'EOF'
services:
  influxdb:
    image: influxdb:2.7-alpine
    container_name: influxdb
    restart: unless-stopped
    ports:
      - "8086:8086"
    volumes:
      - ./influxdb/data:/var/lib/influxdb2
      - ./influxdb/config:/etc/influxdb2
    environment:
      - DOCKER_INFLUXDB_INIT_MODE=setup
      - DOCKER_INFLUXDB_INIT_USERNAME=admin
      - DOCKER_INFLUXDB_INIT_PASSWORD=monitoring2025!
      - DOCKER_INFLUXDB_INIT_ORG=homelab
      - DOCKER_INFLUXDB_INIT_BUCKET=metrics
      - DOCKER_INFLUXDB_INIT_RETENTION=365d
      - DOCKER_INFLUXDB_INIT_ADMIN_TOKEN=super-secret-auth-token-change-me
    networks:
      - monitoring

  telegraf:
    image: telegraf:1.28-alpine
    container_name: telegraf
    restart: unless-stopped
    volumes:
      - ./telegraf/config/telegraf.conf:/etc/telegraf/telegraf.conf:ro
      - /:/hostfs:ro
      - /etc:/hostfs/etc:ro
      - /proc:/hostfs/proc:ro
      - /sys:/hostfs/sys:ro
      - /var:/hostfs/var:ro
      - /run:/hostfs/run:ro
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      - HOST_ETC=/hostfs/etc
      - HOST_PROC=/hostfs/proc
      - HOST_SYS=/hostfs/sys
      - HOST_VAR=/hostfs/var
      - HOST_RUN=/hostfs/run
      - HOST_MOUNT_PREFIX=/hostfs
    networks:
      - monitoring
    depends_on:
      - influxdb
    user: telegraf:docker

  grafana:
    image: grafana/grafana:10.2.2
    container_name: grafana
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./grafana/data:/var/lib/grafana
      - ./grafana/provisioning:/etc/grafana/provisioning
    environment:
      # Security: Default-Admin ändern
      - GF_SECURITY_ADMIN_USER=admin
      - GF_SECURITY_ADMIN_PASSWORD=grafana2025!
      # Performance: Memory-Limits
      - GF_SERVER_ROOT_URL=http://localhost:3000
      - GF_ANALYTICS_REPORTING_ENABLED=false
      - GF_ANALYTICS_CHECK_FOR_UPDATES=false
      # Security: Anonymous Access disabled
      - GF_AUTH_ANONYMOUS_ENABLED=false
    networks:
      - monitoring
    depends_on:
      - influxdb
    user: "472:472"  # Grafana User/Group

networks:
  monitoring:
    driver: bridge
EOF

# Grafana-Verzeichnisse erstellen und Permissions setzen
mkdir -p ~/monitoring/grafana/data
mkdir -p ~/monitoring/grafana/provisioning

# Permissions für Grafana setzen (wichtig!)
sudo chown -R 472:472 ~/monitoring/grafana/data
sudo chown -R 472:472 ~/monitoring/grafana/provisioning

# Vollständiger Stack starten
docker compose down
docker compose up -d

# Alle Container prüfen
docker compose ps
# Sollte zeigen: influxdb, telegraf, grafana alle "Up"

Regel: In 5 Sekunden muss klar sein: "Läuft alles normal oder gibt es ein Problem?"