Monitoring

# Basic health check
curl http://localhost:3000/api/health
# Returns: { "status": "ok", "version": "2.x.x", "mode": "mini", "uptime": 3600 }

# Readiness check (includes dependency checks)
curl http://localhost:3000/api/ready
# Returns: { "status": "ready", "checks": { "database": "ok", "redis": "ok", "providers": "ok" } }

# System status overview
profclaw status

# Run diagnostic checks
profclaw doctor

# View active sessions
profclaw agent sessions

# Queue status
profclaw queue status

# Today's costs
profclaw cost

# Cost breakdown by provider
profclaw cost --breakdown

# Cost for a date range
profclaw cost --since 2026-03-01 --until 2026-03-12

# Export as JSON
profclaw cost --json

profClaw Cost Report - Today
──────────────────────────────
Provider        Tokens (in/out)    Cost
Anthropic       125,430 / 42,100   $0.89
OpenAI          45,200 / 15,600    $0.23
Ollama          89,000 / 31,200    $0.00 (local)
──────────────────────────────
Total                              $1.12

# View live logs
profclaw logs --follow

# Filter by level
profclaw logs --level error

# Filter by time
profclaw logs --since 1h

# Filter by component
profclaw logs --component chat
profclaw logs --component security
profclaw logs --component queue

# View recent audit events
profclaw audit list

# Filter by event type
profclaw audit list --type tool_execution
profclaw audit list --type security_decision

# Export for compliance
profclaw audit export --format json --since 2026-03-01

https://your-profclaw.com/api/health

monitoring:
  prometheus:
    enabled: true
    port: 9090
    path: /metrics

groups:
  - name: profclaw
    rules:
      - alert: ProfClawDown
        expr: up{job="profclaw"} == 0
        for: 1m
      - alert: HighErrorRate
        expr: rate(profclaw_requests_total{status="5xx"}[5m]) > 0.1
        for: 5m
      - alert: QueueBacklog
        expr: profclaw_queue_depth > 100
        for: 10m