pi-health
بواسطة josunlp
DevOps & Cloudموجز
Raspberry Pi health monitor.
الوصف
ما الذي تفعله هذه المهارة
Runs a shell script that checks the health of a Raspberry Pi by reading CPU temperature, throttling flags, voltage levels, memory and disk usage, fan RPM, load averages, and overclock settings. Works on Pi 3, 4, and 5 running Raspberry Pi OS Bookworm or later. Returns exit codes 0, 1, or 2 to indicate healthy, warning, or critical states.
Consolidates a dozen separate vcgencmd and sysfs queries into a single script with structured exit codes, making it easy to integrate into cron jobs or monitoring pipelines.
متى تستخدمها
- Checking if a Pi is thermally throttling under load
- Diagnosing under-voltage issues from a weak power supply
- Verifying system stability before a long-running job
- Monitoring fan operation on a Pi 5 with active cooling
- Detecting unauthorized overclocking on a shared Pi
مثال على سير العمل
User runs: bash scripts/health.sh
- 1
Reads CPU temperature from thermal_zone0
- 2
Calls vcgencmd get_throttled to check throttling and under-voltage flags
- 3
Reads memory and disk usage via free and df
- 4
Checks fan RPM from hwmon sysfs and CPU frequency from cpufreq sysfs
- 5
Reads load average from /proc/loadavg and scans dmesg for power warnings
Prints a health summary table with warning/critical annotations and exits with code 0 (healthy), 1 (warnings), or 2 (critical)
التثبيت
clawhub install josunlp/pi-healthشغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.