Configuration de l'Agent sans serveur

Présentation

Le principal fichier de configuration de l’Agent s’intitule datadog.yaml. Pour l’Agent sans serveur, les options de ce fichier sont passées via des variables d’environnement. Le nom de ces variables correspond généralement à celui de l’option de configuration correspondante, avec un format snake case en majuscules. Par exemple, utilisez la variable d’environnement DD_API_KEY pour définir votre clé d’API Datadog.

Configuration de base

Variable d’environnementDescription
DD_API_KEYLa variable d’environnement définissant votre clé d’API Datadog en texte brut. Une variable d’environnement est requise pour la clé. Voir les variables d’environnement de la CLI sans serveur.
DD_KMS_API_KEYLa variable d’environnement définissant votre clé d’API Datadog avec KMS. Une variable d’environnement est requise pour la clé. Voir les variables d’environnement de la CLI sans serveur.
DD_API_KEY_SECRET_ARNLa variable d’environnement définissant votre clé d’API Datadog avec un gestionnaire de secrets. Une variable d’environnement est requise pour la clé. Voir les variables d’environnement de la CLI sans serveur.
DD_LOG_LEVELDéfinit le niveau du log de l’Agent Datadog.
DD_SERVERLESS_FLUSH_STRATEGYLa stratégie de nettoyage de l’Agent Datadog. Valeurs autorisées : end ou periodically[,millisecondes]. Par exemple, la variable d’environnement DD_SERVERLESS_FLUSH_STRATEGY=periodically,100 définit un nettoyage toutes les 100 ms.
DD_ENVDéfinit le tag env global pour toutes les données émises.
DD_TAGSTags de host séparés par des espaces. Exemple : simple-tag-0 tag-key-1:tag-value-1.
DD_SITELe site auquel vous transmettez vos métriques, traces et logs. Définissez votre site Datadog sur . Valeur par défaut : datadoghq.com.
DD_DD_URLParamètre facultatif pour remplacer l’URL utilisée pour l’envoi de métriques.
DD_URLAlias de DD_DD_URL. Ignoré si la valeur DD_DD_URL est déjà définie.
DD_TRACE_ENABLEDActive la collecte de traces. Valeur par défaut : true. Pour en savoir plus sur les variables d’environnement permettant de recueillir des traces.
DD_TAGSListe des tags. Ces derniers sont ajoutés dans l’application à chaque métrique, événement, log, trace et check de service émis par cet Agent.
DD_TAG_VALUE_SPLIT_SEPARATORSépare les valeurs de tag en fonction d’un séparateur précis. S’applique uniquement aux tags de host, ainsi qu’aux tags provenant des intégrations de conteneur. Cette variable d’environnement n’a aucune incidence sur les tags appliqués aux métriques DogStatsD, ni aux tags recueillis par d’autres intégrations.

Configuration de la collecte de logs

Variable d’environnementDescription
DD_LOGS_ENABLEDDéfinissez ce paramètre sur true pour activer la collecte de logs avec l’Agent Datadog.
DD_LOGS_CONFIG_LOGS_DD_URLDéfinit l’endpoint et le port à utiliser lorsque les logs passent par un proxy. Puisque les logs sont transmis via TCP, le proxy doit être capable de gérer les connexions TCP. La chaîne doit respecter le format <ENDPOINT>:<PORT>.
DD_LOGS_CONFIG_LOGS_NO_SSLDésactive le chiffrement SSL. Utilisez uniquement ce paramètre lorsque des logs sont transmis localement à un proxy. Il est alors fortement recommandé de gérer le chiffrement SSL côté serveur.
DD_LOGS_CONFIG_PROCESSING_RULESRègles globales de traitement qui sont appliquées à l’ensemble des logs. Les règles exclude_at_match, include_at_match et mask_sequences sont disponibles. Pour en savoir plus, consultez la section Règles globales de traitement.
DD_LOGS_CONFIG_FORCE_USE_HTTPPar défaut, l’Agent envoie des logs au sein de lots HTTPS vers le port 443, tant qu’une connectivité HTTPS peut être établie au lancement de l’Agent. Le cas contraire, l’Agent rebascule vers un envoi TCP. Définissez ce paramètre sur true pour toujours envoyer vos logs via HTTPS (recommandé).
DD_LOGS_FORCE_USE_TCPPar défaut, les logs sont envoyés via HTTPS dès que possible. Définissez ce paramètre sur true pour toujours les envoyer via TCP. Si DD_LOGS_CONFIG_FORCE_USE_HTTP est défini sur true, ce paramètre est ignoré.
DD_LOGS_CONFIG_USE_COMPRESSIONCe paramètre s’applique à l’envoi de logs via HTTPS. Lorsqu’il est défini sur true, l’Agent compresse les logs avant de les envoyer.
DD_LOGS_CONFIG_COMPRESSION_LEVELCe paramètre accepte les valeurs comprises entre 0 (aucune compression) et 9 (compression maximale, mais utilisation plus intensive des ressources). Il s’applique uniquement lorsque le paramètre DD_LOGS_CONFIG_USE_COMPRESSION est défini sur true.
DD_LOGS_CONFIG_BATCH_WAITLa durée maximale, en secondes, pendant laquelle l’Agent Datadog attend que les lots de logs se remplissent avant de les envoyer. Valeur par défaut : 5.
DD_LOGS_CONFIG_OPEN_FILES_LIMITLe nombre maximum de fichiers pouvant être suivis simultanément. Valeur par défaut : 500.
DD_LOGS_CONFIG_FILE_WILDCARD_SELECTION_MODELa stratégie définissant les correspondances de wildcard à utiliser en priorité si le nombre de fichiers dépasse la limite. Valeurs autorisées : by_name et by_modification_time.
DD_LOGS_CONFIG_LAMBDA_LOGS_TYPELa source des logs à exporter. La valeur doit correspondre à une liste d’éléments function, platform et extension séparés par des espaces. Valeur par défaut : tous les logs.

Configuration APM

Variable d’environnementDescription
DD_APM_ENABLEDDéfinissez ce paramètre sur true pour activer l’Agent APM. Valeur par défaut : true.
DD_APM_ENVLe tag d’environnement appliqué aux traces. Si cette variable n’est pas définie, la valeur est obtenue à partir de DD_ENV. Si DD_ENV n’est pas défini, la valeur est obtenue à partir du tag env: défini dans DD_TAGS.
DD_APM_RECEIVER_PORTLe port sur lequel le récepteur de traces effectue son écoute. Définissez ce paramètre sur 0 pour désactiver le récepteur HTTP. Valeur par défaut : 8126.
DD_APM_RECEIVER_SOCKETAccepte les traces via des sockets de domaine Unix. Ce paramètre est désactivé par défaut. Lorsqu’il est défini, il doit pointer vers un fichier de socket valide.
DD_APM_DD_URLDéfinit l’endpoint et le port à utiliser lorsque les traces APM passent par un proxy. La chaîne doit respecter le format <ENDPOINT>:<PORT>. Puisque les traces sont transmises via TCP, le proxy doit être capable de gérer les connexions TCP.
DD_APM_REPLACE_TAGSDéfinit un ensemble de règles permettant de remplacer ou de supprimer certains tags qui contiennent des informations potentiellement sensibles.
DD_APM_IGNORE_RESOURCESUne liste d’exclusion d’expressions régulières. Chaque trace dont le nom d’une ressource correspond à l’une des expressions est ignorée. Utilisez une liste d’expressions séparées par des virgules et ajoutez des guillemets autour de cette liste. Exemple : "^foo$", "bar$".
DD_APM_LOG_THROTTLINGDéfinissez ce paramètre sur true pour limiter à 10 le nombre total d’avertissements et d’erreurs pour chaque intervalle de 10 secondes. Valeur par défaut : true.

Configuration réseau avancée

Variable d’environnementDescription
DD_SKIP_SSL_VALIDATIONDéfinissez cette option sur true pour que l’Agent ignore la validation des certificats SSL/TLS. Valeur par défaut : false.
DD_MIN_TLS_VERSIONCette option définit la version minimale de TSL pour l’envoi de données à l’admission Datadog spécifiée dans DD_SITE ou DD_URL. Valeurs autorisées : tlsv1.0, tlsv1.1, tlsv1.2 ou tlsv1.3. Les valeurs ne sont pas sensibles à la casse. Valeur par défaut : tlsv1.2.

Paramètres de proxy

Variable d’environnementDescription
DD_PROXY_HTTPURL HTTP à utiliser comme proxy pour les requêtes http.
DD_PROXY_HTTPSURL HTTPS à utiliser comme proxy pour les requêtes https.
DD_PROXY_NO_PROXYListe d’URL, séparées par des espaces, pour lesquelles aucun proxy ne doit être utilisé.

Pour en savoir plus sur les paramètres de proxy, consultez la documentation relative au proxy de l’Agent v6.

DogStatsD (métriques custom)

Envoyez des métriques custom avec le protocole StatsD :

Variable d’environnementDescription
DD_DOGSTATSD_NON_LOCAL_TRAFFICEffectue une écoute des paquets DogStatsD issus d’autres conteneurs (requis pour envoyer des métriques custom).
DD_DOGSTATSD_SOCKETLe chemin vers le socket Unix à écouter. Doit être dans le volume rw monté.
DD_DOGSTATSD_ORIGIN_DETECTIONActive la détection de conteneurs et le tagging pour les métriques de socket Unix.
DD_DOGSTATSD_TAGSUne liste de tags supplémentaires séparés par des espaces à ajouter à l’ensemble des métriques, événements et checks de services reçus par ce serveur DogStatsD. Exemple : "env:golden group:retrievers".
DD_USE_DOGSTATSDActive ou désactive l’envoi de métriques custom à partir de la bibliothèque DogStatsD.
DD_DOGSTATSD_PORTRemplace le port DogStatsD de l’Agent.
DD_BIND_HOSTLe host sur lequel DogStatsD et les traces basent leur écoute. Ce paramètre est ignoré par APM lorsque apm_config.apm_non_local_traffic est activé, et ignoré par DogStatsD lorsque dogstatsd_non_local_traffic est activé. L’Agent de trace envoie des métriques à ce host.
Remarque : la valeur par défaut localhost n’est pas valable dans les environnements IPv6 pour lesquels DogStatsD effectue son écoute sur ::1. Pour y remédier, définissez cette valeur sur 127.0.0.1.
DD_DOGSTATSD_ORIGIN_DETECTION_CLIENTLorsque ce paramètre est défini sur true, l’Agent utilise un ID de conteneur fourni par le client pour enrichir les métriques, événements et checks de service en leur ajoutant des tags de conteneur.
Remarque : pour bénéficier de cette fonctionnalité, vous devez utiliser un client compatible avec la version 1.2 du protocole DogStatsD.
DD_DOGSTATSD_BUFFER_SIZELa taille du buffer, en octets, servant à recevoir les paquets StatsD.
DD_DOGSTATSD_STATS_ENABLEPublie les statistiques internes de DogStatsD sous forme d’expvar Go.
DD_DOGSTATSD_QUEUE_SIZEConfigure la taille de la file d’attente interne du serveur DogStatsD. Toute réduction de la taille de cette file d’attente réduit la consommation en mémoire maximale du serveur DogStatsD, mais augmente également le nombre de paquets ignorés.
DD_DOGSTATSD_STATS_BUFFERDéfinit le nombre d’éléments figurant dans le buffer circulaire de statistiques DogStatsD.
DD_DOGSTATSD_STATS_PORTLe port du serveur expvar Go.
DD_DOGSTATSD_SO_RCVBUFSystèmes POSIX uniquement : définit le nombre d’octets alloués au buffer de réception de socket DogStatsD. Par défaut, le système d’exploitation définit cette valeur. Cette variable vous permet d’augmenter la taille du buffer, sans avoir à modifier la valeur par défaut du système d’exploitation. La valeur maximale acceptée dépend du système d’exploitation.
DD_DOGSTATSD_METRICS_STATS_ENABLELorsque ce paramètre est défini sur true, DogStatsD recueille des statistiques de base (nombre et date de dernière détection) à propos des métriques traitées. Exécutez la commande de l’Agent dogstatsd-stats pour consulter ces statistiques.
DD_DOGSTATSD_NO_AGGREGATION_PIPELINEActive le pipeline sans agrégation dans DogStatsD. Ce pipeline reçoit des métriques avec un timestamp et les transmis à l’admission sans aucun traitement supplémentaire (à part le tagging).
DD_DOGSTATSD_NO_AGGREGATION_PIPELINE_BATCH_SIZELe nombre maximal de métriques dans les charges utiles envoyées par le pipeline sans agrégation à l’admission.
DD_STATSD_FORWARD_HOSTTransmet chaque paquet reçu par le serveur DogStatsD et envoyé par un autre serveur StatsD. Vérifiez que les paquets transmis constituent bien des paquets StatsD standard, et non des paquets DogStatsD : en effet, il est possible que l’autre serveur StatsD ne gère par ce type de paquet.
DD_STATSD_FORWARD_PORTLe port auquel transmettre les paquets StatsD.
DD_STATSD_METRIC_NAMESPACEDéfinit un espace de nommage pour toutes les métriques StatsD provenant de ce host. Un préfixe correspondant à l’espace de nommage est ajouté au nom de chaque métrique reçue, avant son envoi à Datadog.