Resumen

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

Instalar 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 servidores.

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

Configurar 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 servidor utilizados para enviar datos a Datadog, incluyendo:

  • api_key: La clave de API de Datadog de tu organización
  • site: Región objetivo de Datadog (por ejemplo datadoghq.com, datadoghq.eu, ddog-gov.com, us2.ddog-gov.com)
  • proxy: Puntos de conexión 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, enumera todas las opciones disponibles para comparación o para copiar y pegar. Alternativamente, consulta 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 los 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 flaresudo 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 un servicio en un sistema SUSE 11, use sudo start datadog-agent.

Desinstalar el Agente

Para desinstalar el Agente, ejecute 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, ejecute 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, ejecute:

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

Desinstalar Instrumentación APM de Un Solo Paso

Si instaló el Agente con Instrumentación APM de Un Solo Paso y desea desinstalarlo, necesita ejecutar comandos adicionales para eliminar la Instrumentación APM. Siga los pasos para su entorno específico.

Solución de Problemas

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

Trabajando con el agente embebido

El Agente contiene un entorno de Python embebido en /opt/datadog-agent/embedded/. Los 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