eplamat Runbooks

CPU-Last dauerhaft hoch

Alert: HighCPUUsage
Warning Auto-clear bei Entlastung
🌡️
Beobachten. CPU > 90% über 10 Min ist meist OK (Backup, OCR, Update), aber wenn's dauerhaft bleibt: irgendwas dreht im Kreis.

❓Was bedeutet das?

Der Server hat über 10 Minuten ≥ 90% CPU-Auslastung (Idle-Zeit über alle Cores zusammen < 10%).

Normal: während Backup (Sonntag 03:00), Image-Update (Mi 04:00), Paperless-OCR auf großen PDFs, oder wenn Minecraft viele Spieler hat.

⚠️Wie schlimm ist es?

Mittel. Dauerhaft hoch heißt: andere Services antworten langsamer, ggf. Healthcheck-Failures. Bei plötzlich permanent 100% steckt meist ein runaway-Container oder eine Endlosschleife dahinter.

🔧Was tun?

  1. Welcher Container zieht? 
    docker stats --no-stream --format "table {{.Name}}\t{{.CPUPerc}}" | sort -k2 -rh | head -10
  2. Geplante Last erkennen?
    • Sonntag 03:00–04:00 → eplamat-backup.service (normal)
    • Mittwoch 04:00 → eplamat-update-images.service (normal)
    • Paperless verarbeitet eingehende Dokumente → docker logs paperless-webserver | tail
    Wenn ja: einfach abwarten.
  3. Wenn unerklärlich: verdächtigen Container restarten: 
    docker compose restart <name>
  4. System-Load über Zeit anschauen in Grafana: https://grafana.home.mattetat.org → Node Exporter Dashboard.

🆘Wenn das nicht klappt

Kopier den Alert in Claude — bei chronisch hoher CPU lohnt sich ein Blick in perf top oder den Verdächtigen via strace kurz zu prüfen.