Basic Agent Usage for Linux

Documentos > Agent > Uso básico del Agent > Basic Agent Usage for Linux

Esta página aún no está disponible en español. Estamos trabajando en su traducción.
Si tienes alguna pregunta o comentario sobre nuestro actual proyecto de traducción, no dudes en ponerte en contacto con nosotros.

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.

In-app installation steps for the Datadog Agent on a Linux host.

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)
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

Description	Command
Start Agent as a service	`sudo systemctl start datadog-agent`
Stop Agent running as a service	`sudo systemctl stop datadog-agent`
Restart Agent running as a service	`sudo systemctl restart datadog-agent`
Status of Agent service	`sudo systemctl status datadog-agent`
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: 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.