Monitors

Monitor endpoints return information about monitors and provide some monitor controls through POST methods.

An endpoint might reference all monitors or a single monitor as documented. Single-monitor endpoints require query key id to identify the monitor, which is a config.monitor.id value. Use GET /monitors to discover monitor IDs if you don’t set them explicitly in the Blip config file.

Returns a list of all loaded monitors keyed on config.monitor.id. The value for each is its redacted DSN (no password).

{
  "localhost": "blip:...@unix(/tmp/mysql.sock)/?parseTime=true"
}

Reloads all monitors. See Monitors / Loading / Reloading.

Reloading only affects new and removed monitors. Monitors that did not change are not affected, even on error.

None on success (200 status code).

Error message on 4xx or 5xx status code.

409: Error reloading monitors

412: Stop-loss prevented reloading

Starts one monitor. id query key is required.

None on success (200 status code).

Error message on 4xx or 5xx status code.

409: Error starting monitor

Stops one monitor. id query key is required.

The monitor is stopped but not unloaded, which means it reported by status endpoints.

None on success (200 status code).

Error message on 4xx or 5xx status code.