This page outlines the basic functionality of the Datadog Agent for Amazon linux.
If you haven’t installed the Agent yet, instructions can be found in the Datadog agent integration page
The service manager provided by the operating system is responsible for the Agent lifecycle: depending on which one is installed,
sudo initctl or
sudo systemctl should be used to
restart the Agent.
Other functionalities are provided by the Agent binary itself, globally available through the command
datadog-agent: it’s the case for example of the
|Agent v5||Agent v6||Notes|
||Start Agent as a service|
||Stop Agent running as a service|
||Restart Agent running as a service|
||Status of Agent service|
||Status page of running Agent|
||Display command usage|
||Run a check|
service is not available on your system, use:
sudo initctl start/stop/restart datadog-agent
sudo systemctl start/stop/restart datadog-agent
The configuration files and folders for for the Agent are located at:
|Agent v5||Agent v6|
Configuration files for integrations:
|Agent v5||Agent v6|
Run the info or status command to see the state of the Agent.
The Agent logs are located in the
For Agent v5 logs are in:
If you’re still having trouble, our support team will be glad to provide further assistance.
The Python interpreter embedded with the Agent is located here:
The agent also comes with pip, install python libraries using:
sudo -u dd-agent -- /opt/datadog-agent/embedded/bin/pip install <package_name>
A script is available to automatically install or upgrade the new Agent. It sets up the repos and installs the package for you; in case of upgrade, the import tool also searches for an existing
datadog.conf from a prior version and converts Agent and checks configurations according to the new file format and filesystem layout.
The Agent 6.x installer can automatically convert your 5.x style agent configuration at upgrade:
DD_UPGRADE=true bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/datadog-agent/master/cmd/agent/install_script.sh)"
Note: the import process won’t automatically move custom checks, this is by design since we cannot guarantee full backwards compatibility out of the box.
To install on a clean box (or have an existing agent 5 install from which you do not wish to import the configuration) provide an api key:
DD_API_KEY=YOUR_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/datadog-agent/master/cmd/agent/install_script.sh)"
Set up Datadog’s Yum repo on your system by creating /etc/yum.repos.d/datadog.repo with the contents:
[datadog] name = Datadog, Inc. baseurl = https://yum.datadoghq.com/stable/6/x86_64/ enabled=1 gpgcheck=1 gpgkey=https://yum.datadoghq.com/DATADOG_RPM_KEY.public
Update your local yum repo and install the Agent:
sudo yum makecache sudo yum install datadog-agent
Copy the example config into place and plug in your API key:
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
Re-start the Agent for Amazon linux 2.0:
sudo systemctl restart datadog-agent.service
Re-start the Agent for Amazon linux 1.0:
sudo initctl start datadog-agent
Set up apt so it can download through https
sudo apt-get update sudo apt-get install apt-transport-https
Remove the Agent 6 repository and Ensure the stable repository is present
sudo rm /etc/yum.repos.d/datadog.repo [ ! -f /etc/apt/sources.list.d/datadog.list ] && echo 'deb https://apt.datadoghq.com/ stable main' | sudo tee /etc/apt/sources.list.d/datadog.list sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 382E94DE
Update apt and downgrade the agent
sudo apt-get update sudo apt-get remove datadog-agent sudo apt-get install datadog-agent
To uninstall the agent run:
$ sudo apt-get --purge remove datadog-agent -y