OneAgent release notes version 1.267

Rollout start: Jun 7, 2023

With this release, the oldest supported OneAgent versions are:

Standard Support

Enterprise Success and Support

1.249

1.243

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.

  • Akka HTTP server 10.2, 10.4, 10.5 (Java module)

End of support

For more information, see End of support announcements.

New features and enhancements

Podman containers support

Infrastructure Monitoring | Containers

OneAgent installed on a host running Podman now detects Podman containers and collects container metrics. Note that OneAgent deployment inside a Podman container is not supported.

For successful instrumentation, Podman must be configured to use crun (instead of runc) as its low-level container runtime to ensure the correct functioning of OneAgent with Podman containers. To check the runtime, do one of the following:

  • Inspect the /etc/containers/libpod.conf file.
  • Execute the podman info command and look for the ociRuntime field, which indicates the active runtime (such as crun or runc).

OneAgent metric API supported on AIX

Infrastructure Monitoring | AIX hosts

OneAgent metric API is now supported for OneAgents installed on the AIX hosts.

Application Security

Application Security | Attack and vulnerability detection

Attack and vulnerability detections now support servlet-api-5.0.

Enable secure zLocal-zRemote connection

Apps & Microservices | zRemote

You can configure a secure zLocal-zRemote connection by setting AT-TLS for the zLocal and SSL for the zRemote.

Indication when CICS/IMS distributed traces are truncated

Apps & Microservices | CICS/IMS distributed traces

We now indicate at which node the CICS/IMS traces are truncated. By default, they're truncated at the 500th node.

OneAgent resolved issues

General Availability (Build 1.267.125)

The 1.267 GA release contains 7 resolved issues.

OS module

  • Added support for custom properties for the "service not installed" alert. Placeholders are supported, but since the "service not installed" alert is raised when there is no service matching the rule, any placeholder starting with `dt.osservice` will be changed to "[unknown]". (HOST-2951)
  • Corrected format of host ID stored in `ruxithost.id` file. When the host ID is shorter than 16 characters, it's now padded with leading zeroes instead of spaces. (HOST-2544)

.NET

  • Fixed an issue when requesting request attributes for OWIN .NET web applications. (OA-17160)

AI causation engine

  • Resolved an issue in which an incorrect TopX computation sometimes led to a crash in web server agents such as Apache, NGINX, or IIS if too many unique URLs were processed. (OA-17813)

All modules

  • Resolved an issue that sometimes caused an exception when creating the host display name, resulting in OneAgent termination. (OA-17245)
  • To improve CPU metrics accuracy when processes are inactive for a longer period of time (which could cause spikes in CPU usage when PIDs are incorrectly detected as timed out), the timeout for worker processes in standalone mode has been increased from 5 minutes to 6 hours. This adjustment also improves logging for worker CPU processing, which enables better analysis of related issues. (OA-15939)

Mainframe

  • The zIIP usage metric is no longer always set to 0. (OA-17491)

Update 206 (Build 1.267.206)

This cumulative update contains 10 resolved issues (including 1 vulnerability resolution) and all previously released updates for the 1.267 release.

AI causation engine

  • Resolved an issue in which an incorrect TopX computation sometimes led to a crash in web server agents such as Apache, NGINX, or IIS if too many unique URLs were processed. (OA-17813)

Infrastructure Monitoring

  • Vulnerability: In response to CVE-2023-24329, updated Extensions Execution Controller (EEC) Python runtime to version 3.10.12. (EXT-5378)

OS module

  • Fixed high agent CPU usage on hosts with high network traffic. (HOST-3156)
  • Fixed an issue where disk exclusion rules were applied only to local disks. (HOST-3221)
  • Fixed issue where, from time to time on network shares, there were spikes of usage that showed throughput in PiB/s. (HOST-3218)
  • Excluded administrative and local shares from statistics for network shares. (HOST-3219)
  • Disabled Windows network drive monitoring in response to API hanging in certain scenarios. (HOST-3206)

OneAgent Installer

  • The plugin module binaries and process execution have been restored to the bootstrapped OneAgent container deployment. (DMX-4807)

Java

  • Resolved an issue that, after OneAgent upgrade, caused a NullPointerException in jdk.internal.net.http.HttpClient when lowercase headers for X-dynaTrace were present. (OA-18008)

.NET

  • Improved OneAgent .NET code module stability following the Microsoft security update for .NET framework 3.5. (OA-18223)

OneAgent for Android

General Availability (Build 8.267.1)

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

OneAgent for iOS

General Availability (Build 8.267.1)

The 8.267 GA release contains 2 resolved issues.

OneAgent for iOS

  • Improved timestamp accuracy and resolved an issue that caused an occasional crash on creating global OneAgent timestamps. (RUM-10163)
  • Added xcodebuild installation check to install and uninstall command and fixed a bug that prevented error log creation. (RUM-10327)

OneAgent for JavaScript resolved issues

General Availability (Build 1.267.79)

The 1.267 GA release contains 1 resolved issue.

JavaScript

  • Fixed an issue in the XHR module that, when "Use Proxy API" was enabled, caused XHR callbacks not to be fired in scenarios where the same callback was added to multiple XHR instances via the "addEventListener" function. (RUM-10905)

Update 210 (Build 1.267.210)

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

JavaScript

  • Fixed a bug where if a Request object was used in a fetch call, the agent did not set any correlation headers on it. (RUM-11308)

Handling of src attribute

Added better handling of empty src attributes to prevent the current page from showing up as a failing image.