- name
- pi-health
- description
- Raspberry Pi health monitor. Check CPU temperature, throttling status, voltage levels, memory/disk usage, fan RPM, overclock detection, and power issues. Use when monitoring Pi health, diagnosing thermal throttling, checking for under-voltage, or verifying system stability on any Raspberry Pi (Pi 3/4/5, arm64/armhf).
Pi Health
Run the health check script:
bash scripts/health.shWhat It Checks
| Check | Source | Warning | Critical |
|---|---|---|---|
| CPU Temperature | thermal_zone0 | >70°C | >80°C |
| Throttling | vcgencmd get_throttled | any flag set | under-voltage |
| Voltages | vcgencmd measure_volts | — | — |
| Memory | free -m | >75% | >90% |
| Disk | df / | >75% | >90% |
| CPU Frequency | cpufreq sysfs | — | — |
| Load Average | /proc/loadavg | >nCPU | >2×nCPU |
| Fan | hwmon sysfs | — | — |
| Overclock | config.txt | detected | — |
| Power | dmesg | — | under-voltage |
Exit Codes
0— Healthy (all checks passed)1— Warnings (non-critical issues)2— Critical (needs immediate attention)
Requirements
- Raspberry Pi OS (Bookworm or later)
vcgencmd(optional but recommended — comes withlibraspberrypi-bin)bc(standard on Pi OS)- No external dependencies or API keys