Présentation

Tout le trafic de l’Agent est envoyé via SSL. La destination dépend du service et du site Datadog. Pour voir les destinations basées sur votre Datadog site, cliquez sur le sélecteur DATADOG SITE à droite.

Installation

Ajoutez les domaines suivants à votre liste d’inclusion pour autoriser l’installation de l’Agent :

• install.datadoghq.com
• yum.datadoghq.com
• keys.datadoghq.com
• apt.datadoghq.com
• windows-agent.datadoghq.com

Destinations

APM

trace.agent.
instrumentation-telemetry-intake.

LLM Observabilty

llmobs-intake.

Container Images

contimage-intake.

Live Containers, Live Process, Cloud Network Monitoring, Universal Service Monitoring

process.

Network Device Monitoring

ndm-intake.
snmp-traps-intake.
ndmflow-intake.

Network Path

netpath-intake.
Dans l’Agent v7.75+, Network Path contacte des services externes via HTTPS pour résoudre l’adresse IP publique du host source. Ceci est facultatif et Network Path fonctionne sans cela, mais si votre réseau restreint le trafic sortant et que vous souhaitez une résolution de l’adresse IP publique source, ajoutez ce qui suit à votre liste d’inclusion : icanhazip.com, ipinfo.io, checkip.amazonaws.com, api.ipify.org, whatismyip.akamai.com. Voir Network Path Setup pour plus de détails.

Orchestrator

orchestrator.
contlcycle-intake.

Profiling

intake.profile.

Real User Monitoring (RUM)

Cloud Security Vulnerabilities

sbom-intake.

Synthetic Monitoring Private Locations

Synthetics Worker v1.5.0 ou version ultérieure : intake.synthetics. est le seul endpoint que vous devez configurer.
Résultats des tests API pour Synthetics Worker > v0.1.6 : intake.synthetics.
Résultats des tests de navigateur pour Synthetics Worker > v0.2.0 : intake-v2.synthetics.
Résultats des tests API pour Synthetics Worker < v0.1.5 : api.

Remote Configuration

config.

Logs & HIPAA logs

(Obsolète) TCP :
HTTP :
Autre : Voir logs endpoints

Logs HIPAA hérités (Obsolète, TCP non pris en charge)

Metrics, Service Checks, Events et autres métadonnées de l’Agent

<VERSION>-app.agent.
Par exemple, l’Agent v7.31.0 envoie des rapports à 7-31-0-app.agent.. Vous devez ajouter *.agent. à votre liste d’inclusion dans votre/vos pare-feu.
Depuis la v6.1.0, l’Agent interroge également l’API de Datadog pour fournir des fonctionnalités non critiques (par exemple, afficher la validité de la clé d’API configurée) :
Agent v7.18.0 ou 6.18.0 et versions ultérieures : api.
Agent < v7.18.0 ou 6.18.0 : app.

Agent flare

<VERSION>-flare.agent.
Par exemple, l’Agent v7.31.0 envoie des données de flare à 7-31-0-flare.agent.. Vous devez ajouter *.agent. à votre liste d’inclusion dans votre/vos pare-feu.

Adresses IP statiques

Tous ces domaines sont des enregistrements CNAME pointant vers un ensemble d’adresses IP statiques. Ces adresses se trouvent sur https://ip-ranges..

Les informations sont structurées au format JSON selon le schéma suivant :

{
    "version": 1,                          // <-- incremented every time this information is changed
    "modified": "YYYY-MM-DD-HH-MM-SS",     // <-- timestamp of the last modification
    "agents": {                            // <-- the IPs used by the Agent to submit metrics to Datadog
        "prefixes_ipv4": [                 // <-- list of IPv4 CIDR blocks
            "a.b.c.d/x",
            ...
        ],
        "prefixes_ipv6": [                 // <-- list of IPv6 CIDR blocks
            ...
        ]
    },
    "api": {...},                          // <-- the IPs used by the Agent for non-critical functionality (querying information from API)
    "apm": {...},                          // <-- the IPs used by the Agent to submit APM data to Datadog
    "logs": {...},                         // <-- the IPs used by the Agent to submit logs to Datadog
    "process": {...},                      // <-- the IPs used by the Agent to submit process data to Datadog
    "orchestrator": {...},                 // <-- the IPs used by the Agent to submit container data to Datadog
    "remote-configuration": {...},         // <-- the IPs used by the Agent to retrieve its dynamic configuration
    "synthetics": {...},                   // <-- the source IPs used by Synthetic workers (not used by the Agent)
    "synthetics-private-locations": {...}, // <-- the IPs used by Synthetics Private Locations workers to submit data to Datadog (not used by the Agent)
    "webhooks": {...}                      // <-- the source IPs used by Datadog to connect to 3rd party infrastructure over HTTP (not used by the Agent)
}

Chaque section possède un endpoint dédié sur, par exemple :

• https://ip-ranges./logs.json pour les adresses IP utilisées pour recevoir les logs via TCP.
• https://ip-ranges./apm.json pour les adresses IP utilisées pour recevoir les données APM.

Inclusion

Ajoutez tous les ip-ranges à votre liste d’inclusion. Bien qu’un sous-ensemble seulement soit actif à un moment donné, l’ensemble complet subit des variations au fil du temps en raison du fonctionnement normal du réseau et de la maintenance.

Ports ouverts

Ouvrez les ports suivants pour bénéficier de toutes les fonctionnalités de l’Agent :

Sortant

Entrant

Ports utilisés pour les services de l’Agent qui communiquent entre eux en local au sein du host uniquement

Configurer les ports

Si vous devez modifier un port entrant parce que le port par défaut est déjà utilisé par un service existant sur votre réseau, modifiez le datadog.yaml fichier de configuration. Vous pouvez trouver la plupart des ports dans la section Configuration avancée du fichier :

## @param expvar_port - integer - optional - default: 5000
## @env DD_EXPVAR_PORT - integer - optional - default: 5000
## The port for the go_expvar server.
#
# expvar_port: 5000

## @param cmd_port - integer - optional - default: 5001
## @env DD_CMD_PORT - integer - optional - default: 5001
## The port on which the IPC api listens.
#
# cmd_port: 5001

## @param GUI_port - integer - optional
## @env DD_GUI_PORT - integer - optional
## The port for the browser GUI to be served.
## Setting 'GUI_port: -1' turns off the GUI completely
## Default is:
##  * Windows & macOS : `5002`
##  * Linux: `-1`
##
#
# GUI_port: <GUI_PORT>

Le récepteur APM et les ports DogStatsD sont situés respectivement dans les sections Trace Collection Configuration et DogStatsD Configuration du fichier de configuration datadog.yaml :

## @param dogstatsd_port - integer - optional - default: 8125
## @env DD_DOGSTATSD_PORT - integer - optional - default: 8125
## Override the Agent DogStatsD port.
## Note: Make sure your client is sending to the same UDP port.
#
# dogstatsd_port: 8125

[...]

## @param receiver_port - integer - optional - default: 8126
## @env DD_APM_RECEIVER_PORT - integer - optional - default: 8126
## The port that the trace receiver should listen on.
## Set to 0 to disable the HTTP receiver.
#
# receiver_port: 8126

Utilisation de proxies

Pour obtenir des instructions détaillées sur la configuration d’un proxy, consultez la section Configuration de l’Agent pour un proxy.

Mise en mémoire tampon des données

Si le réseau devient indisponible, l’Agent stocke les métriques en mémoire. L’utilisation maximale de la mémoire pour le stockage des métriques est définie par le forwarder_retry_queue_payloads_max_size paramètre de configuration. Lorsque cette limite est atteinte, les métriques sont supprimées.

L’Agent v7.27.0 ou version ultérieure stocke les métriques sur le disque lorsque la limite de mémoire est atteinte. Activez cette fonctionnalité en définissant forwarder_storage_max_size_in_bytes sur une valeur positive indiquant la quantité maximale d’espace de stockage, en octets, que l’Agent peut utiliser pour stocker les métriques sur le disque.

Les métriques sont stockées dans le dossier défini par le paramètre forwarder_storage_path, qui est par défaut /opt/datadog-agent/run/transactions_to_retry sur les systèmes Unix, et C:\ProgramData\Datadog\run\transactions_to_retry sur Windows.

Pour éviter de manquer d’espace de stockage, l’Agent stocke les métriques sur le disque uniquement si l’espace de stockage total utilisé est inférieur à 80 pour cent. Cette limite est définie par le forwarder_storage_max_disk_ratio paramètre.

Installation du Datadog Operator

Si vous installez le Datadog Operator dans un environnement Kubernetes avec une connectivité limitée, vous devez ajouter les endpoints suivants à votre liste d’autorisation pour le port TCP 443, en fonction de votre registre :

• registry.datadoghq.com (Datadog Container Registry)
  • us-docker.pkg.dev/datadog-prod/public-images (peut recevoir des redirections depuis registry.datadoghq.com)
• gcr.io/datadoghq (GCR US)
• eu.gcr.io/datadoghq (GCR Europe)
• asia.gcr.io/datadoghq (GCR Asie)
• datadoghq.azurecr.io (Azure)
• public.ecr.aws/datadog (AWS)
• docker.io/datadog (DockerHub)

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

En savoir plus sur le site DatadogDOCUMENTATION Recueillir vos logsDOCUMENTATION Recueillir vos processusDOCUMENTATION Recueillir vos tracesDOCUMENTATION