From 4c8deeddd2efb82ca0992a6a6296ca4ea39f0f71 Mon Sep 17 00:00:00 2001 From: Joris Bayer Date: Fri, 12 Dec 2025 15:30:46 +0100 Subject: [PATCH] ref(spans): Warn about experimental attachments --- develop-docs/sdk/data-model/envelope-items.mdx | 4 ++++ develop-docs/sdk/telemetry/spans/span-protocol.mdx | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/develop-docs/sdk/data-model/envelope-items.mdx b/develop-docs/sdk/data-model/envelope-items.mdx index d3a4912305688..4c466e05bf463 100644 --- a/develop-docs/sdk/data-model/envelope-items.mdx +++ b/develop-docs/sdk/data-model/envelope-items.mdx @@ -115,6 +115,10 @@ file. It is always associated to an event or transaction. ### Trace Attachment + +Trace attachments are an experimental feature that is still under development. + + Item type `"attachment"` with content type `"application/vnd.sentry.trace-attachment"`. This item contains a raw payload of an attachment together with metadata. Contrary to V1 attachments, trace attachments are only optionally associated with other trace items (spans, logs, ...). Their main association is with the trace itself. **Envelope Headers:** diff --git a/develop-docs/sdk/telemetry/spans/span-protocol.mdx b/develop-docs/sdk/telemetry/spans/span-protocol.mdx index 7a768f1c67c06..8c00fde1c5c1e 100644 --- a/develop-docs/sdk/telemetry/spans/span-protocol.mdx +++ b/develop-docs/sdk/telemetry/spans/span-protocol.mdx @@ -218,6 +218,10 @@ span_id: "438f40bd3b4a41ee" ## Span Attachments + +Span attachments are an experimental feature that is still under development. + + To associate an attachment with a span, submit a [trace attachment](/sdk/data-model/envelope-items/#trace-attachment) item with an additional `span_id` item header. The trace attachment _should_ be submitted in the same envelope as the span itself. - `span_id` is the ID of the span that owns the attachment. If set, the attachment will be dropped with the span if the span is dropped by dynamic sampling, inbound filters or rate limits. That is, Relay treats `span_id` as the owner of the attachment.