Self Monitor
by @suryast
Proactive self-monitoring of infrastructure, services, and health. Tracks disk/memory/load, service health, cron job status, recent errors. Auto-fixes safe i...
clawhub install self-monitorπ About This Skill
name: self-monitor version: 1.1.0 author: Polycat tags: [monitoring, health, infrastructure] license: MIT platform: universal description: > Proactive self-monitoring of infrastructure, services, and health. Tracks disk/memory/load, service health, cron job status, recent errors. Auto-fixes safe issues. Triggers on: health check, heartbeat, monitor status, service status, infrastructure check.
> Compatible with Claude Code, Codex CLI, Cursor, Windsurf, and any SKILL.md-compatible agent.
Self Monitor
Proactive self-monitoring: infrastructure, services, and health.
Usage
Run during heartbeats or scheduled checks.
1. Infrastructure Health
# Disk usage
df -h / | awk 'NR==2 {print $5}' | tr -d '%'Memory usage
free -m | awk 'NR==2 {printf "%.0f", $3/$2*100}'Load average
uptime | awk -F'load average:' '{print $2}' | awk -F',' '{print $1}'Top processes by memory
ps aux --sort=-%mem | head -10Top processes by CPU
ps aux --sort=-%cpu | head -10
Thresholds: | Metric | Warning | Critical | |--------|---------|----------| | Disk | > 80% | > 90% | | Memory | > 85% | > 95% | | Load | > 2.0 | > 4.0 |
2. Service Health
# Check if a process is running
pgrep -f "your_process_name" >/dev/null && echo "OK" || echo "FAIL"Check HTTP endpoint
curl -s -o /dev/null -w "%{http_code}" http://localhost:8080/healthCheck systemd service
systemctl is-active --quiet nginx && echo "OK" || echo "FAIL"Check Docker container
docker ps --filter "name=mycontainer" --filter "status=running" -q | grep -q . && echo "OK" || echo "FAIL"Tailscale (if using)
tailscale status --json 2>/dev/null | jq -r '.Self.Online' || echo "FAIL"
3. Cron Job Health
# Check recent cron executions
grep CRON /var/log/syslog | tail -20Count failures in last 24h
grep -c "CRON.*error\|CRON.*fail" /var/log/syslogList scheduled jobs
crontab -l
4. Recent Errors
# Check system logs for errors
journalctl -p err --since "1 hour ago" 2>/dev/null | tail -20Check application logs
tail -50 ~/workspace/projects/*/logs/*.log 2>/dev/null | grep -i "error"Check dmesg for hardware/kernel issues
dmesg | tail -20 | grep -i "error\|fail\|warn"
Quick Health Check (for heartbeat)
#!/bin/bash
Quick health snapshot
DISK=$(df -h / | awk 'NR==2 {print $5}' | tr -d '%')
MEM=$(free -m | awk 'NR==2 {printf "%.0f", $3/$2*100}')
LOAD=$(uptime | awk -F'load average:' '{print $2}' | awk -F',' '{print $1}' | xargs)
echo "Disk: ${DISK}% | Mem: ${MEM}% | Load: ${LOAD}"
Alert if thresholds exceeded
[ "$DISK" -gt 90 ] && echo "β οΈ Disk critical!"
[ "$MEM" -gt 95 ] && echo "β οΈ Memory critical!"
Proactive Actions
When issues detected:
| Issue | Auto-Action | Alert? | |-------|------------|--------| | Disk > 90% | Clean temp files, old logs | Yes | | Key process down | Attempt restart | Yes | | Cron 3+ failures | Generate report | Yes | | Memory > 95% | List top processes | Yes |
Auto-fixable (safe):
# Clean old logs (> 7 days)
find /var/log -name "*.log" -mtime +7 -delete 2>/dev/null
find ~/.cache -type f -mtime +7 -delete 2>/dev/nullClean temp files
rm -f /tmp/agent-temp-* 2>/dev/null
rm -rf ~/.cache/pip 2>/dev/null
Report Format
## π Self-Monitor Report - [TIME]Health Summary
| Metric | Value | Status |
|--------|-------|--------|
| Disk | XX% | β
/β οΈ/π΄ |
| Memory | XX% | β
/β οΈ/π΄ |
| Load | X.X | β
/β οΈ/π΄ |
| Services | X/Y up | β
/β οΈ |Issues Found
[Issue 1]: [Action taken or recommended] Top Resource Consumers
| Process | CPU% | MEM% |
|---------|------|------|
| ... | ... | ... |
Integration with Scheduled Tasks
Add to your crontab or task scheduler:
# Run health check every 30 minutes
*/30 * * * * /path/to/health-check.sh >> /var/log/health-check.log 2>&1
Or run manually as part of your workflow:
./health-check.sh
π‘ Examples
Run during heartbeats or scheduled checks.
1. Infrastructure Health
# Disk usage
df -h / | awk 'NR==2 {print $5}' | tr -d '%'Memory usage
free -m | awk 'NR==2 {printf "%.0f", $3/$2*100}'Load average
uptime | awk -F'load average:' '{print $2}' | awk -F',' '{print $1}'Top processes by memory
ps aux --sort=-%mem | head -10Top processes by CPU
ps aux --sort=-%cpu | head -10
Thresholds: | Metric | Warning | Critical | |--------|---------|----------| | Disk | > 80% | > 90% | | Memory | > 85% | > 95% | | Load | > 2.0 | > 4.0 |
2. Service Health
# Check if a process is running
pgrep -f "your_process_name" >/dev/null && echo "OK" || echo "FAIL"Check HTTP endpoint
curl -s -o /dev/null -w "%{http_code}" http://localhost:8080/healthCheck systemd service
systemctl is-active --quiet nginx && echo "OK" || echo "FAIL"Check Docker container
docker ps --filter "name=mycontainer" --filter "status=running" -q | grep -q . && echo "OK" || echo "FAIL"Tailscale (if using)
tailscale status --json 2>/dev/null | jq -r '.Self.Online' || echo "FAIL"
3. Cron Job Health
# Check recent cron executions
grep CRON /var/log/syslog | tail -20Count failures in last 24h
grep -c "CRON.*error\|CRON.*fail" /var/log/syslogList scheduled jobs
crontab -l
4. Recent Errors
# Check system logs for errors
journalctl -p err --since "1 hour ago" 2>/dev/null | tail -20Check application logs
tail -50 ~/workspace/projects/*/logs/*.log 2>/dev/null | grep -i "error"Check dmesg for hardware/kernel issues
dmesg | tail -20 | grep -i "error\|fail\|warn"