Deploy OneAgent using AWS Systems Manager Distributor
With the AWS Systems Manager Distributor you can distribute and automatically deploy OneAgent on your EC2 instances using the AWS Systems Manager Distributor.
Prerequisites
Before you start deploying the DynatraceOneAgent
distributor package, make sure your Amazon EC2 instances meet the following prerequisites:
AWS Systems Manager
AWS Systems Manager must be set up for your AWS account and AWS Systems Manager Agent (SSM Agent) must be installed on the EC2 instances where you want to deploy DynatraceOneAgent
distributor package. Follow the AWS Systems Manager Quick Setup or more comprehensive Setting up AWS Systems Manager.
Supported operating systems
The DynatraceOneAgent
distributor package is supported on the following operating systems:
Operating system | Version | Architecture |
---|---|---|
Windows | All OneAgent supported versions | x86-64, |
Amazon Linux | All OneAgent supported versions | x86-64, ARM64 (AArch641) |
Ubuntu | 16.04, 18.04 | x86-64, ARM64 (AArch641) |
Red Hat Enterprise Linux | 8.x | x86-64 |
SUSE Enterprise Linux | 15.x | x86-64, ARM64 (AArch641) |
1 Support for ARM64 architecture, including AWS Graviton processors, is in Early Adopter release.
Wget
Dynatrace OneAgent distributor package requires Wget
installed on your Linux-based instance. If there's no Wget
installed on your instance, the OneAgent distributor package will install it for you automatically. Wget
is necessary to download the latest OneAgent version.
Limitations
Deploying OneAgent using AWS Systems Manager Distributor is currently not supported if you set Dynatrace Managed Cluster as the SSM_DYNATRACE_URL
parameter value.
Installation
To install the DynatraceOneAgent
distributor package
-
Open the AWS Systems Manager console.
-
In the navigation pane, select Distributor.
-
On the Distributor page, select Third party and select the
DynatraceOneAgent
package. -
Select the installation mode. You can install or update the
DynatraceOneAgent
package one time or schedule the installation. For detailed information on installing the Distributor packages, see AWS Systems Manager Distributor documentation. -
Configure the
DynatraceOneAgent
package installation. Add the parameters to the Additional Arguments field of the Systems Manager Run Command.- required Configure the OneAgent communication endpoint, for example your Dynatrace environment using the
SSM_DYNATRACE_URL
parameter. Note that the URL must end with a trailing slash, for examplehttps://environment.live.dynatrace.com/
. - required Configure the PaaS token using the
SSM_DYNATRACE_TOKEN
parameter. - optional Assign the host to a host group using
SSM_DYNATRACE_HOST_GROUP
parameter. - optional Enable infrastructure monitoring mode using
SSM_DYNATRACE_INFRA_ONLY
parameter. - optional Disable Log Monitoring using
SSM_DYNATRACE_APP_LOG_CONTENT_ACCESS
parameter.
Use the following format:
{ "SSM_DYNATRACE_URL" : "https://environment.live.dynatrace.com/", "SSM_DYNATRACE_TOKEN" : "abcdefghij123456", "SSM_DYNATRACE_HOST_GROUP" : "my_host_group", "SSM_DYNATRACE_INFRA_ONLY" : "true", "SSM_DYNATRACE_APP_LOG_CONTENT_ACCESS" : "false" }
- required Configure the OneAgent communication endpoint, for example your Dynatrace environment using the
-
Verify the installation.
- After you run the installation, check the progress in the Command status area. When you see the Success status it means the installation was successful.
- Switch to Dynatrace and select Deployment status from the navigation menu. Search for recently connected EC2 hosts to verify the result of the installation.
Installation parameters
The DynatraceOneAgent
distributor package provides a number of Dynatrace-specific parameters that map directly to the following OneAgent installation parameters. Learn more about customizing OneAgent installation on Linux and Windows.
Distributor parameter | Maps to OneAgent parameter | Default value | description |
---|---|---|---|
SSM_DYNATRACE_URL |
--set-server |
environment specific | The address of the OneAgent communication endpoint, which is a Dynatrace component that OneAgent sends data to. Depending on your deployment, it can be a Dynatrace SaaS cluster or an ActiveGate. Dynatrace Managed Cluster is currently not supported. Note: Make sure you add trailing slash at the end of URL, for example https://environment.live.dynatrace.com/ . |
SSM_DYNATRACE_TOKEN |
N/A | N/A | The PaaS token used to download OneAgent installer. |
SSM_DYNATRACE_HOST_GROUP |
--set-host-group |
unset | The name of a host group you want to assign the host to. |
SSM_DYNATRACE_INFRA_ONLY |
--set-infra-only |
false | Activates Infrastructure Monitoring mode, in place of Full-Stack Monitoring mode. With this approach, you receive infrastructure-only health data, with no application or user performance data. |
SSM_DYNATRACE_APP_LOG_CONTENT_ACCESS |
--set-app-log-content-access |
true | When set to true , allows OneAgent to access log files for the purpose of Log Monitoring. |