Homelab aufbauen – Teil 4: Monitoring mit Grafana, Prometheus und Uptime Kuma

Aktualisiert am 20.10.2026 · Lesezeit ca. 5 Min. · Niveau: Fortgeschrittene · von Viktor Tribus, IT-Tribus Nideggen

In den vorangegangenen Teilen dieser Serie haben wir die Grundlagen für Ihr Homelab gelegt. In Teil 3: Netzwerk-Segmentierung mit OPNsense haben wir das Netzwerk aufbereitet und sicher gemacht. Nun ist es an der Zeit, die Überwachung einzurichten, um ein optimales Monitoring Ihrer Infrastruktur zu gewährleisten. In diesem Teil werden wir Grafana und Prometheus einrichten, um eine vollständige Überwachungsstack für Ihr Homelab aufzubauen.

Monitoring ist essentiell, um den Zustand Ihrer Systeme kontinuierlich zu überwachen. Es hilft Ihnen, Probleme frühzeitig zu erkennen und zu beheben, bevor sie zu ernsthaften Ausfällen führen können. Grafana ermöglicht es Ihnen, präzise Dashboards mit interaktiven Visualisierungen für Ihre Prometheus-Daten zu erstellen. Dies vereinfacht die Analyse von Metriken und erleichtert das Erkennen von Trends und Anomalien.

Um Monitoring in Ihrem Homelab einzurichten, benötigen Sie folgende Voraussetzungen:

• Proxmox VE: Stellen Sie sicher, dass Proxmox VE installiert ist (Teil 1).
• Virtuelle Maschinen und LXC-Container: Erstellen Sie virtuelle Maschinen und LXC-Container (Teil 2).
• OPNsense: Ein Netzwerk-Segmentierung mit OPNsense muss bereits eingerichtet sein (Teil 3).
• Docker: Docker sollte installiert sein, um Prometheus und Grafana zu hosten.
• Admin-Rechte: Sie benötigen Administratorrechte auf Ihren Systemen.
• Bash-Terminal oder Windows PowerShell: Verfügbare Shell für Kommandozeilenbefehle.

Prüfen Sie, ob Docker installiert ist:

sudo docker --version
REM (Windows)
docker version

Erstellen Sie eine docker-compose.yml-Datei für Prometheus und Grafana.

# docker-compose.yml
version: '3'
services:
  prometheus:
    image: prom/prometheus:v2.0.0
    container_name: prometheus
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus:/etc/prometheus

  grafana:
    image: grafana/grafana:latest
    container_name: grafana
    ports:
      - "3000:3000"

Erstellen Sie eine prometheus.yml-Datei im Verzeichnis ./prometheus.

# prometheus.yml
global:
  scrape_interval: 15s

scrape_configs:
  - job_name: 'prometheus'
    static_configs:
      - targets: ['localhost:9090']

Starten Sie die Docker-Container:

docker-compose up -d
REM (Windows)
.\docker-compose.exe up -d

Öffnen Sie Grafana in Ihrem Browser unter http://localhost:3000 und konfigurieren Sie Ihren Admin-Account.

In Grafana, fügen Sie Prometheus als Datenquelle hinzu:

1. Klicken Sie auf „Configuration“ → „Data Sources“.
2. Wählen Sie „Prometheus“ aus der Liste.
3. Konfigurieren Sie die URL zu Ihrem Prometheus-Server (http://localhost:9090).
4. Speichern und überprüfen Sie die Datenquelle.

Erstellen Sie Dashboards, um Ihre Metriken zu visualisieren:

1. Klicken Sie auf „Create“ → „Dashboard“.
2. Fügen Sie Panels hinzu, indem Sie „Add panel“ wählen.
3. Konfigurieren Sie die Abfragen und Visualisierungen in den Panels.

Setzen Sie Alarms für kritische Metriken:

1. Navigieren Sie zu „Configuration“ → „Alerting“.
2. Erstellen Sie neue Alerts mit entsprechenden Regeln.
3. Konfigurieren Sie die Notifikationskanäle (z.B. E-Mail).

So prüfen Sie, ob es geklappt hat: Überprüfen Sie das Dashboard in Grafana und stellen Sie sicher, dass alle Metriken korrekt angezeigt werden.

Ursache: Die Prometheus-URL ist falsch konfiguriert.

Lösung:

# Überprüfen der Konfiguration
cat ./prometheus/prometheus.yml
REM (Windows)
type .\prometheus\prometheus.yml

Ursache: Die Datenquelle ist nicht korrekt konfiguriert.

Lösung:

1. Überprüfen Sie die Konfiguration der Datenquelle.
2. Führen Sie den Test durch, um die Verbindung zu überprüfen.

Ursache: Die prometheus.yml ist fehlerhaft konfiguriert.

Lösung:

# Überprüfen der Konfiguration
cat ./prometheus/prometheus.yml
REM (Windows)
type .\prometheus\prometheus.yml

Ursache: Die Abfragen in den Panels sind fehlerhaft.

Lösung:

1. Überprüfen Sie die Abfrage in jedem Panel.
2. Stellen Sie sicher, dass die Metriken korrekt konfiguriert sind.

Um die Änderungen rückgängig zu machen:

# Container stoppen und entfernen
docker-compose down --volumes
REM (Windows)
.\docker-compose.exe down --volumes

Dadurch werden alle Container gestoppt und deren Volumen gelöscht.

Antwort: Konfigurieren Sie zusätzliche Scrape-Targets in der prometheus.yml-Datei und erstellen Sie neue Panels in Grafana für die entsprechenden Metriken.

Antwort: Ja, Uptime Kuma kann als Ergänzung zu Prometheus und Grafana verwendet werden. Es bietet eine einfache Möglichkeit, Dienste aufzurufen und deren Verfügbarkeit zu überwachen.

Antwort: Aktivieren Sie SSL für den Webserver von Grafana und konfigurieren Sie die Authentifizierung mit einer externen Anmeldeinformationssystem, wie LDAP oder SAML.

Antwort: Prometheus sammelt Metriken aus verschiedenen Quellen, während Grafana diese Daten visualisiert. Prometheus ist das Monitoring-Tool, Grafana dient zur Darstellung dieser Daten in Dashboards.

Antwort: Ja, Sie können beide Tools auch manuell installieren. Allerdings bietet Docker eine einfache Möglichkeit, die Services zu verwalten und zu skalieren.

In dieser Serie haben wir Ihnen Schritt für Schritt gezeigt, wie Sie Ihr Homelab aufbauen:

1. Hardware auswählen und Proxmox VE installieren (Teil 1).
2. Virtuelle Maschinen und LXC-Container anlegen (Teil 2).
3. Netzwerk-Segmentierung mit OPNsense (Teil 3).
4. Monitoring mit Grafana, Prometheus und Uptime Kuma (Teil 4).

Durch die Umsetzung dieser Schritte haben Sie eine robuste und überwachte Homelab-Infrastruktur aufgebaut. Sollten Sie Unterstützung benötigen oder weiterführende Fragen haben, steht IT-Tribus in Nideggen Ihnen gerne zur Verfügung.

• Homelab #11: Observability with Prometheus and Grafana – secnate.medium.com
• Home Lab Monitoring with Grafana and Prometheus – homelabstarter.com
• Self-hosted Monitoring: von Netdata über Grafana bis Beszel – denshub.com
• Technical documentation – grafana.com
• Homelab monitoring using Grafana and Prometheus – danielpecos.com
• How to Set Up Grafana and Prometheus for Homelab Monitoring – readthemanual.co.uk

Hinweis: Dieser Beitrag wurde am 20.10.2026 mit KI-Unterstützung erstellt, auf Basis der genannten Quellen eigenständig formuliert und redaktionell von IT-Tribus betreut. Alle Angaben ohne Gewähr – bitte prüfen Sie Befehle vor dem Einsatz in produktiven Umgebungen und legen Sie vorher eine Sicherung an.