Agent v7 is available. Upgrade to the newest version to benefit from all new functionality.
The Datadog Agent is software that runs on your hosts. It collects events and metrics from hosts and sends them to Datadog, where you can analyze your monitoring and performance data. The Datadog Agent is open source and its source code is available on GitHub at [https://github.com/DataDog/datadog-agent DataDog/datadog-agent].
It is recommended to fully install the Agent. However, a standalone DogStatsD package is available for Amazon Linux, CentOS, Debian, Fedora, Red Hat, SUSE, and Ubuntu. This package is used in containerized environments where DogStatsD runs as a sidecar or environments running a DogStatsD server without full Agent functionality.
The standalone DogStatsD package is installed with the Agent one-line install command except every occurrence of `datadog-agent` should be replaced with `datadog-dogstatsd`. A Docker image is available in the DogStatsD6 Docker image repo.
Packages are also available for 64-bit x86 and Arm v8 architectures. For other architectures, use the source install.
To get started using the Agent, select your platform.
This page outlines the basic features of the Datadog Agent for Ubuntu.
To install the Agent, see the installation instructions. Packages are available for 64-bit x86 and Arm v8 architectures. For other architectures, use the source install.
Note: Ubuntu 14.04 and above are supported on the 64-bit x86 architecture. Ubuntu 16.04 and above are supported on the 64-bit Arm v8 architecture.
In Agent v6 and v7, the service manager provided by the operating system is responsible for the Agent lifecycle, while other commands must be run through the Agent binary directly. In Agent v5, almost everything is done through the service manager.
| Description | Command |
|---|---|
| Start Agent as a service | `sudo service datadog-agent start` |
| Stop Agent running as a service | `sudo service datadog-agent stop` |
| Restart Agent running as a service | `sudo service datadog-agent restart` |
| Status of Agent service | `sudo service datadog-agent status` |
| Status page of running Agent | `sudo datadog-agent status` |
| Send flare | `sudo datadog-agent flare` |
| Display command usage | `sudo datadog-agent –help` |
| Run a check | `sudo -u dd-agent – datadog-agent check <CHECK_NAME>` |
Note: If the service wrapper is not available on your system, use:
The configuration files and folders for the Agent are located in:
/etc/datadog-agent/datadog.yaml`
Configuration files for Integrations:
/etc/datadog-agent/conf.d/`
To uninstall the Agent, run the following command:
sudo apt-get remove datadog-agent -y
This command removes the Agent, but does not remove:
If you also want to remove these elements, run this command after removing the Agent:
`sudo apt-get remove --purge datadog-agent -y`
If you installed the Agent with Single Step APM Instrumentation, and you want to uninstall the Agent, you need to run additional commands to uninstall APM Instrumentation.
See the [Agent Troubleshooting documentation](https://docs.datadoghq.com/troubleshooting/).
The Agent contains an embedded Python environment at `/opt/datadog-agent/embedded/`. Common binaries such as python and pip are contained within `/opt/datadog-agent/embedded/bin/`.
See the instructions on how to add packages to the embedded Agent for more information.