Files

Cloudflare Observability

Use this reference to choose a telemetry signal and find the maintained implementation guide. Fetch the linked documentation before writing configuration, queries, or export code; it is the source of truth for APIs, availability, retention, limits, and pricing.

Choose a signal

Need Start here
Store, search, and investigate historical Worker logs Workers Logs
Watch a deployment or reproduce an issue live Real-time logs and Wrangler tail
Understand request flows and dependency latency Workers Traces
Monitor built-in request, error, and CPU metrics Metrics and analytics
Record custom events and tenant-level usage for SQL analysis Analytics Engine
Export logs and traces to an observability provider OpenTelemetry export
Apply custom filtering, transformation, or delivery logic Tail Workers
Deliver Workers Trace Events to a supported log storage destination Workers Logpush

Workers Logs supports retained historical data; live tailing is a separate debugging workflow. Choose persistence, sampling, and export destinations deliberately rather than assuming that every signal is stored or included without usage charges.

Load only what the task needs

  • configuration.md: enable collection, bindings, environments, and exports.
  • api.md: logging, telemetry types, SQL, GraphQL, and Logpush APIs.
  • patterns.md: billing, performance, errors, tenant tracking, and export decisions.
  • gotchas.md: missing data, sampling, timing, privacy, and cost checks.

For broader product tasks, see Analytics Engine, GraphQL API, and Tail Workers.