Skip to content

docs(js): Add elementTimingIntegration documentation#17162

Merged
logaretm merged 2 commits intomasterfrom
awad/add-element-timing-integration
Apr 1, 2026
Merged

docs(js): Add elementTimingIntegration documentation#17162
logaretm merged 2 commits intomasterfrom
awad/add-element-timing-integration

Conversation

@logaretm
Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

Document the new standalone elementTimingIntegration that collects Element Timing API data as Sentry distribution metrics. This replaces the deprecated enableElementTiming option on browserTracingIntegration.

Refs getsentry/sentry-javascript#19869

Changes:

  • New integration doc page at docs/platforms/javascript/common/configuration/integrations/elementtiming.mdx
  • Added elementTimingIntegration to the browser integrations table
  • Added an "Integrations" section to the metrics page linking to the new integration

Note: The upstream SDK PR (getsentry/sentry-javascript#19869) has been merged but not yet released. This PR should be merged once the feature ships in a JS SDK release (expected 10.47.0). The SDK version in the alert will need to be updated to match the actual release version.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • 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

Make sure you've checked the following before merging your changes:

  • 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

@vercel
Copy link
Copy Markdown

vercel bot commented Mar 27, 2026

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

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Apr 1, 2026 1:31pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Apr 1, 2026 1:31pm

Request Review

@inventarSarah
Copy link
Copy Markdown
Collaborator

👋 @logaretm, can we review this already, or should we wait until you set the PR to ready?

Copy link
Copy Markdown
Member

@Lms24 Lms24 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks for adding!

@logaretm logaretm marked this pull request as ready for review March 31, 2026 14:38
Copilot AI review requested due to automatic review settings March 31, 2026 14:38
@logaretm
Copy link
Copy Markdown
Member Author

@inventarSarah please do, I marked it as draft to prevent merging it before the release goes through. It is unblocked now!

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds documentation for the new standalone elementTimingIntegration, which captures Element Timing API measurements and emits them as Sentry distribution metrics, and wires the new doc into the JavaScript docs navigation/discovery points.

Changes:

  • Added a new integration documentation page for elementTimingIntegration.
  • Added elementTimingIntegration to the JavaScript browser integrations table.
  • Added an “Integrations” section to the JavaScript metrics page linking to the new integration.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
platform-includes/configuration/integrations/javascript.mdx Adds elementTimingIntegration to the JavaScript integrations table.
docs/platforms/javascript/common/metrics/index.mdx Adds an “Integrations” section linking metrics users to the new integration page (browser-only).
docs/platforms/javascript/common/configuration/integrations/elementtiming.mdx New docs page describing setup, element marking, emitted metrics, and migration from enableElementTiming.

Copy link
Copy Markdown
Collaborator

@inventarSarah inventarSarah left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you, looks good to me! 👍

Added two small suggestions

| Attribute | Description |
| ----------------------- | ------------------------------------------------ |
| `ui.element.identifier` | The value of the `elementtiming` HTML attribute. |
| `ui.element.paint_type` | `image-paint` or `text-paint`. |
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you please also add a short description here, as you did with the other attributes


</Alert>

This integration requires [Sentry Metrics](./../../../metrics/) to be available in your Sentry organization.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

users also need tracing, right? We could mention this here too.

You can use PlatformLink for the link like so:

This integration requires <PlatformLink to="/metrics">Sentry Metrics</PlatformLink> to be available in your Sentry organization.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This doesn't need tracing, just metrics. It did require it in early implementations, so I will update the snippet above to avoid confusing anyone.

I will use the link component, thanks!

logaretm and others added 2 commits April 1, 2026 09:15
Document the new standalone elementTimingIntegration that collects
Element Timing API data as Sentry distribution metrics. This replaces
the deprecated enableElementTiming option on browserTracingIntegration.

Refs getsentry/sentry-javascript#19869
Co-Authored-By: Claude <noreply@anthropic.com>
- Use PlatformLink for metrics link
- Add description for paint_type attribute
- Remove browserTracingIntegration from setup snippet (not required)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@logaretm logaretm force-pushed the awad/add-element-timing-integration branch from 2da78c9 to 0e49616 Compare April 1, 2026 13:20
@logaretm logaretm merged commit ba08e35 into master Apr 1, 2026
18 checks passed
@logaretm logaretm deleted the awad/add-element-timing-integration branch April 1, 2026 13:45
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.

4 participants