Skip to main content
Monitor your agent’s health and performance with built-in endpoints.

​
Health Check

Check if your agent is running and ready: 
curl http://localhost:3773/health
Response: 
{
    "status": "ok",
    "ready": true,
    "uptime_seconds": 37.56,
    "version": "2026.6.7.dev65+g6742cd6eb.d20260210",
    "health": "healthy",
    "runtime": {
        "storage_backend": "PostgresStorage",
        "scheduler_backend": "RedisScheduler",
        "task_manager_running": true,
        "strict_ready": true
    },
    "application": {
        "penguin_id": "<penguin_id>",
        "agent_did": "<agent_did>"
    },
    "system": {
        "python_version": "<python_version>",
        "platform": "<platform>",
        "platform_release": "<platform_release>",
        "environment": "<environment>"
    }
}
Response Fields:
  • status - Overall health status (ok or error)
  • ready - Whether agent is ready to accept requests
  • uptime_seconds - Time since agent started
  • version - Bindu version number
  • health - Health status (healthy or unhealthy)
  • runtime - Runtime information:
    • storage_backend - Storage backend type (e.g., PostgresStorage)
    • scheduler_backend - Scheduler backend type (e.g., RedisScheduler)
    • task_manager_running - Whether task manager is running
    • strict_ready - Strict readiness check status
  • application - Application information:
    • penguin_id - Unique penguin identifier
    • agent_did - Agent’s DID (Decentralized Identifier)
  • system - System information:
    • python_version - Python version
    • platform - Operating system platform
    • platform_release - OS release version
    • environment - Deployment environment

​
Metrics API

Get Prometheus-compatible metrics for monitoring: 
curl http://localhost:3773/metrics
Available Metrics:
  • http_requests_total - Total HTTP requests by method, endpoint, status
  • http_request_duration_seconds - Request latency histogram
  • agent_tasks_active - Currently active tasks gauge
  • http_response_size_bytes - Response body size summary
  • http_requests_in_flight - Current requests being processed
Example Output: 
# HELP http_requests_total Total number of HTTP requests
# TYPE http_requests_total counter
http_requests_total{method="GET",endpoint="/health",status="200"} 1

# HELP agent_tasks_active Currently active tasks
# TYPE agent_tasks_active gauge
agent_tasks_active{agent_id="did:bindu:..."} 0

# HELP http_request_duration_seconds HTTP request latency
# TYPE http_request_duration_seconds histogram
http_request_duration_seconds_bucket{le="0.1"} 12
http_request_duration_seconds_count 12