OneAgent release notes version 1.217

Rollout start: Jun 8, 2021

With this release, the oldest supported OneAgent versions are:

Standard Support

Enterprise Success and Support

1.199

1.193

PaaS token during OneAgent installation

Dynatrace tokens are displayed only once upon creation. Dynatrace stores them encrypted and you can't reveal them after creation.

To enhance token security, we modified the OneAgent download dialog. You now have to provide the PaaS token in the dedicated field or create a new token on spot. The token is automatically appended to the provided download and installation commands. For more information, see the OneAgent installation documentation for AIX, Linux, Solaris, or Windows.

Declarative process grouping

Starting with Dynatrace version 1.218, your custom process group definitions are migrated to Declarative process grouping available at Settings > Processes and containers. Starting with OneAgent version 1.217, only changes made to declarative process grouping settings will have an effect from now on. For more information, see Declarative process grouping.

OneAgent for Android: Bintray sunset

Starting with this release, public artifacts for OneAgent for Android instrumentation will be distributed only via the Maven Central repository due to the sunsetting of Bintray.

OneAgent for Android: closing unused connections

On Android, HTTP connections by system default have the keep-alive header set. The connection stays open for additional requests that may occur. Because of an Android bug, however, they also stay open after the server closes the connection.

Starting with this release, OneAgent keeps the connection open only if another request is expected; otherwise, the connection is closed. Removing unused connections in this way frees resources on your ActiveGate firewall.

Java

z/OS

  • oneagentzos-R121700.pax is now available

When upgrading the zDC to version 1.217, a special handling is required to avoid abends in CICS regions that you're monitoring.

  1. Stop the zDC.
  2. Wait for 15 minutes for the CICS module to reset and clean up the control blocks.
  3. Update the zDC to the newer version.
  4. Start the zDC.

Go

Operating systems

Current Dynatrace OneAgent technology support changes

Dynatrace OneAgent 1.217 is the last version to support the following technologies
  • OpenTelemetry 0.19.0 for Go

Current Dynatrace OneAgent operating systems support changes

The following operating systems will no longer be supported starting 01 July 2021
The following operating systems will no longer be supported starting 01 October 2021

Future Dynatrace OneAgent technology support changes

Dynatrace OneAgent 1.221 will be the last version to support the following technologies
  • OpenTelemetry 0.20.0 for Go
  • OpenTelemetry 0.18, 1.0.0-rc.0, 1.0.0-rc.3 for Node.js
Dynatrace OneAgent 1.227 will be the last version to support the following technologies
  • OpenTelemetry 1.0.0-RC1 for Go
  • OpenTelemetry 1.0.0-RC2 for Go

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 technology support changes

Dynatrace OneAgent 1.209 was the last version to support the following technologies
  • OpenTelemetry 0.13.0 for Go
Dynatrace OneAgent 1.213 was the last version to support the following technologies
  • OpenTelemetry 0.16.0, 0.17.0 for Go
Dynatrace OneAgent 1.215 was the last version to support the following technologies
  • OpenTelemetry 0.18.0 for Go

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

Resolved issues in OneAgent for z/OS

Build 1.217.00

  • Fixed z/OS CPU metric calculation to include SRB time from the ASCB(ONE-55982)

–>

Resolved issues

General Availability (Build 1.217.149)

The 1.217 GA release contains 24 resolved issues.

Mainframe

  • Resolved issue in which multiple data connections from a zLocal caused zRemote to crash. (ONE-56835)
  • Resolved zDC-zRemote disconnect when a CICS or IMS region sends invalid data. (ONE-58293)
  • Resolved an issue that caused the GCPU% metric to be reported as zeroes. (ONE-56306)
  • Resolved invalid return code values for OneAgent CICS and IMS code modules. (ONE-59372)

Java

  • Resolved a rare null pointer exception in the Netty HTTP instrumentation. (ONE-58158)

All modules

  • Improved parsing of network interface names that contain spaces and brackets (such as `Intel(R) I350 Gigabit Network Connection #4`). Resolves issue with NIC exclusion. (ONE-58072)
  • Resolved issue in which network I/O information was missing for some Solaris hosts. (ONE-57558)
  • Fixed exclusion ("blocklist") functionalities for AIX kernel extension injection. (ONE-57225)

General

  • Improved detection of the KVM hypervisor on s390(x) hosts. (APM-292932)

OS module

  • Resolved issue in which OneAgent OS module did not properly report some containerd containers. (ONE-59076)
  • Resolved issue with unclosed file descriptors that could cause OneAgent crash. (ONE-59525)
  • Resolved issue in which CPU usage was over 100% for process instance on AIX. (APM-300274)
  • Bind mounts with quota on XFS file system now show the largest available size instead of the last one. (APM-301892)
  • Apache aggregate deployment change events now distinguish between NEW and CHANGED; previously, all aggregate deployment change events were set as CHANGED. (APM-301735)

OpenTracing Java

  • The OneAgent Java for AWS Lambda module can now correctly instrument a RequestStreamHandler. (ONE-59493)
  • The OneAgent Java for z/OS module now reports the IP address that the zDC uses when connecting to the zRemote, instead of looking up the hostname with DNS. (ONE-57641)
  • The OneAgent Java for z/OS module now correctly uses the IP of the CTG Server in the gateway URL of a CTG service, instead of the IP of the CTG Client. (ONE-59145)
  • Resolved conflicting/mismatching IP addresses for LPARs. (ONE-58198)

ActiveGate

  • Extensions controller service is properly registered on Windows OS. (APM-300340)
  • Resolved issue with Windows ActiveGate autoupdater that could cause update process to fail. (APM-296695)

.NET

  • Fixed an issue in which support alerts were triggered unintentionally. (ONE-59475)

Webserver core

  • Resolved an issue in which the OneAgent Apache module calculated the `cputimeSelftime` metric incorrectly. (ONE-57692)
  • Fixed an issue in the OneAgent Envoy module that caused a malformed configuration preventing start up. (ONE-56423)

IIB

  • Fixed the missing assignment of current tagging mode for outgoing links, which led to empty trace tags (tracestate and traceparent), when w3C TraceContext tagging was disabled. (ONE-60161)

Update 156 (Build 1.217.156)

This cumulative update contains 1 resolved issue and all previously released updates for the 1.217 release.

IIB

  • Fixed the missing assignment of current tagging mode for outgoing links, which led to empty trace tags (tracestate and traceparent), when w3C TraceContext tagging was disabled. (ONE-60161)

Update 162 (Build 1.217.162)

This is a cumulative update that contains all previously released updates for the 1.217 release.

Update 187 (Build 1.217.187)

This cumulative update contains 6 resolved issues and all previously released updates for the 1.217 release.

Infrastructure Monitoring

  • Fixed issue with downloading custom extensions on Windows. (ONE-59377)

Mainframe

  • zRemote can only read the user configuration file from the default directory and doesn't take into account a custom directory specified during the installation. (ONE-61047)
  • Extended logging around host groups. (ONE-60871)
  • Resolved issue with host groups. (ONE-60446)

OS module

  • Custom process grouping and declarative process grouping can now coexist. (ONE-62286)
  • Changed prefix comparisons in declarative process grouping from case sensitive to case insensitive. (ONE-61665)

OneAgent for mobile resolved issues

General Availability (Build .217)

The .217 GA release contains 4 resolved issues.

Component
Resolved issues

Mobile

  • iOS Session Replay: Fixes crash due to potential conflicts between the agent and third party libraries. (ONE-57761)
  • OneAgent for iOS: fixed rare crash on multithreaded user opt-in level validation. (ONE-56805)
  • OneAgent for iOS: Fixed SSZipArchive symbol clash in static library. (ONE-58038)

Mobile Session Replay

  • iOS Session Replay: Fixes potential crashes in the app when trying to track a system event. (ONE-58539)

OneAgent for JavaScript resolved issues

General Availability (Build .217)

The .217 GA release contains 6 resolved issues.

JavaScript

  • Fixed an issue that caused angular route xhr actions to stay open indefinitely. (ONE-57042)
  • Added a workaround to a problem caused by Android WebView that would cause an exception "Java object is gone". (ONE-58830)
  • Fixed an issue where xhr actions that trigger a route change would not be properly marked as such. (ONE-58909)
  • Improved performance with angularjs request interceptors. (ONE-57728)
  • Fixed bug where the dtSA session storage value got set with OPT-IN mode enabled, but jsAgent not enabled yet. (ONE-58274)
  • Fixed a bug that broke correlation of actions with CORS requests if multiple request wrappers were active. (ONE-58398)