Unified observability for your nSelf stack. Continuously probes registered services, stores health history in Postgres, fires watchdog alerts when services fail to check in, and auto-discovers running containers via Docker. Pairs with nself doctor for on-demand diagnostics.
Set your license key with nself license set nself_pro_... before installing. Requires Docker socket access for service auto-discovery.
nself license set nself_pro_...
nself plugin install observability
nself build
nself start| Env Var | Required | Description |
|---|---|---|
DATABASE_URL | Yes | PostgreSQL connection string |
OBSERVABILITY_PLUGIN_PORT | No | HTTP port (default: 3215) |
OBSERVABILITY_CHECK_INTERVAL | No | Seconds between health probes (default: 30) |
OBSERVABILITY_DOCKER_SOCKET | No | Docker socket path (default: /var/run/docker.sock) |
OBSERVABILITY_WATCHDOG_ENABLED | No | Enable watchdog timer alerts (default: true) |
curl -X POST http://127.0.0.1:3215 \
-H "Authorization: Bearer $NSELF_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "api-server",
"endpoint": "http://127.0.0.1:8080/health",
"check_interval_seconds": 30,
"watchdog_timeout_seconds": 120,
"notify_on_failure": true
}'curl -X POST http://127.0.0.1:3215/api-server-id/check \
-H "Authorization: Bearer $NSELF_API_KEY"nself plugin run observability health| Endpoint | Method | Description |
|---|---|---|
/ | GET, POST | List or register monitored services |
/:id | GET, PUT, DELETE | Read, update, or remove a service |
/:id/check | POST | Trigger an immediate health probe |
/:id/history | GET | Health check history for a service |
/api/v1/health | GET | Current health status of all services |
/api/v1/incidents | GET | Open and recent incidents |
/api/v1/stats | GET | Uptime percentages and probe counts |
/config | GET, PUT | Read or update plugin configuration |
/health | GET | Plugin health check |
nself plugin remove observabilityCategory: Infrastructure | Tier: Pro | Port: 3215 | Last Updated: April 2026 | Plugin Version 1.1.1