OneAgent release notes version 1.309

  • Release notes
  • Page has not been published yet

Rollout start: Mar 11, 2025

With this release, the following are the oldest supported OneAgent versions.

Support level
Oldest supported version
1.291
1.285

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
  • Alpine Linux (musl libc) on ARM64 for containers (Java, Node.js, and Python modules)

End of support

For more information, see End-of-support announcements.

New features and enhancements

Feature update Dot 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 Dot 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

lma-k8s-rn

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 Dot Infrastructure Observability | Hosts

Improved Nginx manual runtime instrumentation

  • The environment variable DT_NGINX_FORCE_RUNTIME_INSTRUMENTATION now 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 Dot 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 Dot 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 Dot 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.65)

The 1.309 GA release contains 2 resolved issues.

ComponentResolved issues
Logging module1
OS module1

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)

Update 73 (Build 1.309.73)

This cumulative update contains 20 resolved issues and all previously released updates for the 1.309 release.

ComponentResolved issues
Logging module4
.NET3
General2
Watchdog1
Extensions framework1
Node.js1
OS module6
Python1
Java1

Logging module

  • Fixed issue when OneAgent Log Module kept restarting in some environments with a large number of log files. (OA-41995)
  • 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)
  • 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)
  • 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)

.NET

  • The .NET ADO.NET feature controller now works as intended. (OA-42138)
  • Fixed an issue in the MongoDB sensor that caused an exception to be thrown in the application. (OA-43215)
  • Stabilized OneAgent .NET monitoring for unsupported versions of MassTransit.RabbitMQ. (OA-43687)

General

  • Improved stability of our String tracking code implementing Code-Level Vulnerability detection in Java. (OA-42246)
  • Resolved an issue where some processes might be classified as Tomcat when the `CATALINA_HOME` environment variable was set on the system level. (OA-44433)

Watchdog

  • Fixed "Failed to create named pipe" error during OneAgent restart. (OA-39224)

Extensions framework

  • Added URL encoding in Prometheus data source on `query` endpoint. (DAQ-5523)

Node.js

  • The span names of the OpenTelemetry instrumentation are not altered by OneAgent injection anymore. (OA-41059)

OS module

  • Resolved issue that caused reported total disk space to be lower than available disk space on Windows network shares. (OA-41131)
  • Fixed an issue that caused monitoring loss of some alias OS services on Linux machines with systemd versions 219-245. (OA-44263)
  • Resolved issue causing "Host ungracefully rebooted" problems when OneAgent was installed within 5 minutes of system boot-up. (OA-43315)
  • Fixed a crash that occurred on Windows with Carbon Black installed. It impacted only hosts with no OS Services monitoring or Classic Windows services monitoring configured. (OA-43197)
  • Fixed invalid "restart required" warning for Apache HTTPD + PHP-CLI deployments. (OA-41438)
  • Fixed container detection by containerized OneAgent on hosts with the cgroup v2 API. (OA-43675)

Python

  • Resolved an issue in which, if the “Python concurrent.futures process” feature controller was enabled, passing keyword-arguments to the builtin method `ProcessPoolExecutor.submit()` would cause the user application to crash. (OA-43956)

Java

  • Ensured proper context propagation between Java HTTP 11 client and HTTP servers when OneAgent is used in combination with OpenTelemetry Java agent >= 2.12. (OA-42095)

OneAgent for Android

Breaking change Dot 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 Dot Digital Experience | RUM Mobile

Xcode 15 is no longer supported

With agent version 8.309, Xcode 15 is no longer supported.

Feature update Dot 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)