Observer Agentv1.2.0

Observer Agent

Open-source data plane

Observer Agent is the data-plane half of the platform: a Bun + TypeScript binary, distroless container, runs inside your network. It reads from Prometheus, HTTP, TCP, DNS, and TLS-cert probes, evaluates verdicts locally, and pushes only the result (metric_id, value, status, timestamp) to Observer Cloud. Raw telemetry never leaves your network.

The agent ships as an open-source artifact. Install on Docker, Kubernetes, or any Linux box; configure probes through a single agent.toml plus environment variables; rotate keys without downtime. See the agent-cloud boundary concept for the trust model.

TutorialInstall on DockerRun the agent in a single container against your existing Prometheus.Start here How-toAdd an HTTP probeSend a heartbeat from an HTTP endpoint to Observer Cloud.Start here ConceptLocal-first verdictsWhy the agent owns evaluation and the cloud just stores the result.Start here
Concepts
Agent and cloud boundaryProbes vs scrapingThe local queueBun and distroless: design choices
Quickstart
Install from a release binaryInstall on DockerInstall on Kubernetes
Guides
Configure Prometheus query metricsReceive metrics over OpenTelemetry (OTLP)Read metrics from AWS CloudWatchConfigure a Grafana Loki sourceConfigure an Elasticsearch or OpenSearch sourceRead metrics from a database queryConfigure HTTP probesConfigure TCP probesConfigure ICMP ping probesConfigure DNS probesConfigure TLS certificate probesConfigure WebSocket probesConfigure gRPC health-check probesWrite custom probesConnect to Grafana CloudRead the agent dashboardDiagnose a stalled agentRotate the agent's authentication key
Reference
Environment variablesProbe typesDashboard panelsHeartbeat payload