Observer Agent
Runs in your network. Probes metric sources, computes status, pushes results to Observer Cloud.
The Observer Agent is a small process that runs in your network. It reads from Prometheus or probes endpoints directly (HTTP, TCP, DNS, TLS certificates), computes status against thresholds, and pushes the verdict to Observer Cloud over an authenticated channel.
The agent is open source. Source at github.com/useobserver/agent, licensed Apache-2.0. The runtime is Bun on a distroless container image; the source is TypeScript.
Quickstart
Install from a release binary
Single-file executable from GitHub Releases. No runtime install on the host.
Install on Docker
Run the published image with three environment variables.
Install on Kubernetes
Deployment manifest with Secret-bound agent key.
Adjacent sections
- Guides cover per-probe configuration, dashboard reading, key rotation, and diagnosis paths.
- Reference lists every environment variable, every probe type, every dashboard panel, and the heartbeat payload shape.
- Concepts covers the agent / cloud boundary, the local queue, and the design choices behind the runtime.
Where the cloud-side concerns live
Documentation for status pages, SLOs, organisation setup, and the REST API is in the Documentation and API tabs. This tab covers the agent only.