← Back to Docs
Recipe

Observability Stack

Ship logs, metrics, and traces from a single lightweight agent — no vendor lock-in.

Architecture

Meridian deploys a sidecar agent alongside your workload. The agent collects structured logs via stdout scraping, Prometheus-compatible metrics from an embedded HTTP endpoint, and OpenTelemetry traces over gRPC. All telemetry flows through a buffered pipeline with configurable backpressure before fan-out to your chosen backends.

Backends

  • Grafana Loki + Mimir + Tempo (self-hosted)
  • Datadog, Honeycomb, or ClickHouse
  • S3-compatible cold storage with Parquet compression

Quick Start

$ meridian agent init

# edit meridian.yaml to set backends

$ meridian agent up

Pro tip: Enable tail sampling at 10% in staging to keep costs flat while still catching anomalous traces before production.