Baggage Specification

This repository is associated with the baggage specification.

Status of the report is First Public Working Draft.

See rationale document for clarifications.

Team Communication

See communication

We appreciate feedback and contributions. Please make sure to read rationale documents when you have a question about particular decision made in specification.

Goal

This specification defines propagation of baggage for events correlation beyond the request identification that is covered by trace context specification. Our goal is to share this with the community so that various tracing and diagnostics products can operate together.

Known Implementations

OpenTelemetry provides an implementation of the baggage specification. You can find details at OpenTelemetry API. OpenTelemetry SDK ships a BaggagePropagator and enables it by default. For example, the .NET version of it is here and it is documented here.

Another system that supports the baggage concept is .NET. It supports it as part of the System.Diagnostics.Activity class and it is documented here. However, it is not a strict reference implementation: for example, it doesn't enforce the same character set or limits.

Why are we doing this

See Why

Contributing

See Contributing.md for details.