OneAgent release notes version 1.283
Rollout start: Jan 30, 2024
With this release, the following are the oldest supported OneAgent versions.
Support level | Oldest version supported |
---|---|
Standard Support | 1.265 |
Enterprise Success and Support | 1.259 |
For details, see How long are versions supported following rollout?.
Breaking changes
Ingest of container logs via OneAgent
Breaking change Infrastructure Observability | Log Monitoring
Logs collected via OneAgent from Kubernetes container orchestration systems and non-orchestrated Docker environments are now reported with log.source
set to Container Output instead of a path to the physical file they were ingested from.
This change allows for better aggregation of log sources displayed on various unified analysis pages and thus more intuitive navigation from them into Logs and events / Log explorer pages for more detailed analysis.
However, log ingest rules for Kubernetes and Docker logs are typically based on specific container-related attributes such as Kubernetes namespace or Container name.
Update: Using the log.source
matcher to control containerized application logs' ingestion is now deprecated.
- Such configurations are still temporarily valid but will require migration to using Kubernetes-related attributes instead of the
log.source
attribute in the near future. - A similar migration to account for changes in the
log.source
attribute for containers is required in log processing rules, but also in log metrics and log events configurations.
Removed default values of dt_security_context
Breaking change Infrastructure Observability | Hosts
The permission field dt.security_context
in the dt_host_metadata
file is reserved for user-defined values only. It no longer has a default value if no values are explicitly specified by the user.
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.
MongoDB 1.3 - 1.13 (Go module). OneAgent feature: Go MongoDB
z/OS 3.1 (zDC module)
End of support
For more information, see End of support announcements.
- Node.js 19 (Node.js module)
Vendor end of support: 2023-06-01
New features and enhancements
Excluded Microsoft KM-TEST Loopback Adapter from detected NICs
Infrastructure Observability | Hosts
The Microsoft KM-TEST Loopback Adapter is excluded from detection and not reported to Dynatrace.
Resolved issues
General Availability (Build 1.283.132)
The 1.283 GA release contains 16 resolved issues (including 1 vulnerability resolution).
Component | Resolved issues |
---|---|
General | 5 (1 vulnerability) |
Mainframe | 1 |
Java | 2 |
OS module | 1 |
OpenTracing module | 1 |
PHP | 1 |
Go | 1 |
OneAgent Installer | 1 |
Apache | 1 |
NGINX | 2 |
General
- Vulnerability: Updated the zlib library in response to CVE-2023-45853. (OA-24092)
- Fixed an incompatibility with the musl-libc `gcompat` library that could lead to a crash of any applications (no matter if linked against musl or glibc) that were executed on musl-libc with its `gcompat` wrapper library when OneAgent was loaded. (OA-26645)
- Improved musl libc version detection. (OA-25562)
- Corrected behavior in corner cases for configured async methods as a .NET messaging service. (OA-26098)
- Fixed (removed) overly verbose log entries for PHP that had resulted in a high number of WorkProxy-related entries that could not be turned off. (OA-26856)
Mainframe
- Fixed a SQL Fetch (CLI0125E) Function sequence error. (OA-26727)
Java
- Dynatrace data enriched in unstructured Logback logs is now enclosed with `[!dt ]` bracketing. (OA-25931)
- Fixed a memory leak that occurred when Grail metrics were disabled. (OA-26888)
OS module
- Eliminated false positive alerts on uninstalled OS services. (HOST-4711)
OpenTracing module
- Added support for Envoy 1.29.x. (OA-26499)
PHP
- WordPress: Added missing support for PHP WordPress admin page and fixed instrumentation for multisite configuration. (OA-24339)
Go
- Fixed potentially missing cleanup in the Go HTTP Business Events sensor. (OA-25608)
OneAgent Installer
- Modified SELinux policies to allow `ioctl` syscall to access Dynatrace enrichment metadata files. (DMX-6756)
Apache
- It's now possible to activate Apache log enrichment during runtime. (Go to "Settings" > "Preferences" > "OneAgent features" and turn on "Apache - Trace/span context enrichment for logs [Opt-In]"). (OA-25057)
NGINX
- Fixed an issue in the OneAgent NGINX code module that incorrectly handled caching-relevant HTTP headers (Last-Modified, Etag) that caused HTTP content validation for content served by NGINX itself (for example, static content) not to work. NGINX always responded with the full content with HTTP "200 OK" instead of "304 Not Modified" on subsequent requests. This only happened with RUM enabled. (OA-23389)
- Fixed an issue in the OneAgent NGINX code module that caused more than one Cookie header on upstream HTTP requests. Multiple Cookie values are now correctly merged into a single Cookie header for NGINX versions 1.23+. (OA-23848)
Update 139 (Build 1.283.139)
This cumulative update contains 2 resolved issues and all previously released updates for the 1.283 release.
General
- To limit the impact of breaking change "Ingest of container logs via OneAgent": Using the `log.source` matcher to control containerized application logs' ingestion is now deprecated. Such configurations are still temporarily valid, but will require migration to using Kubernetes-related attributes instead of the `log.source` attribute in the near future. A similar migration to account for changes in the `log.source` attribute for containers is required in log processing rules. (LOG-6337)
- Fixed an issue in the WCF v2 feature that resulted in duplicate service calls for the same request. (OA-26731)
Update 154 (Build 1.283.154)
This cumulative update contains 2 resolved issues and all previously released updates for the 1.283 release.
OS module
- Fixed an issue that caused extensions to not run on Azure servers. (HOST-5182)
Java
- Fixed an issue that sometimes caused a OneAgent crash if an application threw a `StackOverflowError` during startup. (OA-27310)
OneAgent for Android
OneAgent for Android updates
Digital Experience | RUM Mobile
- A new variant of the
stopWebRequestTiming
API method was added to the OneAgent SDK for Android. Use the newstopWebRequestTiming(URI requestUri, int respCode, String respPhrase, long requestSize, long responseSize)
API method to additionally pass the request and response sizes when reporting a web request. This additionally specified information will be then shown in the Dynatrace web UI on the following pages.- On the web requests details page (accessible via the Top providers section)—only request size is shown
- On the User action analysis page for web requests attached to user actions—both request and response sizes are shown
OneAgent for iOS
Button and Menu initializers
Digital Experience | RUM Mobile
Added instrumentation for the iOS 17 Button and Menu initializers.
Resolved issues
General Availability (Build 8.283.1)
The 8.283 GA release contains 2 resolved issues.
OneAgent for iOS
- SwiftUI instrumentor: constant binding variables are now instrumented correctly. (RUM-17172)
- SwiftUI instrumentor: control names with implicit constant references now resolve correctly. (RUM-17176)
OneAgent for JavaScript resolved issues
General Availability (Build 1.283.3)
The 1.283 GA release contains 1 resolved issue.
JavaScript
- Fixed an issue where the XHR module instantiated progress events as `Event` instead of `ProgressEvent`, which made `instanceof` checks fail. This was especially an issue with the XHR wrapper Flutter uses. (RUM-17230)