Skip to content

Conversation

@hectorhdzg
Copy link
Member

@hectorhdzg hectorhdzg commented Nov 11, 2025

This is to continue discussion in original PR #1943, thanks @Karlie-777 for your efforts, I will try to add comments for open questions/issues here.

Changes

Adds Browser Resource Timing events to the Semantic Conventions

Merge requirement checklist

  • CONTRIBUTING.md guidelines followed.
  • Change log entry added, according to the guidelines in When to add a changelog entry.
    • If your PR does not need a change log, start the PR title with [chore]
  • Links to the prototypes or existing instrumentations (when adding or changing conventions)

@hectorhdzg
Copy link
Member Author

@martinkuba updated url.full to be part of body field and updated description, related to
https://github.com/open-telemetry/semantic-conventions/pull/1943/files#r2108097641

@hectorhdzg
Copy link
Member Author

Open questions are related to having query string separately, let me know your thoughts @joaquin-diaz @overbalance @trask
https://github.com/open-telemetry/semantic-conventions/pull/1943/files#r2416951311

Copy link
Contributor

@thompson-tomo thompson-tomo left a comment

Choose a reason for hiding this comment

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

We need to consider the outcome of #2827 (comment) and ensure that what is done for resources is consistent with http etc.

Ie do we just use the http span or do we need a new file.download.client span? I suspect we might need to stick to the http span if it is too difficult for instrumentation to determine which span definition needs to be used.

| `responseEnd` | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | double | The [time](https://developer.mozilla.org/en-US/docs/Web/API/DOMHighResTimeStamp) immediately after the browser receives the last byte of the resource or immediately before the transport connection is closed, whichever comes first, in milliseconds. See [responseEnd](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming/responseEnd). | `510.6000000014906` |
| `responseStart` | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | double | The [time](https://developer.mozilla.org/en-US/docs/Web/API/DOMHighResTimeStamp) immediately after the browser receives the first byte of the response from the server, cache, or local resource, in milliseconds. See [responseStart](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming/responseStart). | `508.6000000014901` |
| `secureConnectionStart` | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | double | The [time](https://developer.mozilla.org/en-US/docs/Web/API/DOMHighResTimeStamp) immediately before the browser starts the handshake process to secure the current connection, in milliseconds. See [secureConnectionStart](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming/secureConnectionStart). | `476.6000000014903` |
| `url` | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The full URL of the resource being fetched. [1] | `https://www.example.com/path`; `//localhost` |
Copy link
Contributor

@thompson-tomo thompson-tomo Nov 12, 2025

Choose a reason for hiding this comment

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

Why don't we make this file.path and have it as an attribute? If we don't create a dedicated span

Choose a reason for hiding this comment

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

Not all resources are files. ResourceTiming also applies to fetch, xhr, and beacon.

Copy link
Contributor

Choose a reason for hiding this comment

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

For fetch/xhr/Beacon why aren't we using the standard http client span? We can use the pr linked in my other comment to handle capturing the timing details.

@github-project-automation github-project-automation bot moved this from Untriaged to Blocked in Semantic Conventions Triage Nov 14, 2025
@trask trask moved this from Blocked to Awaiting codeowners approval in Semantic Conventions Triage Nov 17, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Awaiting codeowners approval

Development

Successfully merging this pull request may close these issues.

4 participants