- Efficient delivery of telemetry.
- Correct formatting and backend compatibility.
- Integration with processors and pipelines to support resilience and observability.
When an exporter name contains special characters (for example, a slash
/), wrap the name in quotes in YAML (for example: "otlp/primary") to avoid YAML parsing issues.Example configuration
Below is a concise, syntactically correct Collector configuration that demonstrates:- an OTLP receiver,
- two exporters (an OTLP backend and a logging exporter), and
- a traces pipeline that fans out to both exporters.
receiversaccepts telemetry; here theotlpreceiver accepts traces, metrics, and logs via gRPC and HTTP.exportersdefines endpoints and exporter-specific settings (TLS, headers, compression).service.pipelines.tracesconnectsreceivers -> processors -> exporters. Listing multiple exporters enables fan-out: the same trace data will be delivered to"otlp/primary"andlogging.
Resilience and delivery guarantees
Exporters focus on delivering data; end-to-end resilience is typically implemented with processors placed in the pipeline before exporters. Common processors and patterns:
The
batch processor in the example reduces overhead and increases throughput. For stronger guarantees (queueing, retries, backpressure protection), add appropriate processors prior to exporters.
Keep exporter endpoints and credentials secure. Many exporters support TLS, authentication headers, and other security settings—configure them to avoid leaking sensitive telemetry or credentials.
Practical considerations and best practices
- Multiple exporters: Define exporters for different destinations (cloud APMs, logging systems, metrics backends) and reference combinations of them from pipelines to enable fan-out.
- Observability: Monitor exporter performance (latencies, errors). Use
loggingexporter or a debug-level exporter during troubleshooting to inspect payloads. - Security: Store and reference credentials securely (secrets management). Enable TLS and validate certificates for production backends.
- Performance: Tune processors like
batchandqueued_retryto match backend throughput and network characteristics. - Compatibility: Confirm exporter configuration matches backend expectations (protocols, versions, and attribute mappings).
Component responsibilities (quick reference)
Exporters are a core piece of Collector configuration. They define where your telemetry ends up and, together with processors, determine how reliably and efficiently it gets there.