Si necesitas cambiar el puerto, configura la opción dogstatsd_port en el archivo principal de configuración del Agente, y reinicia el Agente. También puedes configurar DogStatsD para usar un socket de dominio UNIX.

Para habilitar un puerto UDP personalizado para el servidor DogStatsD del Agente:

1. Establece el parámetro 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. Reinicia tu Agente.

Por defecto, DogStatsD escucha en el puerto UDP 8125, por lo que necesitas vincular este puerto al puerto de tu host al ejecutar el Agente en un contenedor. Si tus métricas de StatsD provienen de fuera de localhost, debes establecer DD_DOGSTATSD_NON_LOCAL_TRAFFIC en true para permitir la recolección de métricas. Para ejecutar el Agente con el servidor DogStatsD activo, ejecuta el siguiente comando:

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 necesitas cambiar el puerto utilizado para recolectar métricas de StatsD, usa la variable de entorno DD_DOGSTATSD_PORT="<NEW_DOGSTATSD_PORT>. También puedes configurar DogStatsD para usar un socket de dominio UNIX.

La recolección de métricas de StatsD está habilitada por defecto en socket de dominio UNIX. Para comenzar a recolectar tus métricas de StatsD a través de UDP, necesitas activar la función DogStatsD en la configuración del Operador.

1. Agrega features.dogstatsd.hostPortConfig.enabled a tu datadog-agent.yaml manifiesto:

   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. Aplica el cambio:

   kubectl apply -f datadog-agent.yaml
   

Advertencia: El parámetro features.dogstatsd.hostPortConfig.hostPort abre un puerto en tu host. Asegúrate de que tu firewall solo permita el acceso desde tus aplicaciones o fuentes de confianza. Si tu complemento de red no soporta hostPorts, agrega hostNetwork: true en las especificaciones de tu pod de Agent. Esto comparte el espacio de nombres de red de tu host con el Agente de Datadog. También significa que todos los puertos abiertos en el contenedor están abiertos en el host. Si un puerto se utiliza tanto en el host como en tu contenedor, hay un conflicto (ya que comparten el mismo espacio de nombres de red) y el pod no inicia. Algunas instalaciones de Kubernetes no permiten esto.

Envía métricas StatsD al Agente

Tu aplicación necesita una forma confiable de determinar la dirección IP de su host. Esto se simplifica en Kubernetes 1.7, que amplía el conjunto de atributos que puedes pasar a tus pods como variables de entorno. En versiones 1.7 y superiores, puedes pasar la IP del host a cualquier pod agregando una variable de entorno al PodSpec. Por ejemplo, tu manifiesto de aplicación podría verse así:

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

Con esto, cualquier pod que ejecute tu aplicación puede enviar métricas de DogStatsD con el puerto 8125 en $DD_AGENT_HOST.

Nota: Como mejor práctica, Datadog recomienda usar unified service tagging al asignar atributos. El unified service tagging vincula la telemetría de Datadog a través del uso de tres etiquetas estándar: env, service y version. Para aprender cómo unificar tu entorno, consulta unified service tagging.

Para recopilar métricas personalizadas con DogStatsD usando helm:

1. Actualiza tu archivo datadog-values.yaml para habilitar 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. Actualiza la configuración de tu Agente:

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

3. Actualiza tus pods de aplicación: Tu aplicación necesita una forma confiable de determinar la dirección IP de su host. Esto se simplifica en Kubernetes 1.7, que amplía el conjunto de atributos que puedes pasar a tus pods como variables de entorno. En versiones 1.7 y superiores, puedes pasar la IP del host a cualquier pod agregando una variable de entorno al PodSpec. Por ejemplo, tu manifiesto de aplicación podría verse así:

   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.

En Linux, el ID del contenedor se puede extraer de las entradas procfs relacionadas con cgroups. El cliente lee de /proc/self/cgroup o /proc/self/mountinfo para intentar analizar el ID del contenedor.

En cgroup v2, el ID del contenedor se puede inferir resolviendo la ruta del cgroup desde /proc/self/cgroup, combinándola con el punto de montaje del cgroup desde /proc/self/mountinfo. El inode del directorio resultante se envía al Datadog Agent. Si el Datadog Agent está en el mismo nodo que el cliente, esta información se puede utilizar para identificar el UID del pod.

Para habilitar la detección de origen sobre UDP, agrega las siguientes líneas a tu manifiesto de aplicación:

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

El cliente de DogStatsD adjunta una etiqueta interna, entity_id. El valor de esta etiqueta es el contenido de la DD_ENTITY_ID variable de entorno, que es el UID del pod.

Agrega la siguiente etiqueta a tu pod:

admission.datadoghq.com/enabled: "true"

Si tu pod tiene esta etiqueta, el Controlador de Admisiones inyecta una variable de entorno, DD_EXTERNAL_ENV. El valor de esta variable se envía en un campo con la métrica, que puede ser utilizado por el Datadog Agent para determinar el origen de la métrica.