Skip to content

feat(op): Add browser resource, timing phase, and UI span operations - #547

Merged
msonnb merged 1 commit into
mainfrom
ms/op-browser-spans
Jul 31, 2026
Merged

feat(op): Add browser resource, timing phase, and UI span operations#547
msonnb merged 1 commit into
mainfrom
ms/op-browser-spans

Conversation

@msonnb

@msonnb msonnb commented Jul 31, 2026

Copy link
Copy Markdown
Member

Description

Add new browser ops:

  • Resource initiator types: resource.worker, resource.icon, resource.frame, resource.object, resource.ping, resource.track.
  • Navigation timing phases: browser.unload_event, browser.redirect, browser.dom_content_loaded_event, browser.load_event, browser.connect, browser.tls_ssl, browser.cache, browser.dns, browser.request, browser.response.
  • UI operations: ui.mount, ui.update, ui.unmount, ui.long_task, ui.long_animation_frame, ui.interaction.click/hover/drag/press, ui.webvital.lcp, ui.webvital.cls.

PR Checklist

  • I have run yarn test and verified that the tests pass.
  • I have run yarn generate to generate and format code and docs.

If an attribute was added:

  • The attribute is in a namespace (e.g. nextjs.function_id, not function_id)
  • I have used the correct value for apply_scrubbing (i.e. manual or auto. Use never only for values that should never be scrubbed such as IDs)

If an attribute was deprecated:

Register the finite browser span operations emitted by sentry-javascript:

- Resource initiator types: resource.worker, resource.icon, resource.frame,
  resource.object, resource.ping, resource.track (resource.other retained as
  the fallback).
- Navigation timing phases: browser.unload_event, browser.redirect,
  browser.dom_content_loaded_event, browser.load_event, browser.connect,
  browser.tls_ssl, browser.cache, browser.dns, browser.request,
  browser.response.
- UI operations: ui.mount, ui.update, ui.unmount, ui.long_task,
  ui.long_animation_frame, ui.interaction.click/hover/drag/press,
  ui.webvital.lcp, ui.webvital.cls.

Generated artifacts (op.ts, op.rs) regenerated via `yarn generate`.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@msonnb
msonnb requested review from a team, Lms24, cleptric, mjq and nsdeschenes as code owners July 31, 2026 10:51
@github-actions

Copy link
Copy Markdown

Semver Impact of This PR

🟡 Minor (new features)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).


Breaking Changes 🛠

  • (op) Add gen_ai prefix to existing ops and add embeddings, generate_content, and rerank ops by msonnb in #543

New Features ✨

Attributes

  • Add query, deprecated in favor of db.query.text by alexander-alderman-webb in #530
  • Add aws.operation_name, deprecated in favor of rpc.method by alexander-alderman-webb in #536
  • Add db.params, deprecated in favor of db.query.parameter.<key> by alexander-alderman-webb in #529
  • Add code, deprecated in favor of rpc.response.status_code by alexander-alderman-webb in #533
  • Add django.function_name, deprecated in favor of code.function.name by alexander-alderman-webb in #538
  • Add port, deprecated in favor of server.port by alexander-alderman-webb in #532
  • Add redis.command, deprecated in favor of db.operation.name by alexander-alderman-webb in #531
  • Add address, deprecated in favor of server.address by alexander-alderman-webb in #534
  • Add aws_region, deprecated in favor of cloud.region by alexander-alderman-webb in #537
  • Add gcp_region, deprecated in favor of cloud.region by alexander-alderman-webb in #535
  • Add django.middleware_name (deprecated) in favor of middleware.name by alexander-alderman-webb in #520
  • Add starlite.middleware_name (deprecated) in favor of middleware.name by alexander-alderman-webb in #519
  • Add aws.request.url (deprecated) in favor of url.full by sentrivana in #488
  • Add subprocess.pid (deprecated) in favor of process.pid by sentrivana in #487
  • Add litestar.middleware_name (deprecated) in favor of middleware.name by sentrivana in #486
  • Add starlette.middleware_name (deprecated) in favor of middleware.name by sentrivana in #485
  • Add redis.key (deprecated) in favor of db.redis.key by sentrivana in #484
  • Add db.mongodb.collection (deprecated) in favor of db.collection.name by sentrivana in #483
  • Add Kafka messaging attributes by chargome in #474
  • Deprecate rpc.grpc.status_code in favor of rpc.response.status_code by lucas-zimerman in #494
  • Add deprecated messaging.destination_kind by andreiborza in #509
  • Add sentry.segment.name.source attribute by Lms24 in #466
  • Add attribute transformations by constantinius in #465
  • Add stable app vitals attributes by buenaflor in #493
  • Deprecate sentry.frames.* attributes by buenaflor in #500
  • Add missing AI legacy aliases from Relay SpanData by vgrozdanic in #498

Op

  • Add browser resource, timing phase, and UI span operations by msonnb in #547
  • Add object storage span operations by msonnb in #545
  • Add http.client.stream op by msonnb in #544

Other

  • (conventions) Support multiple examples by Lms24 in #505
  • (descriptions) Add http.route description template for http.server span description inference by Lms24 in #518

Internal Changes 🔧

Attribute

  • Add more examples for valid sentry.kind values by Lms24 in #517
  • Improve db.statement example and add deprecation reason by Lms24 in #501

Attributes

  • Disambiguate http.route and url.template attributes by Lms24 in #521
  • Improve description of sentry.segment.name.source by Lms24 in #511
  • Deprecate sentry.span.source and change backfill status of sentry.source by Lms24 in #510

Deps

  • Bump dompurify from 3.4.11 to 3.4.12 by dependabot in #525
  • Bump fast-uri from 3.1.2 to 3.1.4 by dependabot in #526
  • Bump svgo from 4.0.1 to 4.0.2 by dependabot in #524
  • Bump js-yaml from 4.2.0 to 4.3.0 by dependabot in #516
  • Bump astro from 6.4.7 to 7.1.0 in /docs by dependabot in #514

Other

  • (attrs) Backport attributes and normalizations from Relay by Dav1dde in #497
  • (codeowners) Assign telemetry-experience to gen_ai/ai attributes by vgrozdanic in #506
  • (deps-dev) Bump tar from 7.5.16 to 7.5.19 by dependabot in #515
  • (release) Show version in workflow run title by constantinius in #504

🤖 This preview updates automatically when you update the PR.

@msonnb

msonnb commented Jul 31, 2026

Copy link
Copy Markdown
Member Author

Note: these are all snake_case now, whereas in the JS SDK we use a mixture of snake_kase, kebab-case, camelCase, UPPERCASE (for acronyms)

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Want reviews to match your repository better? Bugbot Learning can learn team-specific rules from PR activity. A team admin can enable Learning in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit db539fa. Configure here.

Comment thread model/op/browser.json
{
"name": "ui.long_task",
"description": "A long task on the main UI thread, as reported by the Long Tasks API."
},

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Duplicate long task span ops

Medium Severity

ui.long_task overlaps with the existing ui.task op, which already covers Long Tasks API main-thread work. Shipping both as active conventions fragments telemetry and leaves SDK authors without a single canonical op for the same concept.

Additional Locations (1)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit db539fa. Configure here.

@msonnb
msonnb merged commit 8c8bb62 into main Jul 31, 2026
16 checks passed
@msonnb
msonnb deleted the ms/op-browser-spans branch July 31, 2026 11:58
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.

2 participants