Trafic réseau

Présentation

L’intégralité du trafic de l’Agent est envoyé via SSL. La destination dépend du service et du site Datadog. Pour consulter les destinations disponibles en fonction de votre site, utilisez le sélecteur SITE sur la droite.

Destinations

APM

trace.agent.

Live Containers & Live Process

process.

Network Device Monitoring

ndm-intake.

snmp-traps-intake.

Orchestrator

orchestrator.

Profiling

intake.profile.

Real User Monitoring (RUM)

rum.
session-replay.

Emplacement privé Synthetic

Worker v>=1.5.0 : intake.synthetics. est le seul endpoint à configurer.
Résultats des tests API pour worker v>0.1.6 : intake.synthetics.
Résultats des tests Browser pour worker v>0.2.0 : intake-v2.synthetics.
Résultats des tests API pour worker v<0.1.5 : api.

Toutes les autres données de l’Agent

<VERSION>-app.agent.
Par exemple, l’Agent v7.31.0 envoie ses données à 7-31-0-app.agent.. Vous devez donc ajouter *.agent. dans les listes d’inclusion de vos pare-feu.
À partir de la v6.1.0, l’Agent interroge également l’API Datadog pour certaines fonctionnalités non essentielles (par exemple, pour indiquer la validité d’une clé d’API configurée) :
Agent >= 7.18.0/6.18.0 api.
Agent < 7.18.0/6.18.0 app.

Tous ces domaines sont des entrées CNAME qui pointent vers un ensemble d’adresses IP statiques. Vous pouvez trouver ces adresses sur la page https://ip-ranges..

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

{
    "version": 1,                          // <-- valeur incrémentée chaque fois que cette information est modifiée
    "modified": "YYYY-MM-DD-HH-MM-SS",     // <-- timestamp de la dernière modification
    "agents": {                            // <-- adresses IP utilisées par l'Agent pour envoyer des métriques à Datadog
        "prefixes_ipv4": [                 // <-- liste des blocs CIDR IPv4
            "a.b.c.d/x",
            ...
        ],
        "prefixes_ipv6": [                 // <-- liste des blocs CIDR IPv6
            ...
        ]
    },
    "api": {...},                          // <-- même chose, mais pour une fonctionnalité non essentielle de l'Agent (demande d'informations à partir de l'API)
    "apm": {...},                          // <-- même structure que « agents », mais il s'agit des adresses IP utilisées pour les données de l'Agent APM
    "logs": {...},                         // <-- même chose, mais pour les données de l'Agent de log
    "process": {...},                      // <-- même chose, mais pour les données de l'Agent de processus
    "orchestrator": {...},                 // <-- même chose, mais pour les données de l'Orchestrator
    "synthetics": {...},                   // <-- non utilisé pour le trafic de l'Agent (adresses IP sources de Datadog pour les bots utilisés pour les tests Synthetic)
    "synthetics-private-locations": {...}, // <--  non utilisé pour le trafic de l'Agent (adresses IP d'admission des emplacements privés Synthetics)
    "webhooks": {...}                      // <-- non utilisé pour le trafic de l'Agent (adresses IP Datadog transmettant les webhooks)
}

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

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

Inclusion

Toutes les ip-ranges doivent être ajoutées à votre liste d’inclusion. Bien qu’elles ne soient pas toutes actives en même temps, les adresses utilisées sont amenées à changer en raison des opérations de gestion et de maintenance réseau effectuées régulièrement.

Ports ouverts

Ouvrez les ports suivants pour profiter de toutes les fonctionnalités de l’Agent :

Utilisation d’un proxy

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 votre réseau n’est plus disponible, 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 paramètre forwarder_retry_queue_payloads_max_size. Lorsque cette limite est atteinte, les métriques sont ignorées.

À partir de la v7.27.0, l’Agent stocke les métriques sur disque une fois la limite de mémoire atteinte. Pour activer cette fonctionnalité, définissez le paramètre forwarder_storage_max_size_in_bytes sur une valeur positive correspondant au volume d’espace de stockage maximal, en octets, que l’Agent peut utiliser pour stocker les métriques sur disque.

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

Pour veiller à ne pas utiliser tout l’espace de stockage, l’Agent stocke les métriques sur disque uniquement si le total d’espace de stockage utilisé est inférieur à 95 %. La valeur de cette limite est définie par le paramètre forwarder_storage_max_disk_ratio.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Recueillir vos logsDOCUMENTATION Recueillir vos processusDOCUMENTATION Recueillir vos tracesDOCUMENTATION