← Concepts

阅读中文版本

Telemetry Pipeline

A telemetry pipeline collects, processes, and routes logs, metrics, and traces from services to backends, controlling enrichment, sampling, and cost in one place.

reliability

Definition

A telemetry pipeline is the collection of agents, collectors, queues, and processors that ingest observability signals, normalize and enrich them, and deliver them to storage and analysis backends.

Context and scope

Needed once more than a handful of services emit telemetry and teams need consistent schemas, sampling, redaction, and routing.

Common misconceptions

  • A telemetry pipeline is just an agent installed on each host
  • The collector guarantees delivery even when queues overflow
  • A telemetry pipeline only matters for distributed traces

Anti-patterns

  • Giving every service its own unmanaged export configuration
  • Dropping data silently when the backend is slow instead of applying backpressure
  • Treating the collector as fire-and-forget infrastructure with no monitoring

Related concepts

Related examples

Authoritative source

https://opentelemetry.io/docs/collector/

How it works

Services emit logs, metrics, and traces through SDKs, usually via OpenTelemetry. A collector receives the signals, then processors batch, redact, enrich, and sample them before exporters send data to one or more backends. Buffers and retries absorb backend outages, and the pipeline enforces consistent resource attributes across services.

When to use it

Adopt a pipeline once several services emit telemetry and you need shared schemas, redaction, sampling, or multiple backends. A single small app can export directly. Compared with per-service configuration, a central pipeline changes routing and cost policy without redeploying every application, but it adds a hop that must itself be monitored.

Trade-offs

The pipeline is critical infrastructure and a potential single point of failure; it needs capacity planning, backpressure handling, and its own telemetry. Processor configuration grows complex, and mistakes can drop or duplicate data. Running an agent per node, a sidecar per pod, or a gateway per cluster trades isolation against operational overhead.

Example

An OpenTelemetry Collector pipeline batches spans, redacts authorization headers, samples one percent of successful traces while keeping all errors, and exports to both a tracing backend and cold storage. After rollout, observability spend falls forty percent without losing error visibility.

Misconceptions

A telemetry pipeline is not just an agent installed once; it is a configured system with schema, routing, and failure behavior. The collector does not guarantee delivery when queues overflow. Nor is the pipeline only for traces, because logs and metrics share the same routing and redaction needs.

Sampling happens inside the pipeline; distributed tracing depends on consistent context propagation; golden signals define which metrics must survive the journey.