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).
Plataforma | Comando |
---|
AIX | /etc/datadog-agent/datadog.yaml |
Linux | /etc/datadog-agent/datadog.yaml |
macOS | ~/.datadog-agent/datadog.yaml |
Windows | %ProgramData%\Datadog\datadog.yaml |
Plataforma | Comando |
---|
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/
.
Plataforma | Comando |
---|
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.
Plataforma | Comando |
---|
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.