SMART-Monitoring im Homelab: smartctl_exporter + Prometheus einrichten

Kurz gesagt: Ein einzelner Container (smartctl_exporter) macht die SMART-Werte aller Laufwerke für Prometheus abgreifbar — Temperaturen, Abnutzung, Fehlerzähler, Laufzeit. Aufsetzen dauert eine Viertelstunde; die eigentliche Arbeit steckt darin, fehlende Werte richtig zu interpretieren: fehlender Wert ≠ Fehler.

SMART (Self-Monitoring, Analysis and Reporting Technology) ist die Selbstdiagnose, die praktisch jede Festplatte und SSD eingebaut hat. Einmalig auslesen kann man sie mit smartctl — Befehle dafür baust du dir im smartctl Command Builder zusammen. Dieser Guide geht den Schritt weiter: SMART dauerhaft aufzeichnen, damit du Trends siehst und gewarnt wirst, bevor eine Platte stirbt.

Das Setup hier ist genau so am 25.08.2026 auf unserem Homeserver (Debian 13, System-NVMe + USB-Datenplatte) in Betrieb gegangen — inklusive der Stolpersteine, die dabei aufkamen.

Voraussetzungen #

• Ein Linux-Host mit Docker (z. B. dein ausgemusterter PC als Homeserver)
• Ein laufendes Prometheus — oder die Bereitschaft, eins mitzustarten
• Kein Prometheus im Einsatz? Für die meisten Homelabs ist der Monitoring-Stack aus Uptime Kuma + Beszel der einfachere Einstieg; Beszel zeigt Disk-Werte, aber keine SMART-Details.

smartctl_exporter per Docker Compose #

Der smartctl_exporter der Prometheus-Community fragt alle Laufwerke zyklisch ab und stellt die Werte auf Port 9633 bereit:

# ~/homelab/smartctl-exporter/compose.yaml
services:
  smartctl-exporter:
    image: prometheuscommunity/smartctl-exporter:v0.14.0
    container_name: smartctl-exporter
    restart: unless-stopped
    # SMART-Auslesen braucht direkten Zugriff auf die Block-Devices
    # (ioctl) — der Exporter arbeitet dabei rein lesend.
    privileged: true
    ports:
      - "9633:9633"
    command:
      - "--smartctl.interval=120s"

docker compose up -d
curl -s localhost:9633/metrics | grep -c '^smartctl'

Bei uns liefert der Check 104 Metrik-Serien für zwei Laufwerke. Das Abfrageintervall von 120 Sekunden ist bewusst entspannt — SMART-Werte ändern sich langsam, und häufigeres Wecken hält Platten unnötig wach.

Prometheus anbinden #

In der prometheus.yml kommt ein eigener Job dazu:

scrape_configs:
  - job_name: "smartctl"
    scrape_interval: 60s
    static_configs:
      - targets: ["<host-ip>:9633"]

Danach stehen unter anderem diese Metriken bereit:

Stolpersteine aus der Praxis #

USB-Platten sind Glückssache — aber oft gute Glückssache. Unsere 1-TB-Datenplatte hängt in einem WD-Elements-Gehäuse am USB-Port. Die verbaute Bridge reicht SMART per SAT sauber durch, inklusive aller relevanten Fehlerzähler (Reallocated, Pending, Uncorrectable). Nur die Gesamt-Lese-/Schreibmengen liefert das Modell nicht — das ist normal.

NVMe und ATA sprechen verschiedene Sprachen. Die System-NVMe liefert naturgemäß keine ATA-Attribute; dafür gibt es Percentage Used, Available Spare und Media Errors. Wer beide Laufwerkstypen mischt, muss sein Monitoring so bauen, dass fehlende Werte als „n/a“ erscheinen — nicht als Warnung. Sonst leuchtet das Dashboard dauerhaft gelb und niemand schaut mehr hin.

Nicht jede Metrik existiert in jeder Exporter-Version. Version 0.14 exponiert z. B. keine unsafe_shutdowns-Metrik. Solche Lücken dokumentieren und offen lassen, statt sie mit Ersatzwerten zu füllen.

Echte Baseline als Referenz #

Zur Einordnung die Werte unseres Setups direkt nach der Einrichtung (gemessen am 25.08.2026, smartctl_exporter v0.14.0):

Die Zahlen zeigen, warum sich die Baseline lohnt: Die HDD hat ordentlich Stunden auf der Uhr, ist aber komplett unauffällig — und die NVMe steht nach ~28 TB Schreiblast erst bei 5 % Abnutzung. Ohne Ausgangswerte wüsste man in einem Jahr nicht, ob sich etwas verschlechtert hat.

Und wenn ein Wert kippt? #

SMART-Warnungen sind ein Signal, kein Urteil — aber eins, das du ernst nimmst: Prüfe zuerst, ob dein Backup aktuell ist (falls das Konzept fehlt: Backup-Strategie für zuhause), und sieh dir dann die Details mit smartctl direkt an — den passenden Befehl inklusive Selbsttest baust du im smartctl Command Builder.