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 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.

Note
In contrast to other platforms, root access is not required for the installation of OneAgent on Alpine Linux. OneAgent can be installed in any directory.

  • As all monitored applications need to 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.

Navigate to the installation folder and run . dynatrace-env.sh to set TENANT, TENANTTOKEN and the CONNECTION_POINT for preparing your environment before injecting the agent.

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

Setting the environment globally (for OneAgent v1.135.xxx)

To set the environment globally, update the host profile (/etc/profile). This will require root permissions. Add a call to the script . /opt/dynatrace/oneagent/dynatrace-java-env.sh 64 to your profile, as shown in the example below. Logout and login again. Run the env command to verify that the environment is set correctly.

export CHARSET=UTF-8
export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
export PAGER=less
export PS1='\h:\w\$ '
umask 022

for script in /etc/profile.d/*.sh ; do
        if [ -r $script ] ; then
                . $script
        fi
done

. /opt/dynatrace/oneagent/dynatrace-agent64.sh