VOOZH about

URL: https://docs.datadoghq.com/agent/supported_platforms/linux/

⇱ Linux

For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/agent/supported_platforms/linux.md. A documentation index is available at /llms.txt.

Linux

Overview

This page outlines the basic features of the Datadog Agent for Linux environments. See the Supported Platforms documentation for the complete list of supported Linux distributions and versions.

Install the Agent

To install the Agent on Linux, follow the in-app instructions in Fleet Automation, and run the generated script on your hosts.

Configure the Agent

The Datadog Agent configuration file is located in /etc/datadog-agent/datadog.yaml. This YAML file holds the host-wide connection details used to send data to Datadog including:

  • api_key: Your organization’s Datadog API key
  • site: Target Datadog region (for example datadoghq.com, datadoghq.eu, ddog-gov.com, us2.ddog-gov.com)
  • proxy: HTTP/HTTPS proxy endpoints for outbound traffic (see Datadog Agent Proxy Configuration)
  • Default tags, log level, and Datadog configurations

A fully commented reference file, located in /etc/datadog-agent/datadog.yaml.example, lists every available option for comparison or to copy and paste. Alternatively, see the sample config_template.yaml file for all available configuration options.

Integration files

Configuration files for integrations live in /etc/datadog-agent/conf.d/. Each integration has its own sub-directory, <INTEGRATION>.d/, that contains:

  • conf.yaml: The active configuration controlling how the integration gathers metrics and logs
  • conf.yaml.example: A sample illustrating supported keys and defaults

Commands

DescriptionCommand
Start Agent as a servicesudo systemctl start datadog-agent
Stop Agent running as a servicesudo systemctl stop datadog-agent
Restart Agent running as a servicesudo systemctl restart datadog-agent
Status of Agent servicesudo systemctl status datadog-agent
Status page of running Agentsudo datadog-agent status
Send flaresudo datadog-agent flare
Display command usagesudo datadog-agent --help
Run a checksudo -u dd-agent -- datadog-agent check <CHECK_NAME>

Note: For upstart-based systems, such as CentOS/RHEL 6 or SUSE 11, swap systemctl <action> with <action>. For example, when starting an Agent as a service on a SUSE 11 system, use sudo start datadog-agent.

Uninstall the Agent

To uninstall the Agent, run the command for the appropriate Linux environment:

For CentOS, Rocky, AlmaLinux, Amazon Linux, Oracle Linux, and Red Hat

sudo yum remove datadog-agent

For Debian, Ubuntu

sudo apt-get remove datadog-agent -y

For SUSE

sudo zypper remove datadog-agent

The above commands remove the Agent, but do not remove:

  • The datadog.yaml configuration file
  • User-created files in the /etc/datadog-agent configuration folder
  • User-created files in the /opt/datadog-agent folder
  • The dd-agent user
  • Datadog log files

To remove these elements, run this command after removing the Agent:

sudo userdel dd-agent \
&& sudo rm -rf /opt/datadog-agent/ \
&& sudo rm -rf /etc/datadog-agent/ \
&& sudo rm -rf /var/log/datadog/

To uninstall remaining Agent artifacts for Debian and Ubuntu run:

sudo apt-get remove --purge datadog-agent -y

Uninstall Single Step APM Instrumentation

If you installed the Agent with Single Step APM Instrumentation and want to uninstall it, you need to run additional commands to remove APM Instrumentation. Follow the steps for your specific environment.

Troubleshooting

For detailed steps, see Agent Troubleshooting.

Working with the embedded Agent

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.

Further Reading