Si vous devez changer le port, configurez l’option dogstatsd_port dans le fichier de configuration principal de l’Agent, et redémarrez l’Agent. Vous pouvez également configurer DogStatsD pour utiliser un socket de domaine UNIX.

Pour activer un port UDP personnalisé pour le serveur DogStatsD de l’Agent :

1. Définissez le paramètre dogstatsd_port :

   ## @param 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
   

2. Redémarrez votre Agent.

Par défaut, DogStatsD écoute sur le port UDP 8125, donc vous devez lier ce port à votre port hôte lors de l’exécution de l’Agent dans un conteneur. Si vos métriques StatsD proviennent de l’extérieur de localhost, vous devez définir DD_DOGSTATSD_NON_LOCAL_TRAFFIC sur true pour permettre la collecte des métriques. Pour exécuter l’Agent avec le serveur DogStatsD actif, exécutez la commande suivante :

docker run -d --cgroupns host \
              --pid host \
              -v /var/run/docker.sock:/var/run/docker.sock:ro \
              -v /proc/:/host/proc/:ro \
              -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
              -e DD_API_KEY=<DATADOG_API_KEY> \
              -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC="true" \
              -p 8125:8125/udp \
              registry.datadoghq.com/agent:latest

Si vous devez changer le port utilisé pour collecter les métriques StatsD, utilisez la variable d’environnement DD_DOGSTATSD_PORT="<NEW_DOGSTATSD_PORT>. Vous pouvez également configurer DogStatsD pour utiliser un socket de domaine UNIX.

La collecte des métriques StatsD est activée par défaut sur le socket de domaine UNIX. Pour commencer à collecter vos métriques StatsD via UDP, vous devez activer la fonctionnalité DogStatsD dans les paramètres de l’Opérateur.

1. Ajoutez features.dogstatsd.hostPortConfig.enabled à votre manifeste datadog-agent.yaml :

   features:
       dogstatsd:
           hostPortConfig:
               enabled: true
   

   This is an example datadog-agent.yaml manifest:

   apiVersion: datadoghq.com/v2alpha1
   kind: DatadogAgent
   metadata:
     name: datadog
   spec:
     global:
       credentials:
         apiSecret:
           secretName: datadog-secret
           keyName: api-key
     features:
       dogstatsd:
         hostPortConfig:
           enabled: true
   

   This enables the Agent to collect StatsD metrics over UDP on port 8125.

2. Appliquez le changement :

   kubectl apply -f datadog-agent.yaml
   

Avertissement : Le paramètre features.dogstatsd.hostPortConfig.hostPort ouvre un port sur votre hôte. Assurez-vous que votre pare-feu n’autorise l’accès qu’à vos applications ou sources de confiance. Si votre plugin réseau ne prend pas en charge hostPorts, ajoutez hostNetwork: true dans les spécifications de votre pod Agent. Cela partage l’espace de noms réseau de votre hôte avec l’Agent Datadog. Cela signifie également que tous les ports ouverts sur le conteneur sont ouverts sur l’hôte. Si un port est utilisé à la fois sur l’hôte et dans votre conteneur, ils entrent en conflit (puisqu’ils partagent le même espace de noms réseau) et le pod ne démarre pas. Certaines installations Kubernetes ne permettent pas cela.

Envoyez les métriques StatsD à l’Agent

Votre application a besoin d’un moyen fiable de déterminer l’adresse IP de son hôte. C’est simple dans Kubernetes 1.7, qui élargit l’ensemble des attributs que vous pouvez passer à vos pods en tant que variables d’environnement. Dans les versions 1.7 et supérieures, vous pouvez passer l’IP de l’hôte à n’importe quel pod en ajoutant une variable d’environnement au PodSpec. Par exemple, votre manifeste d’application pourrait ressembler à ceci :

env:
    - name: DD_AGENT_HOST
      valueFrom:
          fieldRef:
              fieldPath: status.hostIP

Avec cela, tout pod exécutant votre application est capable d’envoyer des métriques DogStatsD avec le port 8125 sur $DD_AGENT_HOST.

Remarque : En tant que meilleure pratique, Datadog recommande d’utiliser un étiquetage de service unifié lors de l’attribution d’attributs. Le marquage de service unifié relie la télémétrie de Datadog grâce à l’utilisation de trois balises standard : env, service et version. Pour apprendre à unifier votre environnement, consultez le marquage de service unifié.

Pour recueillir des métriques custom avec DogStatsD avec Helm :

1. Mettez à jour votre fichier datadog-values.yaml pour activer DogStatsD :

     dogstatsd:
       port: 8125
       useHostPort: true
       nonLocalTraffic: true
   

   Note: hostPort functionality requires a networking provider that adheres to the CNI specification, such as Calico, Canal, or Flannel. For more information, including a workaround for non-CNI network providers, see the Kubernetes documentation: HostPort services do not work.

   Warning: The hostPort parameter opens a port on your host. Make sure your firewall only allows access from your applications or trusted sources. If your network plugin doesn’t support hostPorts, so add hostNetwork: true in your Agent pod specifications. This shares the network namespace of your host with the Datadog Agent. It also means that all ports opened on the container are opened on the host. If a port is used both on the host and in your container, they conflict (since they share the same network namespace) and the pod does not start. Some Kubernetes installations do not allow this.

2. Mettez à niveau la configuration de votre Agent :

   helm upgrade -f datadog-values.yaml <RELEASE_NAME> datadog/datadog
   

3. Mettez à jour vos pods d’application : Votre application a besoin d’un moyen fiable pour déterminer l’adresse IP de son hôte. C’est simple dans Kubernetes 1.7, qui élargit l’ensemble des attributs que vous pouvez passer à vos pods en tant que variables d’environnement. Dans les versions 1.7 et supérieures, vous pouvez passer l’IP de l’hôte à n’importe quel pod en ajoutant une variable d’environnement au PodSpec. Par exemple, votre manifeste d’application pourrait ressembler à ceci :

   env:
       - name: DD_AGENT_HOST
         valueFrom:
             fieldRef:
                 fieldPath: status.hostIP
   

   With this, any pod running your application is able to send DogStatsD metrics through port 8125 on $DD_AGENT_HOST.

Sur Linux, l’ID du conteneur peut être extrait des entrées procfs liées à cgroups. Le client lit à partir de /proc/self/cgroup ou /proc/self/mountinfo pour tenter d’analyser l’ID du conteneur.

Dans cgroup v2, l’ID du conteneur peut être déduit en résolvant le chemin du cgroup à partir de /proc/self/cgroup, en le combinant avec le point de montage du cgroup à partir de /proc/self/mountinfo. L’inode du répertoire résultant est envoyé à l’Agent Datadog. Si l’Agent Datadog se trouve sur le même nœud que le client, cette information peut être utilisée pour identifier le UID du pod.

Pour activer la détection d’origine sur UDP, ajoutez les lignes suivantes au manifeste de votre application :

env:
- name: DD_ENTITY_ID
    valueFrom:
      fieldRef:
        fieldPath: metadata.uid

Le client DogStatsD attache une étiquette interne, entity_id. La valeur de cette étiquette est le contenu de la variable d’environnement DD_ENTITY_ID, qui est le UID du pod.

Ajoutez l’étiquette suivante à votre pod :

admission.datadoghq.com/enabled: "true"

Si votre pod a cette étiquette, le Contrôleur d’Admissions injecte une variable d’environnement, DD_EXTERNAL_ENV. La valeur de cette variable est envoyée dans un champ avec la métrique, qui peut être utilisée par l’Agent Datadog pour déterminer l’origine de la métrique.