UXDL Docs

Observability Overview

How traces, errors, and logs work together across our stack.

Observability gives engineering visibility into production behavior — what broke, why it broke, and who was affected. We use three complementary tools, each with a distinct role.

The three pillars

ToolWhat it capturesWhen you use it
OpenTelemetryTraces, metrics, logs (raw signals)Instrument code, propagate context across services
SentryErrors, crashes, performance issuesDebug exceptions, track release health
AxiomStructured logs and eventsSearch logs, build dashboards, investigate incidents

How they work together

  1. OpenTelemetry instruments your code and exports standardized telemetry (traces, metrics, logs).
  2. Sentry receives error events and performance spans — surfaces stack traces, breadcrumbs, and release regressions.
  3. Axiom ingests structured logs for search, alerting, and long-term retention.

Environment configuration

VariableAlphaBetaProd
SENTRY_DSNDev project DSNStaging DSNProduction DSN
OTEL_EXPORTER_OTLP_ENDPOINTLocal collector or disabledStaging collectorProd collector
AXIOM_TOKENDev dataset tokenBeta dataset tokenProd dataset token
AXIOM_DATASETlogs-alphalogs-betalogs-prod

Never use production DSNs or tokens in local development.

GuideDescription
OpenTelemetryInstrumentation setup for Node.js and Next.js
SentryError tracking and release monitoring
AxiomLog shipping and query patterns

Official documentation