Homelab-Monitoring: Uptime-Kuma & Grafana selbst gehostet

Wer ein Homelab betreibt, kennt das Gefühl: Man bemerkt erst Tage später, dass ein Dienst ausgefallen ist – weil der Pi-Hole-Werbeblocker stillsteht oder das NAS-Update die Platte an ihre Grenze bringt. Genau hier setzt Monitoring an. Es macht aus deinem Heim-Server eine beobachtbare Infrastruktur: Du siehst auf einen Blick, ob alle Dienste laufen, wie ausgelastet die Hardware ist und ob sich ein Problem anbahnt, bevor es dich wirklich trifft. Zwei Tools haben sich dabei als Standard etabliert: Uptime-Kuma für die Erreichbarkeit und Grafana mit Prometheus für Metriken und Dashboards.

Warum Monitoring im Homelab?

Ein Homelab wächst schnell: Proxmox, Docker-Container, Nextcloud, Jellyfin, Home Assistant – irgendwann laufen ein Dutzend Dienste gleichzeitig, und keiner schickt dir Bescheid, wenn er stirbt. Monitoring schließt diese Lücke:

• Ausfälle früh erkennen: Statt den Ausfall selbst zu bemerken, meldet sich das System proaktiv.
• Kapazität planen: Du siehst, wann RAM oder Festplatte knapp werden, und kannst rechtzeitig erweitern.
• Ursachen eingrenzen: Bei Problemen zeigen Verlaufsdaten, was sich kurz zuvor geändert hat.
• Ruhig schlafen: Wer weiß, dass alles überwacht wird, muss nicht ständig manuell nachschauen.

Das Schöne daran: Beide Werkzeuge laufen als Docker-Container und sind in wenigen Minuten einsatzbereit.

Uptime-Kuma: Erreichbarkeit und Status im Blick

Uptime-Kuma ist ein schlankes Monitoring-Tool mit übersichtlicher Web-Oberfläche. Es prüft in einstellbaren Abständen, ob deine Dienste antworten – per HTTP(S), Ping, TCP-Port oder sogar auf den Inhalt einer Webseite hin. Fällt ein Dienst aus, schlägt es Alarm; ist er wieder da, meldet es Entwarnung.

Der große Vorteil gegenüber ausgewachsenen Systemen wie Nagios oder Zabbix: die Einfachheit. Ein Monitor ist in unter einer Minute angelegt, und eine Statusseite zeigt grün/rot auf einen Blick. Du kannst Uptime-Kuma zudem als öffentliche Statusseite freigeben – praktisch, wenn Familie oder Freunde auf deine Dienste zugreifen.

Typische Monitore im Homelab:

• Webdienste: Nextcloud, Jellyfin oder die Portainer-Oberfläche per HTTPS-Request.
• Netzwerkgeräte: Router, Switch oder der Drucker per Ping.
• Datenbanken oder SSH: Per TCP-Port-Check auf den jeweiligen Port.
• Zertifikate: Uptime-Kuma überwacht auch SSL-Zertifikate und warnt vor dem Ablauf.

Grafana + Prometheus: Metriken und Dashboards

Uptime-Kuma beantwortet die Frage „läuft es oder nicht?". Prometheus und Grafana beantworten „wie gut läuft es?". Das Duo sammelt Zahlenwerte – Metriken – und stellt sie als ansprechende Diagramme dar.

• Prometheus ist die Datenbank: Sie fragt in festen Intervallen definierte Ziele ab (Scraping) und speichert die Messwerte als Zeitreihen.
• Grafana ist die Anzeige: Es liest die Daten aus Prometheus und baut daraus Dashboards mit Graphen, Balken und Alarm-Schwellwerten.

Der Einstieg gelingt am schnellsten mit Node Exporter, einem kleinen Agenten, der auf jedem Rechner läuft und CPU-, RAM-, Festplatten- und Netzwerk-Metriken bereitstellt. Für Docker-Container liefert cAdvisor zusätzlich Auslastungswerte je Container. Beide bindet Prometheus als Ziel ein; fertige Grafana-Dashboards aus der Community importierst du mit wenigen Klicks per ID.

Installation per Docker

Alle Komponenten lassen sich bequem mit Docker Compose aufsetzen. Ein kompakter Einstieg:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:latest
    ports:
      - "3001:3001"
    volumes:
      - uptime-kuma-data:/app/data
    restart: unless-stopped

  prometheus:
    image: prom/prometheus:latest
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
      - prometheus-data:/prometheus
    restart: unless-stopped

  grafana:
    image: grafana/grafana:latest
    ports:
      - "3000:3000"
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=geheim
    volumes:
      - grafana-data:/var/lib/grafana
    restart: unless-stopped

volumes:
  uptime-kuma-data:
  prometheus-data:
  grafana-data:

Anschließend startest du alles mit docker compose up -d. Uptime-Kuma erreichst du dann unter http://dein-server:3001, Grafana unter http://dein-server:3000 und Prometheus unter http://dein-server:9090. In der Prometheus-Konfiguration trägst du den Node Exporter als Ziel ein, in Grafana verbindest du Prometheus als Datenquelle.

Was du überwachen solltest

Die wichtigsten Werte im Blick zu behalten, ist keine Zauberei. Diese fünf Metriken decken die häufigsten Ausfallursachen ab:

• CPU-Auslastung: Dauerhaft hohe Werte deuten auf eine überforderte Maschine oder einen ausgerutschten Prozess hin.
• RAM-Nutzung: Volllaufender Arbeitsspeicher führt zu Auslagerung und spürbar langsamen Diensten.
• Festplattenplatz: Die häufigste Ursache für stillstehende Dienste – ein volles Laufwerk stoppt Datenbanken und Logs.
• Temperaturen: Bei Mini-PCs und Servern lohnt ein Blick auf die CPU-Temperatur, bevor sie drosselt.
• Dienststatus: Ob ein Container läuft, erfasst Prometheus ebenfalls; Uptime-Kuma prüft zusätzlich die Erreichbarkeit von außen.

Benachrichtigungen: Telegram und E-Mail

Monitoring ist nur so gut wie der Moment, in dem es dich erreicht. Sowohl Uptime-Kuma als auch Grafana bringen eine breite Palette an Benachrichtigungskanälen mit – am beliebtesten sind Telegram und E-Mail.

Telegram ist im Homelab erste Wahl: Ein Bot lässt sich in zwei Minuten über den BotFather anlegen, und Nachrichten kommen sekundenschnell und kostenlos aufs Smartphone. In Uptime-Kuma hinterlegst du Bot-Token und Chat-ID einmalig und wählst sie dann pro Monitor als Benachrichtigung aus.

E-Mail eignet sich als zweiter Kanal oder für weniger dringende Meldungen. Uptime-Kuma und Grafana unterstützen SMTP direkt; viele Homelab-Betreiber leiten E-Mails zusätzlich über einen lokalen Relay weiter, damit sie das Hausnetz nicht verlassen.

Ein Tipp: Konfiguriere Benachrichtigungen von Anfang an mit. Ein Monitoring, das niemanden informiert, verfehlt seinen Zweck – und eine Testbenachrichtigung beim Einrichten zeigt dir sofort, ob der Kanal funktioniert.

Fazit

Monitoring macht dein Homelab zuverlässiger, ohne dass es kompliziert sein muss: Uptime-Kuma überwacht die Erreichbarkeit deiner Dienste, Prometheus und Grafana liefern tiefe Einblicke in Auslastung und Trends – und beides läuft in wenigen Minuten als Docker-Container. Wer Benachrichtigungen per Telegram oder E-Mail von Anfang an einrichtet, erfährt von Problemen künftig früher als seine Nutzer. Damit gehört das Monitoring zur kleinen Investition mit großer Wirkung in jedem ernsthaften Homelab.