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 results
  • np_observability_events, Watchdog and state-change event log
  • np_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