OneAgent release notes version 1.309
Rollout start: Mar 11, 2025
With this release, the following are the oldest supported OneAgent versions.
For details, see How long are versions supported following rollout?.
Technology support
Definition of the technology support version schema with examples:
-
Major version 5 is supported
- Major version 5 is supported, including all of its minor versions like 5.1 and 5.2
- Other major versions are not supported like 6 and 7
-
Minor version 5.1 is supported
- Minor version 5.1 is supported, including all of its patch versions like 5.1.1 and 5.1.2
- Other minor versions are not supported like 5.2 and 5.3
-
Patch version 5.1.1 is supported
- Patch version 5.1.1 is supported
- Other patch versions are not supported like 5.1.2 and 5.1.3
-
Version range 5.1 – 5.3 is supported
- Minor versions 5.1, 5.2, and 5.3 are supported, including all of their patch versions like 5.1.1, 5.2.1, and 5.3.1
- Other minor versions are not supported like 5.0 and 5.4
-
The minimum required version is 5+
- All major, minor, and patch versions starting from version 5 are supported, like 5, 5.1, 5.1.1, and 6
New technology support
For more information, see New technology support.
- Windows Server 2025 (OS module)
- CPython 3.8 - 3.13 (Python)
- Flask 1.1.2+ (Python module). OneAgent feature: Python Celery
- Django 1.8+ (Python module). OneAgent feature: Python Django
- Tornado 6.0+ (Python module). OneAgent feature: Python Tornado
- FastAPI 0.44+ (Python module). OneAgent feature: Python FastAPI
- Starlette 0.12+ (Python module). OneAgent feature: Python Starlette
- Requests 2 (Python module). OneAgent feature: Python Requests
- urllib3 2.0+ (Python module). OneAgent feature: Python urllib3
- Celery 5.3+ (Python module). OneAgent feature: Python Celery
- SQL Alchemy 1.1+ (Python module). OneAgent feature: Python SQLAlchemy
- psycopg2 2.8.4+ (Python module). OneAgent feature: Python psycopg2
- Python standard library: asyncio (Python module)
- Python standard library: concurrent.futures (Python module). OneAgent feature: Python concurrent.futures thread, Python concurrent.futures process
- Python standard library: threading (Python module). OneAgent feature: Python threading
- Python standard library: subprocess (Python module). OneAgent feature: Python subprocess
- Python standard library: queue (Python module). OneAgent feature: Python queue
End of support
For more information, see End of support announcements.
New features and enhancements
Feature update 
Infrastructure Observability | Log Monitoring
Collect and manage Kubernetes logs without full OneAgent
Dynatrace provides a flexible approach to Kubernetes observability, allowing you to easily select the level of observability required for your needs. This includes log collection and management for your Kubernetes environments. Our updated log capabilities for Kubernetes allow you to:
- Stream Kubernetes logs without running a OneAgent host module, to start small and extend later
- Get insights into logs from short-lived containers and pods such as InitContainers and Jobs
- Analyze logs in context of automatically enriched Kubernetes metadata (and traces if OneAgent code modules are in place)
- Easily onboard log analytics within the Kubernetes app
See the Deployment and Kubernetes logging made easy: Comprehensive Kubernetes visibility with Dynatrace post to learn more about the Dynatrace Log Module for Kubernetes.
Feature update Infrastructure Observability | Hosts
Improved Nginx manual runtime instrumentation
-
The environment variable
DT_NGINX_FORCE_RUNTIME_INSTRUMENTATIONnow consistently enforces manual runtime instrumentation, regardless of whether the Nginx binary is identified as a "patched" binary. -
The Nginx manual runtime instrumentation method now takes advantage of cached offsets, resulting in faster subsequent startups and reduced CPU and memory overhead.
Feature update Infrastructure Observability | Hosts
Improved OS services monitoring messaging
The OneAgent OS module now sends a one-time event if OS services monitoring initialization fails on Linux.
Feature update Infrastructure Observability | Hosts
Improved IBM App Connect Enterprise (ACE) trace linkage
Improved trace linkage for message flows in IBM ACE 12 and 13 that solely rely on trace context tagging (where no Dynatrace tagging is used).
Feature update Runtime Application Protection | Attacks
Change in allowlist evaluation
The evaluation of attack patterns in allowlisting rules (Settings > Application Security > Application Protection > Allowlist) is no longer case-sensitive. For example, the teststring attack pattern will now match TeStStRiNg.
Resolved issues
General Availability (Build 1.309.59)
The 1.309 GA release doesn't contain any user-facing resolved issues.
Update 65 (Build 1.309.65)
This cumulative update contains 2 resolved issues and all previously released updates for the 1.309 release.
| Component | Resolved issues |
|---|---|
| Logging module | 1 |
| OS module | 1 |
Logging module
- Optimized log reading time in case of a remote drive with low response time, where a directory with a very high number of log files is monitored by the OneAgent logs code module. This fix also reduces the time delay for log ingesting. (OA-43965)
OS module
- Fixed an issue that caused monitoring loss of some alias OS services on Linux machines with systemd versions 219-245. (OA-44263)
Update 66 (Build 1.309.66)
This cumulative update contains 1 resolved issue and all previously released updates for the 1.309 release.
Logging module
- Fixed tracking of active container logs for Kubernetes if 'Settings > Log module feature flags > Collect all container logs' is enabled and Dynatrace stops ingesting logs. It was leading to disk space not being reclaimed due to outstanding file handles to already deleted container logs. (OA-45092)
OneAgent for Android
Breaking change Digital Experience | RUM Mobile
Dynatrace Android Gradle plugin
New verification logic cancels the build when an unsupported Jetpack Compose version is used.
General Availability (Build 8.309.1)
The 8.309 GA release doesn't contain any user-facing resolved issues.
OneAgent for iOS
Breaking change Digital Experience | RUM Mobile
Xcode 15 is no longer supported
With agent version 8.309, Xcode 15 is no longer supported.
Feature update Digital Experience | RUM Mobile
Instrumentor: Improved error messaging for unknown project
Error messages have been improved for installing and uninstalling the SwiftUI Instrumentor.
General Availability (Build 8.309.1)
The 8.309 GA release doesn't contain any user-facing resolved issues.
OneAgent for JavaScript
General Availability (Build 1.309.3)
The 1.309 GA release contains 1 resolved issue.
JavaScript
- Prevented floating point start/end timestamps from being used by dtrum API. (DEM-4872)