Implémentation

Docs > Surveillance réseau > Network Path > Implémentation

Cette traduction n'est pas à jour. Pour consulter la dernière version en anglais, cliquez ici

Aperçu

La configuration du chemin réseau implique de configurer votre environnement pour surveiller et tracer les routes réseau entre vos services et points de terminaison. Cela aide à identifier les goulets d’étranglement, les problèmes de latence et les points de défaillance potentiels dans votre infrastructure réseau. Le chemin réseau vous permet de configurer manuellement des chemins réseau individuels, de les découvrir automatiquement ou d’utiliser les deux méthodes simultanément, en fonction de vos besoins.

Remarque : Si votre configuration réseau restreint le trafic sortant, suivez les instructions de configuration dans la documentation Agent proxy configuration.

Configuration

Cette page couvre la configuration du chemin réseau pour la configuration basée sur l'Agent dans Network Monitoring. Pour créer des tests de chemin réseau dans Synthetic Monitoring, voir Tests de chemin réseau dans Synthetic Monitoring.

Datadog fournit deux méthodes de collecte basées sur l’Agent. Vous pouvez utiliser l’une ou l’autre méthode seule ou combiner les deux :

Méthode	Quand utiliser
Tests programmés	Surveillez des paires source-destination spécifiques que vous définissez dans la configuration de l’Agent. Idéal pour suivre un ensemble connu de points de terminaison, tels que des API critiques ou des services partenaires.
Tests dynamiques	Découvrez et surveillez automatiquement les chemins en fonction du trafic observé par Cloud Network Monitoring. Idéal pour une visibilité large sans lister manuellement chaque destination.

Tests programmés

Vous pouvez surveiller des chemins réseau spécifiques en les définissant dans le fichier de configuration de l’Agent situé à /etc/datadog-agent/conf.d/network_path.d/conf.yaml.

Pour commencer, copiez la configuration d’exemple, supprimez l’extension .example et mettez-la à jour avec vos paramètres souhaités, ou utilisez l’une des configurations spécifiques à l’environnement ci-dessous. Pour optimiser les performances dans de grands environnements, consultez augmenter le nombre de workers.

L’Agent v7.59+ est requis.

Activez le module system-probe traceroute dans /etc/datadog-agent/system-probe.yaml en ajoutant ce qui suit :
```
traceroute:
  enabled: true
```

Activez network_path pour surveiller de nouvelles destinations depuis cet Agent en créant ou en modifiant le fichier /etc/datadog-agent/conf.d/network_path.d/conf.yaml :

init_config:
  min_collection_interval: 60 # in seconds, default 60 seconds
instances:
  # configure the endpoints you want to monitor, one check instance per endpoint
  # warning: Do not set the port when using UDP. Setting the port when using UDP can cause traceroute calls to fail and falsely report an unreachable destination.

  - hostname: api.datadoghq.eu # endpoint hostname or IP
    protocol: TCP
    port: 443
    tags:
      - "tag_key:tag_value"
      - "tag_key2:tag_value2"
    min_collection_interval: 120 # set min_collection_interval at the instance level
  ## optional configs:
  # max_ttl: 30 # max traceroute TTL, default is 30
  # timeout: 1000 # timeout in milliseconds per hop, default is 1s
  # tcp_method: syn # TCP probing method, default is syn, options: syn, sack, prefer_sack
  # traceroute_queries: 3 # number of traceroutes to send per check run, default is 3
  # e2e_queries: 50 # number of end-to-end probes to send per check run, default is 50

  # more endpoints
  - hostname: 1.1.1.1 # endpoint hostname or IP
    protocol: UDP
    tags:
      - "tag_key:tag_value"
      - "tag_key2:tag_value2"

Redémarrez l’Agent après avoir effectué ces modifications de configuration pour commencer à voir les chemins réseau.

L’Agent v7.75+ est requis.

Activez le module system-probe traceroute dans /opt/datadog-agent/etc/system-probe.yaml en ajoutant ce qui suit :
```
traceroute:
  enabled: true
```

Activez network_path pour surveiller de nouvelles destinations depuis cet Agent en créant ou en modifiant le fichier /opt/datadog-agent/etc/conf.d/network_path.d/conf.yaml :

init_config:
  min_collection_interval: 60 # in seconds, default 60 seconds
instances:
  # configure the endpoints you want to monitor, one check instance per endpoint
  # warning: Do not set the port when using UDP. Setting the port when using UDP can cause traceroute calls to fail and falsely report an unreachable destination.

  - hostname: api.datadoghq.eu # endpoint hostname or IP
    protocol: TCP
    port: 443
    tags:
      - "tag_key:tag_value"
      - "tag_key2:tag_value2"
    min_collection_interval: 120 # set min_collection_interval at the instance level
  ## optional configs:
  # max_ttl: 30 # max traceroute TTL, default is 30
  # timeout: 1000 # timeout in milliseconds per hop, default is 1s
  # tcp_method: syn # TCP probing method, default is syn, options: syn, sack, prefer_sack
  # traceroute_queries: 3 # number of traceroutes to send per check run, default is 3
  # e2e_queries: 50 # number of end-to-end probes to send per check run, default is 50

  # more endpoints
  - hostname: 1.1.1.1 # endpoint hostname or IP
    protocol: UDP
    tags:
      - "tag_key:tag_value"
      - "tag_key2:tag_value2"

Redémarrez l’Agent après avoir effectué ces modifications de configuration pour commencer à voir les chemins réseau.

L’Agent v7.72+ est requis.

Activez le module system-probe traceroute dans %ProgramData%\Datadog\system-probe.yaml en ajoutant ce qui suit :
```
traceroute:
  enabled: true
```

Activez network_path pour surveiller de nouvelles destinations depuis cet Agent en créant ou en modifiant le fichier %ProgramData%\Datadog\conf.d\network_path.d\conf.yaml :

init_config:
  min_collection_interval: 60 # in seconds, default 60 seconds
instances:
  # configure the endpoints you want to monitor, one check instance per endpoint
  # warning: Do not set the port when using UDP. Setting the port when using UDP can cause traceroute calls to fail and falsely report an unreachable destination.

  - hostname: api.datadoghq.eu # endpoint hostname or IP
    protocol: TCP
    port: 443
    tags:
      - "tag_key:tag_value"
      - "tag_key2:tag_value2"
    min_collection_interval: 120 # set min_collection_interval at the instance level
  ## optional configs:
  # max_ttl: 30 # max traceroute TTL, default is 30
  # timeout: 1000 # timeout in milliseconds per hop, default is 1s
  # tcp_method: syn # TCP probing method, default is syn, options: syn, sack, prefer_sack, syn_socket (Windows only)
  # traceroute_queries: 3 # number of traceroutes to send per check run, default is 3
  # e2e_queries: 50 # number of end-to-end probes to send per check run, default is 50

  # more endpoints
  - hostname: 1.1.1.1 # endpoint hostname or IP
    protocol: TCP
    tags:
      - "tag_key:tag_value"
      - "tag_key2:tag_value2"

Redémarrez l’Agent après avoir effectué ces modifications de configuration pour commencer à voir les chemins réseau.

L’Agent v7.59+ est requis.

La version du chart Helm v3.109.1+ est requise. Pour plus d'informations, consultez la documentation du chart Helm Datadog et la documentation pour Kubernetes et les Intégrations.

Pour activer le chemin réseau avec Kubernetes en utilisant Helm, ajoutez ce qui suit à votre fichier values.yaml.

datadog:
  traceroute:
    enabled: true
  confd:
    network_path.yaml: |-
      init_config:
        min_collection_interval: 60 # in seconds, default 60 seconds
      instances:
        # configure the endpoints you want to monitor, one check instance per endpoint
        # warning: Do not set the port when using UDP. Setting the port when using UDP can cause traceroute calls to fail and falsely report an unreachable destination.

        - hostname: api.datadoghq.eu # endpoint hostname or IP
          protocol: TCP
          port: 443
          tags:
            - "tag_key:tag_value"
            - "tag_key2:tag_value2"
          min_collection_interval: 120 # set min_collection_interval at the instance level
        ## optional configs:
        # max_ttl: 30 # max traceroute TTL, default is 30
        # timeout: 1000 # timeout in milliseconds per hop, default is 1s
        # tcp_method: syn # TCP probing method, default is syn, options: syn, sack, prefer_sack
        # traceroute_queries: 3 # number of traceroutes to send per check run, default is 3
        # e2e_queries: 50 # number of end-to-end probes to send per check run, default is 50

        # more endpoints
        - hostname: 1.1.1.1 # endpoint hostname or IP
          protocol: UDP
          tags:
            - "tag_key:tag_value"
            - "tag_key2:tag_value2"

Datadog Autodiscovery allows you to enable Network Path on a per-service basis through Kubernetes annotations.

Helm chart v3.109.1+ is required. For more information, see the Datadog Helm Chart documentation.

Enable the traceroute module in the Datadog values.yaml file, which the Network Path integration depends on.
```
datadog:
  traceroute:
    enabled: true
```

After the module is enabled, Datadog automatically detects Network Path annotations added to your Kubernetes pod. For more information, see Kubernetes and Integrations.

apiVersion: v1
kind: Pod
# (...)
metadata:
  name: '<POD_NAME>'
  annotations:
    ad.datadoghq.com/<CONTAINER_NAME>.checks: |
      {
        "network_path": {
          "init_config": {
            "min_collection_interval": 300
          },
          "instances": [
                {
                  "protocol": "TCP",
                  "port": 443,
                  "source_service": "<CONTAINER_NAME>",
                  "tags": [
                    "tag_key:tag_value",
                    "tag_key2:tag_value2"
                  ],
                  "hostname": "api.datadoghq.eu"
                },
                {
                  "protocol": "UDP",
                  "source_service": "<CONTAINER_NAME>",
                  "tags": [
                    "tag_key:tag_value",
                    "tag_key2:tag_value2"
                  ],
                  "hostname": "1.1.1.1"
                },
          ]
        }
      }
    # (...)
spec:
  containers:
    - name: '<CONTAINER_NAME>'
# (...)

If you define pods indirectly (with deployments, ReplicaSets, or ReplicationControllers), add pod annotations under spec.template.metadata.

Increase the number of workers

Network Path monitoring for individual paths runs as an Agent Integration. The number of concurrent workers is controlled by the check_runners setting in the datadog.yaml file.

To increase the number of workers, add the following configuration to your datadog.yaml file:

## @param check_runners - integer - optional - default: 4
## @env DD_CHECK_RUNNERS - integer - optional - default: 4
## The `check_runners` refers to the number of concurrent check runners available for check instance execution.
## The scheduler attempts to spread the instances over the collection interval and will _at most_ be
## running the number of check runners instances concurrently.
##
## The level of concurrency has effects on the Agent's: RSS memory, CPU load, resource contention overhead, etc.
#
check_runners: <NUMBER_OF_WORKERS>

Dynamic tests

Prerequisites: CNM must be enabled.

Configure dynamic tests to allow the Agent to automatically discover and monitor network paths based on actual network traffic, eliminating the need to manually configure individual endpoints. See filter syntax to include/exclude domain or IPs.

L’Agent v7.73+ est requis.

Activez le module system-probe traceroute dans /etc/datadog-agent/system-probe.yaml en ajoutant ce qui suit :
```
traceroute:
  enabled: true
```

Activez network_path pour surveiller les connexions CNM en créant ou en modifiant le fichier /etc/datadog-agent/datadog.yaml :

network_path:
  connections_monitoring:
    enabled: true
  # collector:
    # workers: <NUMBER OF WORKERS> # default 4

For full configuration details, reference the example config, or use the following:

network_path:
  connections_monitoring:
    ## @param enabled - bool - required - default:false
    ## Enable network path collection
    #
    enabled: true
  collector:
    ## @param workers - int - optional - default:4
    ## Number of workers that can collect paths in parallel
    ## Recommendation: leave at default
    #
    # workers: <NUMBER OF WORKERS> # default 4

    #@env DD_NETWORK_PATH_COLLECTOR_PATHTEST_INTERVAL - integer - optional - default: 10m
    # The `pathtest_interval` refers to the traceroute run interval for monitored connections.
    # pathtest_interval: 10m

    # @param pathtest_ttl - integer - optional - default: 35m
    # @env DD_NETWORK_PATH_COLLECTOR_PATHTEST_TTL - integer - optional - default: 35m
    # The `pathtest_ttl` refers to the duration (time-to-live) a connection will be monitored when it's not seen anymore.
    # The TTL is reset each time the connection is seen again.
    # pathtest_ttl: 35m

    ## @param filters - list - optional
    ## Include or exclude specific domains or IP ranges from dynamic monitoring.
    ## Filters are applied sequentially, with later filters taking precedence.
    ## See the "Filter syntax" section for details and examples: https://docs.datadoghq.com/network_monitoring/network_path/setup/#filter-syntax
    #
    # filters:
    #   - match_domain: '*.example.com'
    #     type: exclude
    #   - match_ip: 10.0.0.0/8
    #     type: exclude
    #   - match_domain: 'api.datadoghq.com'
    #     type: include

Redémarrez l’Agent après avoir effectué ces modifications de configuration pour commencer à voir les chemins réseau.

L’Agent v7.73+ est requis.

Activez le module system-probe traceroute dans %ProgramData%\Datadog\system-probe.yaml en ajoutant ce qui suit :
```
traceroute:
  enabled: true
```

Activez network_path pour surveiller les connexions CNM en créant ou en modifiant le fichier %ProgramData%\Datadog\datadog.yaml :

network_path:
  connections_monitoring:
    enabled: true
  # collector:
    # workers: <NUMBER OF WORKERS> # default 4

For full configuration details, reference the example config, or use the following:

network_path:
  connections_monitoring:
    ## @param enabled - bool - required - default:false
    ## Enable network path collection
    #
    enabled: true
  collector:
    ## @param workers - int - optional - default:4
    ## Number of workers that can collect paths in parallel
    ## Recommendation: leave at default
    #
    # workers: <NUMBER OF WORKERS> # default 4

    #@env DD_NETWORK_PATH_COLLECTOR_PATHTEST_INTERVAL - integer - optional - default: 10m
    # The `pathtest_interval` refers to the traceroute run interval for monitored connections.
    # pathtest_interval: 10m

    # @param pathtest_ttl - integer - optional - default: 35m
    # @env DD_NETWORK_PATH_COLLECTOR_PATHTEST_TTL - integer - optional - default: 35m
    # The `pathtest_ttl` refers to the duration (time-to-live) a connection will be monitored when it's not seen anymore.
    # The TTL is reset each time the connection is seen again.
    # pathtest_ttl: 35m

    ## @param filters - list - optional
    ## Include or exclude specific domains or IP ranges from dynamic monitoring.
    ## Filters are applied sequentially, with later filters taking precedence.
    ## See the "Filter syntax" section for details and examples: https://docs.datadoghq.com/network_monitoring/network_path/setup/#filter-syntax
    #
    # filters:
    #   - match_domain: '*.example.com'
    #     type: exclude
    #   - match_ip: 10.0.0.0/8
    #     type: exclude
    #   - match_domain: 'api.datadoghq.com'
    #     type: include

Redémarrez l’Agent après avoir effectué ces modifications de configuration pour commencer à voir les chemins réseau.

L’Agent v7.73+ est requis.

Pour activer le chemin réseau avec Kubernetes en utilisant Helm, ajoutez ce qui suit à votre fichier values.yaml. Remarque : La version du chart Helm v3.124.0+ est requise. Pour plus d’informations, consultez la documentation du chart Helm Datadog et la documentation pour Kubernetes et les Intégrations.

datadog:
  networkPath:
    connectionsMonitoring:
      enabled: true
  ## Set to true to enable the Traceroute Module of the System Probe
  traceroute:
    enabled: true

  ## @param collector - custom object - optional
  ## Configuration related to Network Path Collector.
  #
  collector:
    ## @param workers - integer - optional - default: 4
    ## @env DD_WORKERS - integer - optional - default: 4
    ## The `workers` refers to the number of concurrent workers available for network path execution.
    #
    # workers: 4
    
    ## @param pathtest_interval - integer - optional - default: 35m
    ## @env DD_NETWORK_PATH_COLLECTOR_PATHTEST_INTERVAL - integer - optional - default: 30m
    ## The `pathtest_interval` refers to the traceroute run interval for monitored connections.
    #
    # pathtest_interval: 30m

    ## @param pathtest_ttl - integer - optional - default: 35m
    ## @env DD_NETWORK_PATH_COLLECTOR_PATHTEST_TTL - integer - optional - default: 35m
    ## The `pathtest_ttl` refers to the duration (time-to-live) a connection will be monitored when it's not seen anymore.
    ## The TTL is reset each time the connection is seen again.
    #
    # pathtest_ttl: 35m

    ## @param filters - list - optional
    ## Include or exclude specific domains or IP ranges from dynamic monitoring.
    ## Filters are applied sequentially, with later filters taking precedence.
    ## See the "Filter syntax" section for details and examples: https://docs.datadoghq.com/network_monitoring/network_path/setup/#filter-syntax
    #
    # filters:
    #   - match_domain: '*.example.com'
    #     type: exclude
    #   - match_ip: 10.0.0.0/8
    #     type: exclude
    #   - match_domain: 'api.datadoghq.com'
    #     type: include

Syntaxe de filtrage

Configurez des filtres pour inclure ou exclure des domaines et des IP, vous permettant de :

Réduire la surcharge de surveillance pour les réseaux internes
Se concentrer sur les modèles de trafic externes
Exclure les plages d’infrastructure connues qui ne nécessitent pas de surveillance

Pour inclure ou exclure des domaines spécifiques ou des plages d’IP des tests dynamiques, ajoutez ce qui suit à votre fichier /etc/datadog-agent/datadog.yaml :

network_path:
  connections_monitoring:
    enabled: true
  collector:
    filters:
      # exclude single domain
      - match_domain: 'api.slack.com'
        type: exclude

      # exclude domain using `*` wildcard
      - match_domain: '*.datadoghq.com'      # this translates to regex '.*\.datadoghq\.com
        type: exclude
      - match_domain: '*.zoom.us'
        match_domain_strategy: wildcard      # use simple wildcard matching (wildcard matching is the default)
        type: exclude

      # exclude single IP or using CIDR notation
      - match_ip: 10.10.10.10
        type: exclude
      - match_ip: 10.20.0.0/24
        type: exclude

      # exclude using regex
      - match_domain: '.*\.zoom\.us'
        match_domain_strategy: regex         # use regex matching strategy
        type: exclude

      # include
      - match_domain: 'api.datadoghq.com'
        type: include

Remarque: Les filtres sont appliqués de manière séquentielle, les filtres ultérieurs ayant la priorité sur les précédents.

Par exemple, tous les domaines correspondant à *.datadoghq.com sont ignorés, sauf api.datadoghq.com.

network_path:
  collector:
    filters:
      - match_domain: '*.datadoghq.com'
        type: exclude
      - match_domain: 'api.datadoghq.com'
        type: include

Résolution de l’IP publique source

La résolution de l'IP publique source est disponible dans l'Agent v7.75+.

Le chemin réseau résout l’adresse IP publique de l’hôte source pour fournir une visualisation précise du chemin pour le trafic sortant vers Internet. L’Agent contacte des services de vérification d’IP externes via HTTPS pour déterminer l’IP publique de l’hôte.

Cette fonctionnalité n’est pas requise pour le bon fonctionnement du chemin réseau. Si ces services sont inaccessibles, le chemin réseau continue de fonctionner normalement, mais l’IP publique source n’est pas résolue et les visualisations de chemin ne montrent pas les métadonnées de l’IP source.

Si votre réseau restreint le trafic sortant et que vous souhaitez la résolution de l’IP publique source, ajoutez les URL suivantes à votre liste blanche de pare-feu :

URL	Fournisseur
`https://icanhazip.com`	Cloudflare
`https://ipinfo.io/ip`	IPinfo
`https://checkip.amazonaws.com`	Amazon
`https://api.ipify.org`	ipify
`https://whatismyip.akamai.com`	Akamai

L’Agent essaie chaque service dans l’ordre et utilise la première réponse réussie. Toutes les requêtes sont effectuées via HTTPS (port 443).

Dépannage

Utilisez les directives suivantes pour résoudre les problèmes liés au chemin réseau. Si vous avez besoin d’aide supplémentaire, contactez Datadog Support.

Aucune donnée de chemin réseau dans l’interface utilisateur

Si aucune donnée n’apparaît dans l’interface utilisateur Network Path, la fonctionnalité peut ne pas être entièrement activée. Le chemin réseau nécessite ce qui suit :

Le module traceroute doit être activé dans votre fichier system-probe.yaml :
```
traceroute:
  enabled: true
```
Au moins une fonctionnalité de chemin réseau doit être active, telle que :
- Des chemins individuels configurés via le fichier conf.d/network_path.d.
- Des chemins de trafic réseau expérimentaux configurés en activant à la fois network_path.connections_monitoring et Cloud Network Monitoring(CNM).

Erreur : code d’état : 404

Si vous rencontrez une erreur comme suit :

Error: failed to trace path: traceroute request failed: Probe Path <path>, url: <url>, status code: 404

Cela indique que le module traceroute n’est pas activé. Assurez-vous que le module traceroute est activé dans votre fichier system-probe.yaml.

Lectures complémentaires

Documentation, liens et articles supplémentaires utiles:

Obtenez une visibilité de bout en bout sur le réseau avec le chemin réseau et la surveillance SD-WANBLOG

Détection de la disponibilité des applications à l'aide de Network InsightsGUIDE

Variantes de traceroute du chemin réseauGUIDE

Implémentation

Aperçu

Configuration

Tests programmés

Increase the number of workers

Dynamic tests

Syntaxe de filtrage

Résolution de l’IP publique source

Dépannage

Aucune donnée de chemin réseau dans l’interface utilisateur

Erreur : code d’état : 404

Lectures complémentaires

How can I help you today?