Configuration des emplacements privés
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

Configuration des emplacements privés

Présentation

Les emplacements privés Synthetics proposent un certain nombre d’options configurables en fonction des exigences de votre environnement. Pour énumérer ces options, exécutez la commande help ci-dessous :

docker run --rm datadog/synthetics-private-location-worker --help

Les options de configuration des emplacements privés peuvent ensuite être passées en tant que paramètres à votre fichier de configuration JSON ou en tant qu’arguments dans la commande de lancement, comme suit :

docker run --rm -v $PWD/<NOM_FICHIER_CONFIGURATION_WORKER>.json:/etc/datadog/synthetics-check-runner.json datadog/synthetics-private-location-worker:latest --logFormat=json

Remarque : les arguments définis dans la commande de lancement sont prioritaires sur le fichier de configuration. Cependant, ces options ne sont pas enregistrées et sont donc prioritaires uniquement pour un lancement donné.

Options de configuration

Configuration du site Datadog

OptionTypeValeur par défautDescription
siteChaînedatadoghq.comSite Datadog à partir duquel l’emplacement privé récupère la configuration de test et vers lequel il envoie les résultats du test. Doit être configuré sur datadoghq.eu pour les utilisateurs du site européen de Datadog.

Configuration du DNS

OptionTypeValeur par défautDescription
dnsUseHostBooléentrueUtilise la configuration DNS locale du host en priorité (p. ex., la configuration définie dans votre fichier etc/resolv.conf), puis les serveurs DNS spécifiés dans le paramètre dnsServer (le cas échéant).
dnsServerTableau de chaînes["8.8.8.8","1.1.1.1"]Adresses IP des serveurs DNS utilisées dans l’ordre donné (p. ex., --dnsServer="8.8.4.4" --dnsServer="8.8.8.8").

Configuration des IP réservées

OptionTypeValeur par défautDescription
enableDefaultBlockedIpRangesBooléenfalseEmpêcher les utilisateurs de créer des tests Synthetics sur des endpoints qui utilisent des plages d’IP réservées (Registre d’adresses à usage spécifique IANA IPv4 et IPv6), sauf si la plage a été explicitement autorisée avec le paramètre allowedIPRanges.
allowedIPRangesTableau de chaînesnoneAutoriser l’accès à des IP et/ou CIDR spécifiques parmi les plages d’IP bloquées via le paramètre enableDefaultBlockedIpRanges ou blockedIPRanges (p. ex., "allowedIPRanges.4": "10.0.0.0/8"). Remarque : allowedIPRanges est prioritaire sur blockedIPRanges.
blockedIPRangesTableau de chaînesnoneBloquer l’accès à des IP et/ou CIDR spécifiques en plus (ou non) des plages d’IP bloquées lorsque le paramètre enableDefaultBlockedIpRanges est défini sur true (p. ex. --blockedIPRanges.4="127.0.0.0/8" --blockedIPRanges.6="::1/128".)

Remarque : les paramètres whitelistedRange et blacklistedRange sont désormais obsolètes et doivent être remplacés par ceux spécifiés ci-dessus.

Configuration du proxy

OptionTypeValeur par défautDescription
proxyDatadogChaînenoneURL de proxy utilisée par l’emplacement privé pour envoyer des requêtes à Datadog (p. ex., --proxyDatadog=http://<VOTRE_UTILISATEUR>:<VOTRE_MOT_DE_PASSE>@<VOTRE_IP>:<VOTRE_PORT>).
proxyTestRequestsChaînenoneURL de proxy utilisée par l’emplacement privé pour envoyer les requêtes de test à l’endpoint.
proxyIgnoreSSLErrorsBooléenfalseIgnorer les erreurs SSL lorsque l’emplacement privé utilise un proxy pour envoyer des requêtes à Datadog.

Remarque : le paramètre proxy est désormais obsolète et doit être remplacé par proxyDatadog.

Configuration avancée

OptionTypeValeur par défautDescription
concurrencyNombre10Nombre maximum de tests exécutés simultanément.
maxTimeoutNombre60000Durée maximum d’exécution d’un test API (en millisecondes).

Administration des emplacements privés

OptionTypeValeur par défautDescription
logFormatChaîneprettyFormat des logs sortants ("pretty" ou "json"). Le format de log json vous permet de parser automatiquement ces logs lors de leur collecte par Datadog.
verbosityNombre3Niveau de verbosité (p. ex. -v, -vv, -vvv, etc.).
dumpConfigBooléennoneAfficher les paramètres de configuration du worker sans les secrets.
dumpFullConfigBooléennoneAfficher les paramètres de configuration du worker complets.
helpBooléennoneAfficher les informations d’aide.

Pour aller plus loin