Archivos de configuración del Agent

Archivo de configuración principal del Agent

El archivo de configuración del Agent v6 utiliza YAML para adaptarse mejor a configuraciones complejas y garantizar la coherencia en el proceso de configuración, ya que los checks también utilizan archivos de configuración YAML. Por este motivo, datadog.yaml (v6) pasa a sustituir a datadog.conf (v5).

PlataformaComando
AIX/etc/datadog-agent/datadog.yaml
Linux/etc/datadog-agent/datadog.yaml
macOS~/.datadog-agent/datadog.yaml
Windows%ProgramData%\Datadog\datadog.yaml
PlataformaComando
Linux/etc/dd-agent/datadog.conf
macOS~/.datadog-agent/datadog.conf
Windows Server 2008, Vista y versiones más recientes%ProgramData%\Datadog\datadog.conf
Windows Server 2003, XP o versiones anteriores\\Documents and Settings\All Users\Application Data\Datadog\datadog.conf

Consulta el archivo config_template.yaml de ejemplo para ver todas las opciones de configuración disponibles.

Directorio de configuración del Agent

En versiones anteriores, el Datadog Agent almacenaba los archivos de configuración en /dd-agent/conf.d/. Con la versión 6.0, estos archivos pasan a guardarse en /etc/datadog-agent/conf.d/<CHECK_NAME>.d/.

PlataformaComando
AIX/etc/datadog-agent/conf.d/
Linux/etc/datadog-agent/conf.d/
CentOS/etc/datadog-agent/conf.d/
Debian/etc/datadog-agent/conf.d/
Fedora/etc/datadog-agent/conf.d/
macOS~/.datadog-agent/conf.d/
RedHat/etc/datadog-agent/conf.d/
Origen/etc/datadog-agent/conf.d/
SUSE/etc/datadog-agent/conf.d/
Ubuntu/etc/datadog-agent/conf.d/
Windows%ProgramData%\Datadog\conf.d

Archivos de configuración de checks para el Agent 6

En el archivo conf.yaml.example, en la carpeta <CHECK_NAME>.d/ correspondiente, encontrarás un ejemplo de todos los archivos de configuración de checks del Agent. Cambia el nombre a conf.yaml para habilitar el check relacionado. Nota: El Agent carga los archivos YAML válidos incluidos en la carpeta: /etc/datadog-agent/conf.d/<CHECK_NAME>.d/. Con este paso, las configuraciones complejas se dividen en varios archivos. Por ejemplo, una configuración para http_check tendría este aspecto:

/etc/datadog-agent/conf.d/http_check.d/
├── backend.yaml
└── frontend.yaml

Los archivos YAML con el sufijo .default son un caso especial. El Agent los carga de forma predeterminada, y sirven para ayudar a determinar el conjunto principal de checks que se habilitan siempre (CPU, memoria, tiempo de actividad…). Es seguro omitirlos porque, de hecho, se omiten si se encuentra otra configuración para un check determinado. Si quieres deshabilitar alguno de los checks predeterminados, basta con eliminar el archivo correspondiente. Para configurar estos checks, se debería utilizar conf.yaml.example como base.

Los archivos de plantilla de Autodiscovery se almacenan en la carpeta de configuración con el archivo auto_conf.yaml. Por ejemplo, en el caso del check de Redis, esta es la configuración en redisdb.d/:

/etc/datadog-agent/conf.d/redisdb.d/
├── auto_conf.yaml
└── conf.yaml.example

Para la recopilación de logs, si hay varios archivos YAML que se dirigen a una misma fuente de logs, el Agent no los acepta para evitar que se envíen duplicados a Datadog. Si se da este caso, el Agent ordena los archivos de manera alfabética y utiliza el primero de la lista.

Para preservar la compatibilidad con versiones anteriores, el Agent sigue aceptando los archivos de configuración en formato /etc/dd-agent/conf.d/<CHECK_NAME>.yaml. Sin embargo, recomendamos encarecidamente utilizar el formato nuevo.

PlataformaComando
Linux/etc/dd-agent/conf.d/
CentOS/etc/dd-agent/conf.d/
Debian/etc/dd-agent/conf.d/
Fedora/etc/dd-agent/conf.d/
macOS~/.datadog-agent/conf.d/
RedHat/etc/dd-agent/conf.d/
Origen/etc/dd-agent/conf.d/
SUSE/etc/dd-agent/conf.d/
Ubuntu/etc/dd-agent/conf.d/
Windows Server 2008, Vista y versiones más recientes%ProgramData%\Datadog\conf.d
Windows Server 2003, XP o versiones anteriores\\Documents and Settings\All Users\Application Data\Datadog\conf.d

Archivo de configuración de JMX

Los checks de JMX del Agent incluyen un archivo metrics.yaml adicional en la carpeta de configuración. Se trata de una lista de beans que el Datadog Agent recopila de forma predeterminada. Así, no tendrás que detallarlos de forma manual cuando configures un check a través de las etiquetas de Docker o las anotaciones de k8s.