Skip to content
Merged
Changes from all commits
Commits
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
9 changes: 6 additions & 3 deletions develop-docs/sdk/telemetry/client-reports.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,15 @@
title: Client Reports
description: SDK self-reporting protocol for tracking discarded events and their discard reasons.
spec_id: sdk/telemetry/client-reports
spec_version: 1.25.0
spec_version: 1.26.0
spec_status: stable
spec_depends_on:
- id: sdk/foundations/transport/envelopes
version: ">=1.0.0"
spec_changelog:
- version: 1.26.0
date: 2026-11-06
summary: Broadened `invalid` discard reason to cover any data dropped because it is invalid
- version: 1.25.0
date: 2026-10-08
summary: Clarified that discarded envelopes are counted per contained item, not as a quantity of 1
Expand Down Expand Up @@ -366,7 +369,7 @@ Each outcome object in `discarded_events` has:

</SpecSection>

<SpecSection id="discard-reasons" status="stable" since="1.0.0">
<SpecSection id="discard-reasons" status="stable" since="1.26.0">

### Discard Reasons

Expand All @@ -387,7 +390,7 @@ The following discard reasons are defined for `discarded_events`:
| `backpressure` | 1.13.0 | Downsampling due to system load. |
| `buffer_overflow` | 1.15.0 | SDK internal buffer (e.g., breadcrumbs buffer) overflowed. |
| `ignored` | 1.16.0 | Telemetry item was ignored by the SDK (e.g., a span was ignored by `ignore_spans`; can also be used by other deny-list mechanisms). |
| `invalid` | 1.17.0 | Failed validation (e.g., replay session exceeded maximum allowed length). |
| `invalid` | 1.17.0 | Telemetry item failed validation or (since 1.26.0) was otherwise invalid, and no more specific reason applies. |
| `no_parent_span` | 1.22.0 | Span was not started or dropped because no parent span was present at span start (for example, auto-instrumented spans suppressed when the request happens outside an active span). |
| `callback_error` | 1.24.0 | A user-provided callback (e.g., `before_send`, `traces_sampler`) threw an error. |

Expand Down
Loading