OneAgent release notes version 1.309

Pre-release information

This is an ongoing summary of changes in this planned release. Check back here at GA for the final version.

Rollout start: Mar 11, 2025 (planned)

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.

End of support

For more information, see End of support announcements.

New features and enhancements

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.59)

The 1.309 GA release contains 11 resolved issues.

Component
Resolved issues
3
1
2
3
1
1

.NET

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

Extensions framework

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

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)

OS module

  • 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 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)