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 | Java
Java 24 processes are now fully monitored
As of this OneAgent release, Java 24 processes are now fully monitored. We now support LTS versions plus the last four Java versions (21, 22, 23, 24).
However, Java 20 is no longer monitored. If you are running Java 20, you need to update your JVMs or keep using older OneAgent versions.
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 contains 16 resolved issues.
| Component | Resolved issues |
|---|---|
| General | 2 |
| .NET | 3 |
| Extensions framework | 1 |
| Logging module | 1 |
| Mainframe | 1 |
| Node.js | 1 |
| OS module | 4 |
| Python | 1 |
| Java | 1 |
| IIS | 1 |
General
- Missing Checks in FlawFinder Trampolines. (OA-42246)
- Tomcat process detection generates false positives when the CATALINA_HOME is set host-wide. (OA-44433)
.NET
- .NET ADO.NET feature controller is ignored if ADO V2 is disabled. (OA-42138)
- Investigate MongoDB sensor bug with OA 307. (OA-43215)
- Add additional checks for unsupported MassTransit versions. (OA-43687)
Extensions framework
- Prometheus datasource request enconding. (DAQ-5523)
Logging module
- We observed that some Logging modules had problems starting on some Windows OS versions. In some cases, rebooting the whole machine helped, but not always. This fix resolves that issue. (OA-45804)
Mainframe
- The IMS agent has been changed to ignore IMS log records from Fastpath Utility regions. (OA-42520)
Node.js
- fix ExpressSensor "use" function wrapper function properties. (OA-41059)
OS module
- NFS Disk Utilization values are negative. (OA-41131)
- There is nullptr deference in shared_ptr within CarbonBlack grouping. (OA-43197)
- "Host ungracefully rebooted" events occurring improperly. (OA-43315)
- Detecting cgroup v2 in containerized OS Agent doesn’t work properly for all cases. (OA-43675)
Python
- Instrumented ProcessPoolExecutor.submit() breaks if a keyword-arg is passed by user. (OA-43956)
Java
- OpenTelemetry side-by-side support for JDK HTTP Client broken since OTel 2.12. (OA-42095)
IIS
- OneAgent is modifying/removing the Content-Length header value when Business Events is enabled. (OA-40375)
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
- OneAgent log ingest delay on one host in host group of 3 with the same configuration. (OA-43965)
OS module
- Preserve alias services when the original is not listed in systemd unit files. (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
- dtp-dev5-grail The node was low on resource: ephemeral-storage. (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)