Claude
Skill
health-check
Run comprehensive health checks on the Claude Code Agent Monitor system. Validates dashboard API, database, WebSocket, hooks, and disk usage. Use to verify the monitoring setup is working correctly.
Virus-scanned
Reviewed automatically before listing.
Download
hoangsonww-claude-code-agent-monitor-plugins_ccam-devtools_skills_health-check-83d4df5.zip · 1 KB
Install
skills CLI
npx skills add https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/master/plugins/ccam-devtools/skills/health-check
Claude Code
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install hoangsonww-claude-code-agent-monitor@llmmart
Git
git clone https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole hoangsonww/claude-code-agent-monitor collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Health Check
Run a comprehensive health check on the Agent Monitor system.
Input
The user provides: $ARGUMENTS
This may be:
- "full" or empty (default: run all checks)
- "quick" for a fast connectivity check
- "deep" for extended checks including database integrity
Procedure
Run health checks in this order:
1. API Health
curl -sf http://localhost:4820/api/health
- Verify HTTP 200 response
- Check response time (<500ms expected, <1000ms acceptable)
- Confirm JSON response body
2. Database Health
curl -sf http://localhost:4820/api/stats
- Verify stats endpoint returns valid data
- Check that counts are non-negative integers
- Verify database file exists and has reasonable size
3. WebSocket Health
- Check that the WebSocket server is listening
- Verify WebSocket upgrade is supported on the dashboard port
4. API Endpoint Validation
Test each major endpoint:
curl -sf http://localhost:4820/api/sessions?limit=1
curl -sf http://localhost:4820/api/events?limit=1
curl -sf http://localhost:4820/api/analytics
curl -sf http://localhost:4820/api/pricing
curl -sf http://localhost:4820/api/settings/info
5. Hook Integration
- Verify hook handler script exists
- Check hooks are configured in
~/.claude/settings.json - Verify the handler script targets the correct dashboard URL
6. Disk & Resource Usage (deep mode only)
- Database file size
- Log file sizes (if any)
- Available disk space
- Node.js process memory usage (if accessible)
7. Data Freshness
- Time since last event ingested
- Time since last session created
- Check for stale active sessions (active but no events in >1 hour)
Output Format
Present as a system health dashboard:
╔══════════════════════════════════════════════╗
║ AGENT MONITOR HEALTH CHECK ║
║ Timestamp: 2025-04-11 12:00:00 UTC ║
╠══════════════════════════════════════════════╣
║ ║
║ API Server ............ ✅ OK (45ms) ║
║ Database .............. ✅ OK (2.4 MB) ║
║ WebSocket ............. ✅ OK ║
║ API Endpoints ......... ✅ 6/6 passing ║
║ Hook Integration ...... ⚠️ 5/7 hooks ║
║ Data Freshness ........ ✅ 3m ago ║
║ ║
║ Overall: HEALTHY (5/6 checks passed) ║
║ ║
╚══════════════════════════════════════════════╝
For any non-passing check, include detailed explanation and remediation steps below the dashboard.
Files (claude-code-agent-monitor)
-
agents
-
openai.yaml 261 B
interface: display_name: "Health Check" short_description: "Run comprehensive health checks on the Claude Code Agent..." default_prompt: "Use $health-check to inspect CCAM data and complete this workflow safely." policy: allow_implicit_invocation: true
-
-
SKILL.md 3.1 KB
--- name: health-check description: > Run comprehensive health checks on the Claude Code Agent Monitor system. Validates dashboard API, database, WebSocket, hooks, and disk usage. Use to verify the monitoring setup is working correctly. --- # Health Check Run a comprehensive health check on the Agent Monitor system. ## Input The user provides: **$ARGUMENTS** This may be: - "full" or empty (default: run all checks) - "quick" for a fast connectivity check - "deep" for extended checks including database integrity ## Procedure Run health checks in this order: ### 1. API Health ```bash curl -sf http://localhost:4820/api/health ``` - Verify HTTP 200 response - Check response time (<500ms expected, <1000ms acceptable) - Confirm JSON response body ### 2. Database Health ```bash curl -sf http://localhost:4820/api/stats ``` - Verify stats endpoint returns valid data - Check that counts are non-negative integers - Verify database file exists and has reasonable size ### 3. WebSocket Health - Check that the WebSocket server is listening - Verify WebSocket upgrade is supported on the dashboard port ### 4. API Endpoint Validation Test each major endpoint: ```bash curl -sf http://localhost:4820/api/sessions?limit=1 curl -sf http://localhost:4820/api/events?limit=1 curl -sf http://localhost:4820/api/analytics curl -sf http://localhost:4820/api/pricing curl -sf http://localhost:4820/api/settings/info ``` ### 5. Hook Integration - Verify hook handler script exists - Check hooks are configured in `~/.claude/settings.json` - Verify the handler script targets the correct dashboard URL ### 6. Disk & Resource Usage (deep mode only) - Database file size - Log file sizes (if any) - Available disk space - Node.js process memory usage (if accessible) ### 7. Data Freshness - Time since last event ingested - Time since last session created - Check for stale active sessions (active but no events in >1 hour) ## Output Format Present as a system health dashboard: ``` ╔══════════════════════════════════════════════╗ ║ AGENT MONITOR HEALTH CHECK ║ ║ Timestamp: 2025-04-11 12:00:00 UTC ║ ╠══════════════════════════════════════════════╣ ║ ║ ║ API Server ............ ✅ OK (45ms) ║ ║ Database .............. ✅ OK (2.4 MB) ║ ║ WebSocket ............. ✅ OK ║ ║ API Endpoints ......... ✅ 6/6 passing ║ ║ Hook Integration ...... ⚠️ 5/7 hooks ║ ║ Data Freshness ........ ✅ 3m ago ║ ║ ║ ║ Overall: HEALTHY (5/6 checks passed) ║ ║ ║ ╚══════════════════════════════════════════════╝ ``` For any non-passing check, include detailed explanation and remediation steps below the dashboard.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.