OneAgent Manual Install

OneAgent is responsible for collecting all monitoring data within your monitored environment. A single OneAgent per host is required to collect all relevant monitoring data—even if your hosts are deployed within Docker containers, microservices architectures, or cloud-based infrastructure.

The OneAgent can be automatically installed and rolled out through configuration management tools such as Chef, Puppet, Ansible, Terraform or by just including the download and install into any custom deployment script.

If you are an AWS System Manager user, then you can also automate OneAgent distribution securely, centrally and at scale. Read this blog to learn more.

But to show how easy it is, let’s do a quick Dynatrace OneAgent install directly on one a Linux Host you of your choice.

Let’s Start

1 . If you are not already there, first login into your Dynatrace environment

You can always login to your tenant using the URL https://[your tenant] or by using the SaaS login link on the top right of the Dynatrace home page

2 . From the left side menu on the bottom, choose ‘deploy dynatrace’ link to open the view below. Once on that screen, click the start installation button.


3 . Select the linux button


4 . You will now see the unix commands that we simply copy and run within the EC2 Instance. Note that the installer is configured just to call the API against your Dynatrace environment.


5 . Now you need to connect to the EC2 Instance using SSH.

6 . Now copy the command that will download the Dynatrace Installer OneAgent page and paste back to the Unix session at the command line and run it. Use the command you copied from your Dynatrace environment that starts with:

wget -O Dynatrace-OneAgent-Linux ...

7 . You can run or skip the second command to verify the signature of the installer binary.

8 . Copy the command to install the OneAgent and paste back to the Unix session that starts with:

/bin/sh Dynatrace-OneAgent-Linux ...

You may have to prefix the installation command with sudo as shown below

sudo /bin/sh Dynatrace-OneAgent-Linux ...

When the install is complete you should see a message with the last lines that look something like this:

Dynatrace OneAgent has successfully connected to Dynatrace Cluster Node You are all set. The Dynatrace OneAgent is fully operational.

9 . Back in the Dyntrace Installer OneAgent page, click the ‘show deployment status’ button to review the OneAgent status.

Once the OneAgent is fully in place, the Dynatrace deployment status should now look like this:


The host and processes are now monitored including many metrics like host CPU and metrics for each process discovered. But in order to get ‘deep’ visibility into code execution and transactions, you may need to restart the application. Upon restart, the OneAgent will automatically load into each process. The good news is that it does this without any changes to your code or your startup scripts.

If you see warning as shown in the example blow, that is OK. Just simply restart the application.


Now give it a try on more of your hosts!!