• Home
  • What's new
  • Release notes
  • OneAgent
  • OneAgent release notes version 1.251

OneAgent release notes version 1.251

Rollout starts Oct 14, 2022.

With this release, the oldest supported OneAgent versions are:

Standard SupportEnterprise Success and Support

1.233

1.227

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

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

    Go

      • Added support for Go (GCP functions)

      PHP

      • Added support for OpenTelemetry 0.0.12
      • Added support for OpenTelemetry 0.0.13
      • Added support for OpenTelemetry 0.0.14
      • Added support for OpenTelemetry 0.0.15

      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 October 2023
        • Linux: Google Container-Optimized OS 89 LTS
          • x86-64
          • Vendor announcement
        The following operating systems will no longer be supported starting 01 November 2023
        • UNIX: IBM AIX 7.1 TL5
          • POWER8, POWER9
          • Vendor announcement
        The following operating systems will no longer be supported starting 01 December 2023
        • Windows: Windows Desktop 10 20H2
          • x86-64
          • Vendor announcement
        The following operating systems will no longer be supported starting 01 January 2024
        • Linux: Amazon Linux AMI 2014.03 - 2018.03
          • Vendor announcement
        • Linux: SUSE Linux Enterprise Server 12.4
          • Vendor announcement
        • Linux: EulerOS 2.5
          • Vendor announcement
        The following operating systems will no longer be supported starting 01 May 2024
        • Windows: Windows Server 2012, 2012 R2
          • x86-64
          • Vendor announcement

        Past Dynatrace OneAgent technology support changes

        Dynatrace OneAgent 1.239 was the last version to support the following technologies
        • OpenTelemetry 0.0.2 for PHP

        Past Dynatrace OneAgent operating systems support changes

        The following operating systems are no longer supported since 01 January 2023
        • Linux: Debian 8, 9
          • x86-64
          • Vendor announcement
        • Linux: SUSE Linux Enterprise Server 12.3
          • Vendor announcement
        The following operating systems are no longer supported since 01 February 2023
        • Linux: Ubuntu 21.10
          • Vendor announcement
        The following operating systems are no longer supported since 01 March 2023
        • Linux: Google Container-Optimized OS 85 LTS
          • x86-64
          • Vendor announcement
        The following operating systems are no longer supported since 01 April 2023
        • Linux: EulerOS 2.3
          • Vendor announcement
        The following operating systems are no longer supported since 01 June 2023
        • Linux: SUSE Linux Enterprise Server 15.0
          • Vendor announcement
        • UNIX: IBM AIX 7.2 TL4
          • POWER8, POWER9
          • Vendor announcement
        • Windows: Windows Desktop 10 21H1
          • x86-64
          • Vendor announcement
        The following operating systems are no longer supported since 01 August 2023
        • UNIX: IBM AIX 6.1 TL9
          • POWER8, POWER9
          • Vendor announcement

        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)
        • Update 220 (Build 1.251.220)
        • Update 240 (Build 1.251.240)
        • Update 264 (Build 1.251.264)
        • Update 301 (Build 1.251.301)
        • Update 303 (Build 1.251.303)

        General Availability (Build 1.251.138)

        The 1.251 GA release contains 2 resolved issues.

        ComponentResolved issues
        AI causation engine1
        Node.js1

        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.

        ComponentResolved issues
        Go1
        AI causation engine2
        All modules2
        Infrastructure Monitoring3
        Node.js1
        OS module2
        Java2
        PHP1

        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.

        ComponentResolved issues
        n/a2 (2 vulnerabilities)
        .NET1

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

        General Availability (Build 1.251.1)

        The 1.251 GA release doesn't contain any user-facing resolved issues.

        OneAgent for iOS resolved issues

        • General Availability (Build 1.251.1)

        General Availability (Build 1.251.1)

        The 1.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)
        • Update 204 (Build 1.251.204)

        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.