OneAgent release notes version 1.251

Rollout start: Oct 14, 2022

With this release, the oldest supported OneAgent versions are:

Standard Support

Enterprise Success and Support

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, and sendSignal dtrum methods.
  • In the enterXhrAction dtrum method, the xmode paramter with value of 2 is now deprecated and will fall back to the value of 1.
  • In the enterAction dtrum method, the type parameter is now deprecated and will no longer have any effect.

Java

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 to 51 ms allows you to trace such requests as long as the delay is below this limit.

    Go

      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 January 2025
          The following operating systems will no longer be supported starting 01 April 2025
          The following operating systems will no longer be supported starting 01 May 2025
          The following operating systems will no longer be supported starting 01 June 2025
          The following operating systems will no longer be supported starting 01 July 2025

          Past Dynatrace OneAgent operating systems support changes

          The following operating systems are no longer supported since 01 May 2024
          The following operating systems are no longer supported since 01 July 2024
          The following operating systems are no longer supported since 01 November 2024
          The following operating systems are no longer supported since 01 December 2024

          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.

          Component
          Resolved issues
          1
          1

          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.

          Component
          Resolved issues
          1
          2
          2
          3
          1
          2
          2
          1

          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.

          Component
          Resolved issues
          2 (2 vulnerabilities)
          1

          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.