Rolle `thermal_watchdog`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/thermal_watchdog.md
Rolle thermal_watchdog
Selbst-Abschaltung bei Übertemperatur.
| Läuft gegen | alle Knoten und Kiosks |
| Tags | thermal, thermal-watchdog |
| Quellcode | roles/thermal_watchdog |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
thermal_watchdog_enabled |
true |
– |
thermal_watchdog_threshold_c |
100 |
– |
thermal_watchdog_sustain_seconds |
90 |
– |
thermal_watchdog_poll_seconds |
10 |
– |
thermal_watchdog_ntfy_host |
{{ homelab_ntfy_host }} |
– |
thermal_watchdog_ntfy_ip |
{{ homelab_ntfy_ip }} |
– |
thermal_watchdog_ntfy_topic |
{{ homelab_ntfy_topic }} |
– |
Ablauf
- lm-sensors installieren (hwmon-kernel-module / sysfs-hilfen)
- thermal-watchdog-skript ablegen
- systemd-unit des thermal-watchdogs ablegen
- thermal-watchdog aktivieren und starten
- thermal-watchdog deaktivieren, wenn thermal_watchdog_enabled aus ist
Handler
- thermal-watchdog neu starten
Templates
thermal-watchdog.service.j2
Dateien
thermal-watchdog.sh
Fehlersuche
Allgemeines Vorgehen bei Rollen: ansible-playbook <playbook>.yml --limit <host> --tags <tag> --check --diff -vvv zeigt Änderungen ohne sie anzuwenden (make <ziel>-check bei den Playbooks mit Dry-Run). Die Rollenübersicht mit Make-Zielen: Rollen.
sudo systemctl status thermal-watchdog
sudo journalctl -u thermal-watchdog -n 100 --no-pager
cat /sys/class/thermal/thermal_zone*/temp
| Symptom | Ursache | Lösung |
|---|---|---|
| Host schaltet sich ab | Temperatur über thermal_watchdog_threshold_c (100 °C) für sustain_seconds (90 s) — Selbstschutz |
Lüfter, Staub, Last prüfen; Hardware-Dashboard (Hardware-Monitoring) |
| Keine ntfy-Meldung vor dem Abschalten | Publisher-Token oder CA fehlt | ntfy_publisher |
| Dienst startet nicht | Sensor fehlt (VM oder Gerät ohne Thermalzone) | ls /sys/class/thermal/, Rolle für diesen Host abschalten |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.