Elastic Distribution of OpenTelemetry Browser release notes

Review the changes, fixes, and more in each version of Elastic Distribution of OpenTelemetry Browser (EDOT Browser).

To check for breaking changes, see EDOT Browser Breaking Changes.

To check for security updates, go to Security announcements for the Elastic stack.

• Add ignoreFetchUrls to exclude URLs from fetch, XMLHttpRequest, and resource timing instrumentation. Strings and regular expressions are supported; OTLP export URLs are always ignored. Ref: https://github.com/elastic/elastic-otel-rum-js/issues/151
• Add exportConfig.tracesUrl, exportConfig.logsUrl and exportConfig.metricsUrl to export a signal to a custom URL. The URL is used as is, without appending /v1/<signal>. Ref: https://github.com/elastic/elastic-otel-rum-js/issues/166
• Add disableInstrumentations to turn off selected built-in instrumentations by key (for example, web-vitals or resource-timing). If you set both disableInstrumentations and instrumentations for the same key, disableInstrumentations takes precedence. Ref: https://github.com/elastic/elastic-otel-rum-js/pull/170
• Expire sessions based on user activity. Sessions end after 30 minutes without user interaction, or 4 hours in total. Telemetry sent after that has no session.id until the next interaction. Set session.activityEvents to define what counts as activity. Ref: https://github.com/elastic/elastic-otel-rum-js/issues/81
• Add a session API. The SDK returned by startBrowserSdk has sdk.getSession() and sdk.addObserver() for reading the current session and reacting when sessions start and end. Ref: https://github.com/elastic/elastic-otel-rum-js/issues/81
• Add sdk.endSession() to end the current session, for example on logout. The next session starts on the next user interaction. Ref: https://github.com/elastic/elastic-otel-rum-js/issues/123

• Fix cross-tab session handling when another tab calls endSession() while this tab is within the activity read throttle. Tabs listen for storage events on the shared session key so onSessionEnded runs promptly and the next user activity can start a new session. Ref: https://github.com/elastic/elastic-otel-rum-js/issues/176
• Fix export URLs when exportConfig.url has no trailing slash. The path separator was missing, so https://example.com/api exported to https://example.com/apiv1/traces. Ref: https://github.com/elastic/elastic-otel-rum-js/issues/168

• Emit a message when instrumentations configuration option is used to warn users the upstream configurations are unstable. Ref: https://github.com/elastic/elastic-otel-rum-js/issues/152

• Align configuration with the upstream browser-sdk.
• Add session tracking. Spans and log records include session.id, session.previous_id, and browser.tab.id attributes. A session.start event is emitted when a session starts. Ref: https://github.com/elastic/elastic-otel-rum-js/issues/115
• Add session-level sampling via session.sampleRate. Sampled sessions export automatic RUM telemetry; unsampled sessions disable instrumentations. Spans and logs include session.sampling_rate for backend weighting. Refer to Configure EDOT Browser. Ref: https://github.com/elastic/elastic-otel-rum-js/pull/128

• Use the new upstream @opentelemetry/browser-sdk package to setup traces and logs signal.
• Switch to the new upstream navigation instrumentation from @opentelemetry/browser-sdk package.
  • It replaces the former @opentelemetry/instrumentation-browser-navigation. the new instrumentation is a port from opentelemetry-js-contrib to opentelemetry-browser. There are no changes in the data model rather than the scope.
  • This change breaks the configuration interface of instrumentation switching the configuration key from the full scope to a shorter name navigation.
• Update typescript package to match the version in opentelemetry-browser.
  • SDK has been updated to return a no-op SDK to conform to the types in the previous version.
  • Internal JSDoc comments have been updated for better type checking.
• Remove patching of window.setImmediate function in the context manager. The function is deprecated and not available in the majority of browsers. Ref: https://developer.mozilla.org/en-US/docs/Web/API/Window/setImmediate

• Update all @opentelemetry/* upstream package dependencies to the latest releases:
  • v2.8.0 release from opentelemetry-js
  • experimental/v0.219.0 release from opentelemetry-js
  • opentelemetry-js-contrib release
  • @opentelemetry/browser-instrumentation v0.5.2 release from opentelemetry-browser

• Update all @opentelemetry/* upstream package dependencies to the latest releases:
  • v2.7.0 release from opentelemetry-js
  • experimental/v0.215.0 release from opentelemetry-js
  • opentelemetry-js-contrib releases up to 2026-04-28
  • @opentelemetry/browser-instrumentation v0.3.0 release from opentelemetry-browser

First release of the Elastic Distribution of OpenTelemetry Browser.