Skip to content

docs(replay): Add traces_by_timestamp field to replay event spec#16602

Draft
billyvg wants to merge 1 commit intomasterfrom
billy/add-traces-by-timestamp-field
Draft

docs(replay): Add traces_by_timestamp field to replay event spec#16602
billyvg wants to merge 1 commit intomasterfrom
billy/add-traces-by-timestamp-field

Conversation

@billyvg
Copy link
Member

@billyvg billyvg commented Feb 26, 2026

DESCRIBE YOUR PR

Document the new traces_by_timestamp field added to the replay event payload in getsentry/sentry-javascript#18048.

This field sends [timestamp, trace_id] pairs alongside the existing trace_ids list, enabling Sentry to associate replay custom events with the correct trace using temporal ordering (needed for migrating custom rrweb events to EAP).

  • Added traces_by_timestamp to the Replay Attributes table (type List[[Number, String]], optional, since 1.3.0)
  • Updated trace_ids description for clarity
  • Added field to both example JSON blocks (Replay Event and Full Envelope)
  • Bumped spec version to 1.3.0 with changelog entry

IS YOUR CHANGE URGENT?

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

Co-Authored-By: Claude noreply@anthropic.com

Document the new `traces_by_timestamp` field added in
getsentry/sentry-javascript#18048. This field provides timestamped
trace associations as `[timestamp, trace_id]` pairs, enabling Sentry
to correlate replay events with the correct trace by temporal ordering.

The existing `trace_ids` field is preserved for backwards compatibility.

Co-Authored-By: Claude <noreply@anthropic.com>
@vercel
Copy link

vercel bot commented Feb 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
develop-docs Building Building Preview, Comment Feb 26, 2026 4:30pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
sentry-docs Ignored Ignored Feb 26, 2026 4:30pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant