How to use tracing
This guide explains how to activate traces and export them to the OTEL collector
Prerequisites
OTEL collector should be deployed and configured to receive traces.
How to enable traces export to the OTEL collector
To enable exporting traces to the OTEL collector set the OTEL collector traces receiver endpoint to the Aidbox setting observability.otel.traces-url
How to check the OTEL collector receives traces
Set up debug
exporter and traces
pipeline in the OTEL collector configuration:
debug
exporter and traces
pipeline in the OTEL collector configuration:receivers:
receivers:
otlp:
protocols:
http:
endpoint: <your-collector-resiever-endpoint>
exporters:
debug:
verbosity: detailed
service:
pipelines:
traces:
receivers: [otlp]
exporters: [debug] # OTEL prints traces to the stdout
See Aidbox traces in the OTEL collector stdout
Open OTEL collector stdout and see the traces.
Check traces sending status
The common endpoint for checking the status of sending metrics process
GET /telemetry/main/otel-trace-exporter/$status
queue-size: 10
history:
- ts: 1700661071
processed-count: 34
Force flush OTEL traces
To force flush all the traces Aidbox has in the queue use $flush
endpoint:
POST /telemetry/main/otel-trace-exporter/$flush
Check all available Aidbox OTEL traces exporter configuration options are here:
Last updated
Was this helpful?