OneAgent release notes version 1.251
Rollout start: Oct 14, 2022
With this release, the oldest supported OneAgent versions are:
Announcements
Npcap installed by default starting OneAgent version 1.255
Starting with OneAgent version 1.255, the OneAgent installer on Windows installs the Npcap
driver by default.
This may cause potential network disruption during OneAgent installation on Windows Server 2016, or Windows Server 2019 build 1809 and Windows 10 build 1809 without the KB4571748 hotfix or any of its superseding hotfixes.
If your hosts don't have the KB4571748 hotfix, upgrade them now or use other documented options to prevent potential disruptions.
We're dropping support for certain iOS and Xcode versions
Starting with OneAgent for iOS version 8.257 (spring 2023), Dynatrace will stop supporting iOS 9 and 10, Xcode 13, and bitcode-enabled builds. We'll only support iOS 11+ and Xcode 14+.
Also, following the Apple app submission guidelines, we'll only support apps built with Xcode 14.1+ starting April 2023.
New features and enhancements
RUM JavaScript API
- Removed functionality from
startThirdParty
,stopThirdParty
, andsendSignal
dtrum
methods. - In the
enterXhrAction
dtrum
method, thexmode
paramter with value of2
is now deprecated and will fall back to the value of1
. - In the
enterAction
dtrum
method, thetype
parameter is now deprecated and will no longer have any effect.
Java
- Added support for Akka HTTP client 10.0, 10.2, 10.4, 10.5
- Added support for Apache HttpCore 5
- Added support for Jetty HTTP server 10
- Added support for OpenTelemetry agent 1.17 - 1.22
- Added support for Oracle HotSpot VM 19
- Added support for OpenJDK 19
- Added support for SAP JVM 19
- Added support for Amazon Corretto 19
- Added support for GraalVM 22
- Added support for Azul Platform Core (Zulu) 19
- Added support for Bellsoft Liberica 19
- Added support for Eclipse Temurin (a.k.a. 'Adoptium') 19
Node.js
- Added support for Node.js (AWS Lambda functions) 16
- Certain frameworks use
setTimeout
to delay the actual client requests. Increasing the default internal timeout tracking limit to51 ms
allows you to trace such requests as long as the delay is below this limit.
Go
- Added support for Go (GCP functions)
PHP
Mainframe
oneagentzos-R12510.pax
is now available. See Upgrade and Maintenance for upgrade instructions.- Added support for IBM z/OS Connect EE MQ service provider).
- The CICS code module can now capture the CICS transaction class, Service class, and Reporting service class as defined by the z/OS Workload Manager. These attributes are shown on the CICS distributed traces page if available.
Operating systems
Future Dynatrace OneAgent operating systems support changes
The following operating systems will no longer be supported starting 01 December 2024
- Linux: CentOS Stream 8
- x86-64, PPCLE
- Vendor announcement
- Linux: CentOS Stream 8
- ARM64 (AArch64)
- Vendor announcement
The following operating systems will no longer be supported starting 01 January 2025
- Linux: CentOS 7
- x86-64
- Vendor announcement
- Linux: CentOS 7
- Linux: CentOS 7
- ARM64 (AArch64)
- Vendor announcement
- Linux: Red Hat Enterprise Linux 6, 7
- Linux: Oracle Linux 6, 7
- x86-64
- Linux: EulerOS 2.8
The following operating systems will no longer be supported starting 01 April 2025
- UNIX: IBM AIX VIOS 3.1
- POWER8, POWER9, POWER10
- Vendor announcement
The following operating systems will no longer be supported starting 01 May 2025
- Windows: Windows Desktop 11 21H2
- x86-64
- Vendor announcement
The following operating systems will no longer be supported starting 01 June 2025
- Linux: SUSE Linux Enterprise Server 15.2
The following operating systems will no longer be supported starting 01 July 2025
- Linux: openSUSE 15.5
- x86-64, PPCLE
- Vendor announcement
Past Dynatrace OneAgent operating systems support changes
The following operating systems are no longer supported since 01 May 2024
- Windows: Windows Server 2012, 2012 R2
- x86-64
- Vendor announcement
The following operating systems are no longer supported since 01 July 2024
- Linux: openSUSE 15.4
- x86-64, PPCLE
- Vendor announcement
The following operating systems are no longer supported since 01 August 2024
- Linux: SUSE Linux Enterprise Server 15.1
- Linux: Ubuntu 23.04
The following operating systems are no longer supported since 01 November 2024
- Linux: Ubuntu 14.04 LTS
Other support changes
OneAgent for z/OS
Build 1.251.0
- Added support to report new Host metrics such as total GCPU of the LPAR, total zIIP time of the LPAR and total zIIP usage of the LPAR (OA-696)
- Added support to report new PGI metric, GCPU seconds of region per hour (OA-696)
- Fixed Incorrect/unexpected z/OS Host IP Address shown in the Host view (OA-5230)
- Fixed repeated occurrence of ZDTL001I message in the zRemote log (OA-3485)
- Fixed IMS Fastpath region ABEND SYS DC2 reason 55 duplicate UToken (OA-7667)
Resolved issues
General Availability (Build 1.251.138)
The 1.251 GA release contains 2 resolved issues.
AI causation engine
- Avoids using the kubernetes POD name as servername in case a path has timed out. (OA-8709)
Node.js
- Missing `package.json` file and missing `"type": "commonjs"` entry caused issues in conjunction with ESM: If an outer `package.json` defined `"type": "module"`, Node.js assumed that `onenodeloader` and/or our `nodejsagent` scripts were modules as well, which caused the application to fail. (OA-8441)
Update 220 (Build 1.251.220)
This is a cumulative update that contains all previously released updates for the 1.251 release.
Update 240 (Build 1.251.240)
This cumulative update contains 14 resolved issues and all previously released updates for the 1.251 release.
Go
- Fixed potential memory corruption or crash when runtime/pprof profiling is used. (OA-6632)
AI causation engine
- Avoids using the kubernetes POD name as servername in case a path has timed out. (OA-8709)
- Fixes too early deletion of paths and therefore increase robustness and correctness of created paths. (OA-7907)
All modules
- Corrected potential incorrect handling of special dlsym parameters on AIX and Solaris. (OA-6781)
- Fixed OneAgent startup error if the process user does not have read access to the cgroup fallback folders (`/sys/fs/cgroup`, `/cgroup`) set at startup. The customer process remains intact; only Dynatrace monitoring is down. (OA-9075)
Infrastructure Monitoring
- For metadata ingest through EEC, the metadata display name character limit is now correctly set to 300, and metadata dimension keys are no longer case-sensitive on ingest. (EXT-2749)
- Prometheus data source now strips ending whitespace in the Prometheus endpoint URL configuration. (APM-384257)
- Extension Execution Controller (EEC) logs older than 3 months are deleted. (EXT-2598)
Node.js
- Missing `package.json` file and missing `"type": "commonjs"` entry caused issues in conjunction with ESM: If an outer `package.json` defined `"type": "module"`, Node.js assumed that `onenodeloader` and/or our `nodejsagent` scripts were modules as well, which caused the application to fail. (OA-8441)
OS module
- Solved issue with incorrect reading and parsing of IIS ports from IIS configuration. (HOST-1432)
- Fixed using host ID from mmap even if reading failed. (APM-386763)
Java
- Attack Detection may prevent the startup of Applications running on Java 9 or newer when a SecurityManager is used. (OA-8156)
- Instrumentation of Attack Protection feature could result in ClassFormatError with methods containing unreachable code. (OA-8224)
PHP
- Fixed issue causing curl verbose mode not available. (OA-5733)
Update 264 (Build 1.251.264)
This cumulative update contains 2 vulnerability resolutions and all previously released updates for the 1.251 release.
n/a
- Vulnerability: Vulnerability: Improved input validation for Real User Monitoring (RUM) in OneAgent. (DTSEC-4446)
- Vulnerability: Vulnerability: Improved input validation for Real User Monitoring (RUM) in OneAgent. (DTSEC-4447)
Update 301 (Build 1.251.301)
This cumulative update contains 3 resolved issue (including 2 vulnerability resolutions) and all previously released updates for the 1.251 release.
n/a
- Vulnerability: Vulnerability: Improved input validation for Real User Monitoring (RUM) in OneAgent. (DTSEC-4446)
- Vulnerability: Vulnerability: Improved input validation for Real User Monitoring (RUM) in OneAgent. (DTSEC-4447)
.NET
- Improved OneAgent .NET code module stability following the Microsoft security update for .NET framework 3.5. (OA-18223)
Update 303 (Build 1.251.303)
This is a cumulative update that contains all previously released updates for the 1.251 release.
OneAgent for Android resolved issues
General Availability (Build 8.251.1)
The 8.251 GA release doesn't contain any user-facing resolved issues.
OneAgent for iOS resolved issues
General Availability (Build 8.251.1)
The 8.251 GA release contains 5 resolved issues.
OneAgent for iOS
- Improved configuration syncing to Session Replay module. (RUM-7248)
- Preventing instrumentation of backups from previous runs. (RUM-7241)
- Resolved issue that could prevent Session Replay from starting correctly for a specific scenario. (RUM-6712)
- Resolved a stuck configuration that could lead to missing sessions. (RUM-7452)
- Fixed crash when reporting crashes from hybrid frameworks. (RUM-7244)
OneAgent for JavaScript resolved issues
General Availability (Build 1.251.138)
The 1.251 GA release doesn't contain any user-facing resolved issues.
Update 204 (Build 1.251.204)
This is a cumulative update that contains all previously released updates for the 1.251 release.
Update 305 (Build 1.251.305)
This is a cumulative update that contains all previously released updates for the 1.251 release.