OneAgent platform and capability support matrix

  • Generally available and fully supported.
  • Beta features: Dynatrace releases a new OneAgent version every month with a roll forward approach. New features are introduced in a Beta phase on an opt-in basis. Beta features are not feature complete but fully supported and production ready. Please provide feedback on answers.dynatrace.com.
  • Early Access Program: These features are in the final stages of development and ready to be used by early adopters. They are not production ready and not officially supported.
  • Future: A feature or technology support that is either on the roadmap, or might be considered on demand.
  • Not planned: A feature or technology support that Dynatrace will not pursue at the moment.
  • n/a: not applicable

Operating systems supported by the OneAgent

The tables below contain information about the supported OneAgent capabilities for the supported operating systems.


OneAgent feature or function Windows Linux x86/x64 Alpine Linux AIX PPC Solaris SPARC Linux PPC-LE (64bit) z/Linux z/OS
Code modules
Java
Microsoft .NET n/a n/a n/a n/a n/a n/a n/a
.NET Core n/a n/a n/a n/a} n/a
Node.js n/a n/a
PHP n/a n/a n/a n/a n/a
GoLang n/a n/a n/a
Apache, IHS n/a
NGINX n/a n/a n/a
Microsoft IIS n/a n/a n/a n/a n/a n/a n/a
OneAgent SDK
OneAgent SDK for C/C++
OneAgent SDK for Java
OneAgent SDK for Node.js n/a n/a
OneAgent SDK for Python n/a n/a
Other modules
OS module n/a
Network module n/a
Log module n/a
Plugin module n/a (JMX )
Other
IBM Integration Bus (IIB) n/a n/a
Varnish cache n/a n/a n/a n/a n/a
CICS, IMS n/a n/a n/a n/a n/a n/a n/a
Features
Auto-update of all modules n/a
Auto-injection of code modules 1 n/a2
Universal injection of code modules 1
Auto-injection for containers n/a
Non-root n/a n/a n/a n/a

1Alpine Linux is supported in containers only see Alpine linux and musl images.
2Global auto injection is not possible for AIX, please use the universal injection as described in the AIX OneAgent installation page.

Enterprise Cloud platforms supported by the OneAgent

The tables below contains information about the supported OneAgent capabilities for the supported Cloud platforms.


OneAgent feature or function CloudFoundry CloudFoundry app only 4 OpenShift5 Openshift app only Kubernetes5 Kubernetes app only
Code modules
Java
Microsoft .NET n/a n/a n/a n/a n/a
.NET Core 3 3
Node.js
PHP
GoLang
Apache, IHS
NGINX
OneAgent SDK for C/C++
Other modules
OS module n/a n/a n/a
Network module n/a n/a n/a
Log module
Plugin module n/a n/a n/a
Features
Auto-update of all modules n/a 5 n/a 5 n/a
Auto-injection of code modules n/a 5 n/a 5 n/a
Universal injection of code modules
Auto-injection for containers n/a n/a n/a
Non-root n/a n/a n/a n/a n/a n/a

3Not supported for Alpine Linux images.
4CloudFoundry app only also applies to SAP Cloud and IBM Cloud
5OneAgent deployment via container (DaemonSet) has some limitations over normal installer


Cloud Application platforms supported by the OneAgent

The tables below contains information about the supported OneAgent capabilities for the supported Cloud application platforms.

OneAgent feature or function AWS Lambda Azure App services Heroku app only
Code modules
Java
Microsoft .NET n/a
.NET Core
Node.js
PHP
GoLang n/a
Microsoft IIS
Features
Universal injection of code modules n/a

Auto injection of code modules

Auto-injection automatically injects the code modules into monitored applications in completely transparent and automatic fashion that requires no configuration or intervention by the user. This way of deep monitoring is supported for Windows and Linux. Among other things it also automatically injects the code modules into Docker containers and CloudFoundry Garden containers. This means that you do not have to change any container images on monitored platforms to gain full insight.

Universal injection of code modules

Universal injection allows Dynatrace to inject code modules into applications in a unified way across several platform, in situations where the auto-injection is not available. This applies to AIX and Solaris as well as to CloudFoundry application only, OpenShift application only, Kubernetes application only and Heroku.

The feature is described in the AIX/Solaris OneAgent installation page. It is also part of the Openshift application only/Kubernetes application only integration.

Outside of these specifically mentioned cases this feature is not to be used directly!

The CloudFoundry buildpack integrations and Dynatrace Heroku buildpack use this transparently under the hood without any need of intervention by the user.

It should be noted that any form of undocumented injection, like older forms of manual injection, are not supported.

Alpine Linux and musl-based images

Dynatrace supports Alpine Linux based containers (musl based containers) on monitored Linux x86/x64 hosts. This includes Openshift, Kubernetes and CloudFoundry installations and all forms of Docker environments. In these environments Dynatrace OneAgent automatically injects the code modules into the applications running inside the container.

Alpine Linux is also supported in Openshift application only and Kubernetes application only integrations as well as when pushing Docker images to Cloud Foundry and Heroku. This happens via the universal injection.

Dynatrace OneAgent does not support direct installation in Alpine based Linux systems.

OneAgent deployment via Docker container (DaemonSet)

Dynatrace supports two approaches for rolling out OneAgent to Docker-based platforms.

  1. Deploying OneAgent via the normal Linux installer
  2. Deploying OneAgent via a Docker container

There are some limitations when rolling out OneAgent via a Docker container (DaemonSet) to monitor OpenShift, Kubernetes and other Docker-based platforms. The limitations include:

  • Auto-update of modules is disabled, please restart the OneAgent container to receive agent updates
  • Auto-injection of code-modules is disabled for native (i.e., non-containerized) processes
  • JMX plugins aren't supported for technologies outside of containers

For a detailed list of limitations please consult the OneAgent deployment via Docker container documentation.