Correlation IDs

Correlation IDs let you jump between Boson traces and the rest of your telemetry.

Recommended identifiers

• request_id: from your edge/gateway/load balancer
• session_id: conversation or user session
• trace_id: your internal trace id (optional) or Boson’s trace id
• release: git SHA / semver / deploy id

Where to attach them

• attach request_id, session_id, release, env to the trace metadata
• attach provider/tool identifiers to the relevant spans

Propagation

In distributed systems, propagate ids via:

• request headers
• async context
• job payloads for queues

Next steps

• Redaction