Fichier de configuration principal de l’Agent

Les fichiers de configuration des checks de l’Agent et des intégrations sont stockés dans le répertoire conf.d.

Le fichier de configuration de l’Agent v6 utilise le format YAML pour mieux prendre en charge les configurations complexes et offrir une expérience de configuration cohérente (les checks utilisent également des fichiers de configuration YAML). Par conséquent. datadog.conf (v5) n’est plus pris en charge et est remplacé par datadog.yaml (v6).

L’emplacement du répertoire conf.d varie selon le système d’exploitation.

Consultez le fichier d’exemple config_template.yaml pour découvrir toutes les options de configuration disponibles.

Répertoire de configuration de l’Agent

Les versions antérieures de l’Agent Datadog stockaient les fichiers de configuration dans /dd-agent/conf.d/. À partir de la version 6.0, les fichiers de configuration sont stockés dans le répertoire conf.d. L’emplacement du répertoire varie selon le système d’exploitation.

Fichiers de configuration des checks

Pour chaque check de l’Agent, un exemple de configuration se trouve dans le fichier conf.yaml.example du dossier <NOM_CHECK>.d/ correspondant. Renommez ce fichier conf.yaml pour activer le check associé. Remarque : l’Agent charge tous les fichiers YAML valides qui se trouvent dans le dossier /etc/datadog-agent/conf.d/<NOM_CHECK>.d/. Cela permet de décomposer les configurations complexes en plusieurs fichiers. Voici un exemple de configuration de http_check :

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

Les fichiers YAML avec le suffixe .default fonctionnent différemment. Ils sont chargés par défaut par l’Agent et aident à définir l’ensemble des checks de base qui sont toujours activés (processeur, mémoire, disponibilité, etc.). Lorsqu’un check comporte une autre configuration, ces fichiers YAML sont ignorés. Vous n’avez donc pas à vous en soucier. Si vous souhaitez désactiver l’un des checks par défaut, supprimez ce fichier YAML. Pour configurer ces checks, les fichiers conf.yaml.example doivent être utilisés comme point de départ.

Les fichiers de modèle Autodiscovery sont stockés dans le répertoire de configuration avec le fichier auto_conf.yaml. Par exemple, pour le check Redis, la configuration dans redisdb.d/ est la suivante :

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

Pour la collecte de logs, l’Agent n’accepte pas plusieurs fichiers YAML pointant vers la même source de logs, afin d’empêcher l’envoi de logs en double à Datadog. Si plusieurs fichiers YAML pointent vers la même source de logs, l’Agent récupère les fichiers dans l’ordre alphabétique et utilise le premier fichier.

Pour préserver la compatibilité avec les versions précédentes, l’Agent récupère toujours les fichiers de configuration au format /etc/dd-agent/conf.d/<NOM_CHECK>.yaml. Toutefois, la migration vers le nouveau format est fortement conseillée.

Fichier de configuration JMX

Les checks de l’Agent JMX ont un fichier metrics.yaml supplémentaire dans leur répertoire de configuration. Il s’agit d’une liste de tous les beans recueillis par défaut par l’Agent Datadog. De cette manière, vous n’avez pas besoin d’énumérer manuellement tous les beans lorsque vous configurez un check avec les étiquettes Docker ou les annotations Kubernetes.