How do I install Dynatrace OneAgent on Alpine Linux (musl libc)?

Dynatrace supports musl libc based Linux (like default Alpine) for Java, Apache HTTP server, NGINX Plus, and Node.js. If your infrastructure is based on these technologies, you can use Dynatrace OneAgent to effectively monitor your hosts, services, and user experience.

If a proxy is required to connect to Dynatrace Server, we recommend that you install Security Gateway and have Dynatrace OneAgent use Security Gateway for this purpose.

Install Dynatrace OneAgent

Select Deploy Dynatrace from the navigation menu.

Click the Linux button.

Choose x86/64 (Alpine) from the installer type list box.

Click Copy to copy the wget command.

Log into your Alpine host and execute the command.

Create a folder on your local system for Dynatrace OneAgent (for example, /opt/dynatrace/oneagent).

Unzip the ZIP archive into the folder.

In contrast to other platforms, root access isn't required for installation of OneAgent on Alpine Linux. OneAgent can be installed in any directory.

  • As all monitored applications must be able to read the library, ensure that the permissions allow this.
  • Be sure to reference the folder correctly in the subsequent steps of your deployment.

In preparation for injecting OneAgent, navigate to the installation folder and run . to set TENANT, TENANTTOKEN, and the CONNECTION_POINT.

Set the following environment variable to automatically monitor the supported technologies:
export LD_PRELOAD=/opt/dynatrace/oneagent/agent/lib64/

Instrument your application

Depending on your application's technology, follow the relevant steps described below to instrument your application on Alpine Linux (musl libc).