Skip to content

feat(core): propagate request-scoped TraceContext on subrequests #1052

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
VaishnaviHire wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat(core): propagate request-scoped TraceContext on subrequests #1052

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 2 additions & 6 deletions docs/filters/http/observability/trace_context.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,11 @@

# `trace_context`

Propagates W3C Trace Context headers (`traceparent`, `tracestate`).
Propagates W3C Trace Context and `x-request-id` correlation.

## Configuration Notes

On each request: 1. Parses the incoming `traceparent` header (if present and valid) 2. Joins the existing trace or generates a new trace ID 3. Generates a new span ID for the proxy hop 4. Injects the updated `traceparent` into the upstream request 5. Forwards the `tracestate` header (if present and traceparent was valid) 6. Strips the `tracestate` header when traceparent is absent or invalid

Per W3C Trace Context section 3.3.1.1, `tracestate` MUST NOT be forwarded when `traceparent` is absent or invalid.

Malformed `traceparent` headers are silently ignored and treated as absent, per the W3C specification.
Per W3C Trace Context section 3.3.1.1, `tracestate` is forwarded only when inbound `traceparent` is valid.

Currently accepts no fields; reserved for future options such as trusted-header policies or sampling flag overrides.

Expand Down
2 changes: 1 addition & 1 deletion docs/filters/reference.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Built-in filters organized by protocol and category.
|--------|---------|-------------|
| [`access_log`](http/observability/access_log.md) | - | Logs structured access records for each request and response. |
| [`request_id`](http/observability/request_id.md) | - | Ensures every request carries a correlation ID. |
| [`trace_context`](http/observability/trace_context.md) | - | Propagates W3C Trace Context headers (`traceparent`, `tracestate`). |
| [`trace_context`](http/observability/trace_context.md) | - | Propagates W3C Trace Context and `x-request-id` correlation. |

## HTTP / Payload Processing

Expand Down
Loading
Loading