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

OneAgent release notes version 1.231

Rollout starts January 10, 2022

  • New analytics capabilities for messaging system-related anomalies

    Business transactions depend on the performance of applications. In modern applications built with microservices, decoupled services are common, and events are used to communicate between services, making it important for DevOps teams to have full observability into the performance of messaging systems.

  • Automatic connection of logs and traces accelerates AI-driven cloud analytics

    As digital transformation continues to accelerate and enterprises modernize with the adoption of cloud-native architectures, the number of interconnected components and microservices is exploding. Logs are a critical ingredient in managing and optimizing these application environments. Dynatrace now unifies log monitoring with its patented PurePath technology for distributed tracing and code-level analysis. Logs are now automatically connected to distributed traces for faster analysis and optimization of cloud-native and hybrid applications.

With this release, the oldest supported OneAgent versions are:

Dynatrace ONEDynatrace ONE Premium

1.213

1.207

Dynatrace extension framework upgrade notice

Starting with Dynatrace OneAgent and ActiveGate version 1.231, we are upgrading the Extension Framework (also referred to as the plugins framework) from Python 3.6 to Python 3.8.

  • Consequences: Some Dynatrace extensions running in your environment may stop working and require redeployment of a new version prepared for Python 3.8.
  • Symptoms:
    • No data is provided for affected metrics on dashboards, alerts, and custom device pages populated by the affected extension metrics.
    • Extension logs display errors. Most often this will manifest itself as Python ModuleNotFoundError in the PluginAgent log.
    • Sometimes the Python virtual machine crashes.
  • Impact: This issue affects only those extensions that use native libraries called from Python code distributed with the extension.
Extension-specific advisory
ExtensionWhat to do
  • Citrix Virtual Apps and Desktops
  • IBM DataPower
  • IBM DB2 LUW
  • IBM i
  • IBM MQ
  • Juniper Networks
  • Microsoft SQL Server (MSSQL - remote monitoring)
  • SAP HANA Database
  1. In the Dynatrace menu, go to Hub.
  2. Find and select one of the extensions listed to the left.
  3. On the extension details page, select Download to download the extension ZIP file to your machine. If there are operating system options, be sure to select the correct download for your deployment.
  4. Deploy the extension per the instructions on the corresponding documentation page. (In the list to the left, select the name of the extension.)

For assistance, please contact a Dynatrace ONE product specialist by selecting the chat button in the upper-right corner of the Dynatrace menu bar.

All out-of-the-box built-in extensions

No action required. Extensions distributed with OneAgent will be updated automatically to work with Python 3.8 together with the Python upgrade.

Custom extensions

To learn about upgrading custom Dynatrace extensions from Python 3.6 to Python 3.8, see Upgrade custom Dynatrace extensions from Python 3.6 to Python 3.8.

Java

  • Added support for Log4J2 (Apache) 2.7.x - 2.12.x

z/OS

  • oneagentzos-R12310.pax is now available

Go

  • Added support for Logrus 1.7.1 - 1.8
  • Added support for Zap 1.10 - 1.21

New features and enhancements

Improved oneagentnettracer on Linux

We have corrected the handling of oneagentnettracer capabilities on Linux systems where the kernel version is 5.8+ and the libcap capability supporting library version is earlier than 2.37.

Other support changes

OneAgent for z/OS

Build 1.231.0

  • Improved zDC DTAGTCMD processing for zremoteagent= parameter. zDC will now accept values for zremoteagent= parameter spanning multiple lines with trailing spaces (ONE-66165)
  • Fixed missing Start-Linked path in CICS DPL calls (ONE-66324)
  • The ability of the CICS transaction sensor to trace mirror tasks which was removed in version 1.215 has been restored (ONE-65853)
  • If your environment uses NAT IP Addresses -
    1. Update your zRemote to version 1.231
    2. Rerun COPYAGNT job from 1.231.0 SZDTSAMP library to get the latest dtzagent binary
    3. Start zDC with nobootstrap=false parameter to bootstrap the latest zLocal

Operating systems

  • Added support for Windows Server 2022

Future Dynatrace OneAgent technology support changes

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

Future Dynatrace OneAgent operating systems support changes

The following operating systems will no longer be supported starting 01 July 2022
  • Linux: CentOS 8.x
    • x86-64
    • Vendor announcement
  • Linux: CentOS 8.x
    • PPCLE
    • Vendor announcement
  • Linux: CentOS 8.x
    • ARM64 (AArch64)
    • Vendor announcement
  • Linux: Google Container-Optimized OS 85 LTS
    • x86-64
    • Vendor announcement
  • Linux: openSUSE 15.2
    • x86-64, PPCLE
    • Vendor announcement
  • Windows: Windows Desktop 10 2004
    • x86-64
    • Vendor announcement
  • Windows: Windows Server 2004
    • x86-64
    • Vendor announcement
The following operating systems will no longer be supported starting 01 August 2022
  • Linux: Ubuntu 21.04
    • Vendor announcement
The following operating systems will no longer be supported starting 01 October 2022
  • Linux: SUSE Linux Enterprise Server 11.4
    • Vendor announcement
The following operating systems will no longer be supported starting 01 November 2022
  • Linux: Ubuntu 14.04 LTS
    • Vendor announcement
The following operating systems will no longer be supported starting 01 December 2022
  • Linux: Fedora 34
    • x86-64
    • Vendor announcement
  • Windows: Windows Desktop 10 1909
    • x86-64
    • Vendor announcement
  • Windows: Windows Server 20H2
    • x86-64
    • Vendor announcement
The following operating systems will no longer be supported starting 01 January 2023
  • Linux: Debian 8, 9
    • x86-64
    • Vendor announcement
  • Linux: SUSE Linux Enterprise Server 12.3
    • Vendor announcement

Past Dynatrace OneAgent technology support changes

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
Dynatrace OneAgent 1.217 was the last version to support the following technologies
  • OpenTelemetry 0.19.0 for Go
Dynatrace OneAgent 1.221 was the last version to support the following technologies
  • OpenTelemetry 0.20.0 for Go
  • OpenTelemetry 0.18.x, 1.0.0-rc.0, 1.0.0-rc.3 for Node.js
Dynatrace OneAgent 1.227 was the last version to support the following technologies
  • OpenTelemetry 1.0.0-RC1 for Go
  • OpenTelemetry 1.0.0-RC2 for Go

Past Dynatrace OneAgent operating systems support changes

The following operating systems are no longer supported since 01 October 2021
  • Linux: Google Container-Optimized OS 77 LTS
    • x86-64
    • Vendor announcement
    • Last compatible version: 1.217
  • Linux: SUSE Linux Enterprise Server 12.2
    • Vendor announcement
    • Last compatible version: 1.225
The following operating systems are no longer supported since 01 December 2021
  • Linux: Fedora 32
    • x86-64
    • Vendor announcement
    • Last compatible version: 1.227
  • Windows: Windows Server 1909
    • x86-64
    • Vendor announcement
    • Last compatible version: 1.227
The following operating systems are no longer supported since 01 February 2022
  • Linux: Ubuntu 20.10
    • Vendor announcement
    • Last compatible version: 1.225
The following operating systems are no longer supported since 01 March 2022
  • Linux: Google Container-Optimized OS 81 LTS
    • x86-64
    • Vendor announcement
The following operating systems are no longer supported since 01 April 2022
  • UNIX: IBM AIX 7.2 TL3
    • POWER8, POWER9
    • Vendor announcement
The following operating systems are no longer supported since 01 June 2022
  • Linux: Fedora 33
    • x86-64
    • Vendor announcement

Resolved issues

  • General Availability (Build 1.231.237)
  • Update 245 (Build 1.231.245)
  • Update 255 (Build 1.231.255)
  • Update 284 (Build 1.231.284)
  • Update 288 (Build 1.231.288)

General Availability (Build 1.231.237)

The 1.231 GA release contains 19 resolved issues.

ComponentResolved issues
Infrastructure Monitoring5
Java2
.NET1
PHP2
AI causation engine1
All modules2
General1
OS module4
Go1

Infrastructure Monitoring

  • Extensions SFM status logs timestamps now match status metrics timestamps. (APM-327536)
  • Extension Execution Controller (EEC) no longer detects datasource timeout and fails to restart the process properly after CPU and memory saturation. (APM-330530)
  • To open a StatsD listening port in local StatsD ingest mode (OneAgent), a socket is now opened on `127.0.0.1:18125` (IPv4) if IPv4 is available, or on `[::1]:18125` (IPv6) if IPv4 is disabled. (APM-330474)
  • Corrected CPU usage calculation method on Windows platform; resolves issue with occasional Extension Execution Controller (EEC) restart. (APM-327062)
  • Fixed a problem with manually setting the host group in standalone environments. (APM-338489)

Java

  • Incoming Web Request nodes created with the OneAgent SDK for Java are no longer shown as flawed if there is no HTTP Host header or a full URL provided. (ONE-66636)
  • ClassNotFoundException no longer occurs when log enrichment is enabled for Log4j. (ONE-67851)

.NET

  • Resolved a SecurityException in AspNetCore when monitoring exceptions that generated a `Methods must be security critical or security safe-critical to call native code.` log entry. (ONE-67782)

PHP

  • Resolved issue with OneAgent PHP module that broke headers in outgoing requests. (ONE-68614)
  • OneAgent PHP module no longer crashes when instrumenting method with return value capture. (ONE-67997)

AI causation engine

  • Custom tag information is now encoded in outgoing Dynatrace tags when tracecontext is enabled, resolving possible unstitched PurePaths. (ONE-67493)

All modules

  • The `--graph` and `--data-root` dockerd arguments for collecting Docker container metadata are now handled correctly. (ONE-66941)
  • Crash alert generation no longer leads to disk exhaustion when OneAgent is running in limited privileges mode. (ONE-66720)

General

  • IIS modules are now displayed correctly in web UI when IIS Insights is enabled. (APM-336632)

OS module

  • Child SAP processes are grouped to parent and are no longer visible as separate processes. (APM-337097)
  • Added support for Docker daemon userns-remap runtime option. (APM-340743)
  • Generating OSI ID treats the `set-host-id-source` parameter from the `deployment.conf` file as most important. On Azure and EC2, UUID or instance ID will be used only when `set-host-id-source` is set to `auto`. (APM-335475)
  • Crash reports are now also aged when OneAgent is deactivated. (APM-327184)

Go

  • OneAgent is now injected correctly into statistically linked Go binaries started via `execv()` or `execvp()` calls. (ONE-68208)

Update 245 (Build 1.231.245)

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

Update 255 (Build 1.231.255)

This cumulative update contains 2 resolved issues and all previously released updates for the 1.231 release.

ComponentResolved issues
.NET1
Infrastructure Monitoring1

.NET

  • Resolved issue that caused .NET Software Component Reporting to sometimes lead to a crash if enabled during runtime. (ONE-69476)

Infrastructure Monitoring

  • Fixed memory leak on failed connection to WMI interface on a monitored host. (APM-344990)

Update 284 (Build 1.231.284)

This cumulative update contains 4 resolved issues and all previously released updates for the 1.231 release.

ComponentResolved issues
All modules1
Logging module1
Mainframe2

All modules

  • Automatic core dump is now created correctly for OneAgent components when a hanging component is detected. (ONE-69345)

Logging module

  • Resolved issue causing the OneAgent Log Monitoring module to crash on startup on Windows systems. (APM-349398)

Mainframe

  • Path correlation is no longer broken when CICS paths contain a mixture of EXEC CICS START and SOAP requests. (ONE-68588)
  • Duplicate hosts no longer reported if CTG and CICS execute on an LPAR with Network Address Translation between the host and the zRemote. (ONE-69509)

Update 288 (Build 1.231.288)

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

OneAgent Installer

  • Fixed an issue where auto-update failed due to problems with removal of dynatrace_onepcap.exe on Windows hosts. (APM-354296)