plugin observability - nself-org/cli GitHub Wiki
Observability Plugin
Service health probes, watchdog timers, and service discovery with a unified health endpoint. Pro plugin.
Requires: Basic license tier or higher.
nself license set nself_pro_...
Install
nself license set nself_pro_xxxxx...
nself plugin install observability
What It Does
Runs configurable health probes against all registered services and exposes a unified /health/ endpoint aggregating their status. A background watchdog monitors probe results and automatically restarts unhealthy services to reduce manual intervention. Service discovery registration allows dynamic addition of new services without restarting the plugin.
Configuration
| Env Var | Default | Description |
|---|---|---|
OBSERVABILITY_PORT |
3215 |
Port the Observability plugin service listens on |
OBSERVABILITY_CHECK_INTERVAL |
30s |
Interval between health probe checks |
OBSERVABILITY_WATCHDOG_ENABLED |
true |
Enable automatic restart of unhealthy services |
Ports
| Port | Purpose |
|---|---|
3215 |
Observability plugin HTTP service |
Database Tables
3 tables added to your Postgres database.
np_observability_probes, Health probe definitions and latest resultsnp_observability_events, Watchdog and state-change event lognp_observability_service_registry, Registered services for discovery and probing
Nginx Routes
| Route | Description |
|---|---|
/health/ |
Aggregated health status endpoint, proxied to Observability plugin on port 3215 |