﻿---
title: Elastic Distribution of OpenTelemetry iOS release notes
description: Release notes for the Elastic Distribution of OpenTelemetry iOS (previously Elastic APM Agent for iOS).
url: https://www.elastic.co/elastic/docs-builder/docs/4120/release-notes/edot/sdks/ios
products:
  - APM Agent
  - Elastic Cloud Serverless
  - Elastic Distribution of OpenTelemetry SDK
  - Elastic Distribution of OpenTelemetry iOS
  - Elastic Observability
applies_to:
  - Serverless Observability projects: Generally available
  - Elastic Stack: Generally available
---

# Elastic Distribution of OpenTelemetry iOS release notes
Review the changes, fixes, and more in each version of Elastic Distribution of OpenTelemetry iOS.
To check for security updates, go to [Security announcements for the Elastic stack](https://discuss.elastic.co/c/announcements/security-announcements/31).

## 2.1.0

**Release date:** September 11, 2026

### Features and enhancements

- Emit `app.installation.id` as a UUID persisted for the lifetime of the install [#388](https://github.com/elastic/apm-agent-ios/pull/388)
- Update default telemetry names to current OpenTelemetry semantic conventions, and add `useLegacyAttributeNames` to restore the previous names [#377](https://github.com/elastic/apm-agent-ios/pull/377)
- Default the OTLP transport to HTTP. gRPC remains available through `useConnectionType(.grpc)` [#372](https://github.com/elastic/apm-agent-ios/pull/372)
- Deprecate the `ElasticAttributes` constants in favor of OpenTelemetry semantic-convention constants [#377](https://github.com/elastic/apm-agent-ios/pull/377)
- Raise the OpenTelemetry-Swift dependency floor to 2.4.1
- Require an explicit OTLP export URL with an `http` or `https` scheme and a host before an enabled agent starts. Do not fall back to a localhost endpoint [#372](https://github.com/elastic/apm-agent-ios/pull/372)


### Fixes

- Decode central configuration sample rate from `session_sample_rate` [#391](https://github.com/elastic/apm-agent-ios/pull/391)
- Exclude SDK-owned export and management requests from URLSession tracing [#387](https://github.com/elastic/apm-agent-ios/pull/387)
- Prefer delta aggregation temporality for counters and histograms [#384](https://github.com/elastic/apm-agent-ios/pull/384)
- Isolate persisted traces, metrics, and logs by signal [#376](https://github.com/elastic/apm-agent-ios/pull/376)
- Harden network connection status initialization [#389](https://github.com/elastic/apm-agent-ios/pull/389)


## 2.0.2

**Release date:** July 28, 2026

### Features and enhancements

- Require swift-nio-ssl 2.37.2 or later to ensure builds resolve an up-to-date version [#362](https://github.com/elastic/apm-agent-ios/pull/362)


## 2.0.1

**Release date:** May 20, 2026

### Features and enhancements

- [Breaking] Disable MetricKit instrumentation and make `withAppMetricInstrumentation` a deprecated no-op because it is incompatible with OpenTelemetry-Swift 2.x metrics [#349](https://github.com/elastic/apm-agent-ios/pull/349)


## 2.0.0

**Release date:** February 24, 2026

### Features and enhancements

- [Breaking] Update OpenTelemetry-Swift from 1.17.0 to 2.x and use the new `opentelemetry-swift-core` package for the API and SDK [#321](https://github.com/elastic/apm-agent-ios/pull/321)
- [Breaking] Remove `AgentConfigBuilder.addMetricFilter` and custom metric signal filtering due to upstream metrics API changes [#321](https://github.com/elastic/apm-agent-ios/pull/321)
- Deprecate MetricKit instrumentation because it is incompatible with OpenTelemetry-Swift 2.x metrics [#321](https://github.com/elastic/apm-agent-ios/pull/321)


## 1.4.0


### Features and enhancements

- OpAMP support [#290](https://github.com/elastic/apm-agent-ios/pull/290)


### Fixes

- Respect custom exportUrl path [#310](https://github.com/elastic/apm-agent-ios/pull/310)


## 1.3.0

**Release date:** August 25, 2025

### Features and enhancements

- [Breaking] Raise the minimum requirements to Swift 5.10, iOS 16, macOS 13, tvOS 16, and watchOS 10 [#281](https://github.com/elastic/apm-agent-ios/pull/281)
- Updated OpenTelemetry-Swift to version 1.17.0
- Allow signal filters to be mutable [#266](https://github.com/elastic/apm-agent-ios/pull/266)
- Added mutableLogRecord so attributes can be appended during filtering [#271](https://github.com/elastic/apm-agent-ios/pull/271)
- Adds support for custom collector paths [#267](https://github.com/elastic/apm-agent-ios/pull/276)
- Signal interceptors [#283](https://github.com/elastic/apm-agent-ios/pull/283)


## 1.2.1

**Release date:** February 21, 2025

### Features and enhancements

- Updated OpenTelemetry-Swift to version 1.13.0


### Fixes

- Make crash reports respect the configured connection type [#249](https://github.com/elastic/apm-agent-ios/pull/249)


## 1.2.0


### Features and enhancements

- Bumped Reachability to version 5.2.4 [#245](https://github.com/elastic/apm-agent-ios/pull/245)
- Updated OpenTelemetry-Swift to version 1.12.1


## 1.1.0


### Features and enhancements

- Updated OpenTelemetry-Swift to version 1.11.0


## 1.0.5


### Fixes

- Fixes HTTP connection type [#239](https://github.com/elastic/apm-agent-ios/pull/239)


## 1.0.4


### Fixes

- Updated privacy manifest [#233](https://github.com/elastic/apm-agent-ios/pull/233)


## 1.0.3


### Features and enhancements

- Added options to use HTTP instead of GRPC for Exporters [#228](https://github.com/elastic/apm-agent-ios/pull/228)


### Fixes

- Fixed ntp clock logging to only occur once. [#229](https://github.com/elastic/apm-agent-ios/pull/229)


## 1.0.2


### Features and enhancements

- Added Privacy Manifest file [#217](https://github.com/elastic/apm-agent-ios/pull/217).


## 1.0.1


### Fixes

- Fixed memory leaks related to NTP usage [#212](https://github.com/elastic/apm-agent-ios/pull/212).


## 1.0.0


### Features and enhancements

- Added network status to all signals [#202](https://github.com/elastic/apm-agent-ios/pull/202).
- Added session.id to crash reports [#197](https://github.com/elastic/apm-agent-ios/pull/197).