close

Resumen

Esta página describe las características básicas del Agente de Datadog para entornos de Linux. Consulta la documentación de Plataformas Soportadas para la lista completa de distribuciones y versiones de Linux soportadas.

Instala el Agente

Para instalar el Agente en Linux, sigue las instrucciones en la aplicación en Fleet Automation, y ejecuta el script generado en tus hosts.

Pasos de instalación en la aplicación para el Agente de Datadog en un host de Linux.

Configura el Agente

El archivo de configuración del Agente de Datadog se encuentra en /etc/datadog-agent/datadog.yaml. Este archivo YAML contiene los detalles de conexión a nivel de host utilizados para enviar datos a Datadog, incluyendo:

  • api_key: La clave API de Datadog de tu organización
  • site: Región de Datadog objetivo (por ejemplo datadoghq.com, datadoghq.eu, ddog-gov.com)
  • proxy: Puntos finales de proxy HTTP/HTTPS para tráfico saliente (ver Configuración del Proxy del Agente de Datadog)
  • Etiquetas predeterminadas, nivel de registro y configuraciones de Datadog

Un archivo de referencia completamente comentado, ubicado en /etc/datadog-agent/datadog.yaml.example, lista todas las opciones disponibles para comparación o para copiar y pegar. Alternativamente, consulte el archivo de muestra config_template.yaml para todas las opciones de configuración disponibles.

Archivos de integración

Los archivos de configuración para integraciones se encuentran en /etc/datadog-agent/conf.d/. Cada integración tiene su propio subdirectorio, <INTEGRATION>.d/, que contiene:

  • conf.yaml: La configuración activa que controla cómo la integración recopila métricas y registros
  • conf.yaml.example: Un ejemplo que ilustra las claves y valores predeterminados soportados

Comandos

DescripciónComando
Iniciar el Agente como un serviciosudo systemctl start datadog-agent
Detener el Agente que se ejecuta como un serviciosudo systemctl stop datadog-agent
Reiniciar el Agente que se ejecuta como un serviciosudo systemctl restart datadog-agent
Estado del servicio del Agentesudo systemctl status datadog-agent
Página de estado del Agente en ejecuciónsudo datadog-agent status
Enviar señalsudo datadog-agent flare
Mostrar uso del comandosudo datadog-agent --help
Ejecutar una verificaciónsudo -u dd-agent -- datadog-agent check <CHECK_NAME>

Nota: Para sistemas basados en upstart, como CentOS/RHEL 6 o SUSE 11, intercambie systemctl <action> con <action>. Por ejemplo, al iniciar un Agente como servicio en un SUSE 11 sistema, usa sudo start datadog-agent.

Desinstalar el Agente

Para desinstalar el Agente, ejecuta el comando para el entorno de Linux correspondiente:

Para CentOS, Rocky, AlmaLinux, Amazon Linux, Oracle Linux y Red Hat

sudo yum remove datadog-agent

Para Debian, Ubuntu

sudo apt-get remove datadog-agent -y

Para SUSE

sudo zypper remove datadog-agent

Los comandos anteriores eliminan el Agente, pero no eliminan:

  • El archivo de configuración datadog.yaml
  • Archivos creados por el usuario en la carpeta de configuración /etc/datadog-agent
  • Archivos creados por el usuario en la carpeta /opt/datadog-agent
  • El usuario dd-agent
  • Archivos de registro de Datadog

Para eliminar estos elementos, ejecuta este comando después de eliminar el Agente:

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

Para desinstalar los artefactos restantes del Agente para Debian y Ubuntu, ejecuta:

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

Desinstalar Instrumentación APM de Un Solo Paso

Si instalaste el Agente con Instrumentación APM de Un Solo Paso y deseas desinstalarlo, necesitas ejecutar comandos adicionales para eliminar la Instrumentación APM. Sigue los pasos para tu entorno específico.

Solución de problemas

Para pasos detallados, consulta Solución de Problemas del Agente.

Trabajando con el Agente embebido

El Agente contiene un entorno de Python embebido en /opt/datadog-agent/embedded/. Binarios comunes como python y pip están contenidos dentro de /opt/datadog-agent/embedded/bin/.

Consulte las instrucciones sobre cómo agregar paquetes al Agente embebido para más información.

Lectura adicional