﻿---
title: Elastic Distribution of OpenTelemetry Browser release notes
description: Release notes for Elastic Distribution of OpenTelemetry Browser.
url: https://www.elastic.co/docs/release-notes/edot/sdks/rum
products:
  - Elastic Cloud Serverless
  - Elastic Distribution of OpenTelemetry Browser (RUM)
  - Elastic Distribution of OpenTelemetry SDK
  - Elastic Observability
applies_to:
  - Serverless Observability projects: Generally available
  - Elastic Stack: Generally available
---

# 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](https://www.elastic.co/docs/release-notes/edot/sdks/rum/breaking-changes).
To check for security updates, go to [Security announcements for the Elastic stack](https://discuss.elastic.co/c/announcements/security-announcements/31).

## version.next


### Features and enhancements

- 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](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](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](https://github.com/elastic/elastic-otel-rum-js/pull/170)


### Fixes

- 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](https://github.com/elastic/elastic-otel-rum-js/issues/168)


### Chores

- 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](https://github.com/elastic/elastic-otel-rum-js/issues/152)


## 0.4.0


### Features and enhancements

- Align configuration with the upstream [browser-sdk](https://github.com/open-telemetry/opentelemetry-browser/tree/main/packages/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](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](/docs/reference/opentelemetry/edot-sdks/browser/configuration#otel_browser_session-sampling).
  Ref: [https://github.com/elastic/elastic-otel-rum-js/pull/128](https://github.com/elastic/elastic-otel-rum-js/pull/128)


### Chores

- 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](https://github.com/open-telemetry/opentelemetry-js-contrib) to
    [opentelemetry-browser](https://github.com/open-telemetry/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](https://github.com/open-telemetry/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](https://developer.mozilla.org/en-US/docs/Web/API/Window/setImmediate)


## 0.3.0


### Chores

- Update all `@opentelemetry/*` upstream package dependencies to the latest releases:
  - [`v2.8.0` release](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.8.0) from opentelemetry-js
  - [`experimental/v0.219.0` release](https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.219.0) from opentelemetry-js
  - [opentelemetry-js-contrib release](https://github.com/open-telemetry/opentelemetry-js-contrib/pull/3524)
  - [`@opentelemetry/browser-instrumentation v0.5.2` release](https://github.com/open-telemetry/opentelemetry-browser/releases/tag/browser-instrumentation-v0.5.2) from opentelemetry-browser


## 0.2.0


### Chores

- Update all `@opentelemetry/*` upstream package dependencies to the latest releases:
  - [`v2.7.0` release](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.7.0) from opentelemetry-js
  - [`experimental/v0.215.0` release](https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.215.0) from opentelemetry-js
  - [opentelemetry-js-contrib releases](https://github.com/open-telemetry/opentelemetry-js-contrib/releases) up to 2026-04-28
  - [`@opentelemetry/browser-instrumentation v0.3.0` release](https://github.com/open-telemetry/opentelemetry-browser/releases/tag/browser-instrumentation-v0.3.0) from opentelemetry-browser


## 0.1.0

First release of the Elastic Distribution of OpenTelemetry Browser.