Instalación

Puedes utilizar DaemonSets para desplegar Datadog Agent en todos tus nodos (o en nodos específicos utilizando nodeSelectors).

Para instalar Datadog Agent en tu clúster de Kubernetes:

1. Configurar permisos de Agent: si tu Kubernetes tiene habilitado el control de acceso basado en roles (RBAC), configura permisos RBAC para tu cuenta de servicio de Datadog Agent. A partir de Kubernetes 1.6, RBAC está habilitado por defecto. Crea los roles ClusterRole, ServiceAccount y ClusterRoleBinding apropiados con el siguiente comando:

   kubectl apply -f "https://raw.githubusercontent.com/DataDog/datadog-agent/master/Dockerfiles/manifests/rbac/clusterrole.yaml"
   
   kubectl apply -f "https://raw.githubusercontent.com/DataDog/datadog-agent/master/Dockerfiles/manifests/rbac/serviceaccount.yaml"
   
   kubectl apply -f "https://raw.githubusercontent.com/DataDog/datadog-agent/master/Dockerfiles/manifests/rbac/clusterrolebinding.yaml"
   

   Nota: Estas configuraciones RBAC se establecen para el espacio de nombres default. Si estás en un espacio de nombres personalizado, actualiza el parámetro namespace antes de aplicarlas.

2. **Crear el manifiesto de Datadog Agent **. Crea el manifiesto datadog-agent.yaml a partir de una de las siguientes plantillas:

   Métricas	Logs	APM	Proceso	NPM	Seguridad	Linux	Windows
   						Plantilla de manifiesto	Plantilla de manifiesto (sin seguridad)
   						Plantilla de manifiesto	Plantilla de manifiesto
   						Plantilla de manifiesto	Plantilla de manifiesto
   						Plantilla de manifiesto	Plantilla de manifiesto
   						Plantilla de manifiesto	sin plantilla
   						Plantilla de manifiesto	Plantilla de manifiesto

   Para habilitar completamente la recopilación de trazas (traces), se requieren pasos adicionales en tu configuración del pod de la aplicación. Consulta también las páginas de documentación de logs, APM, procesos, y Monitorización del rendimiento de red, y Seguridad para aprender a habilitar cada característica individualmente.

   Nota: Estos manifiestos están configurados para el espacio de nombres default. Si estás en un espacio de nombres personalizado, actualiza el parámetro metadata.namespace antes de aplicarlos.

3. En el manifiesto secret-api-key.yaml, sustituye PUT_YOUR_BASE64_ENCODED_API_KEY_HERE por tu clave de API de Datadog codificada en base64. Para obtener la versión base64 de tu clave de la API, puedes ejecutar:

   echo -n '<Your API key>' | base64
   

4. Si estás utilizando la plantilla de manifiesto datadog-agent-all-features.yaml: en el manifiesto secret-cluster-agent-token.yaml, sustituye PUT_A_BASE64_ENCODED_RANDOM_STRING_HERE por una cadena aleatoria codificada en base64. Para obtener la versión en base64, puedes ejecutar:

   echo -n 'Random string' | base64
   

   Nota: La cadena aleatoria debe contener al menos 32 caracteres alfanuméricos para asegurar la comunicación de Cluster Agent a Agent.

5. **Establece tu sitio de Datadog ** en utilizando la variable de entorno DD_SITE en el manifiesto datadog-agent.yaml.

   Nota: Si la variable de entorno DD_SITE no se establece explícitamente, se establece por defecto el sitio US datadoghq.com. Si estás utilizando uno de los otros sitios, recibirás un mensaje de clave de API inválida. Utiliza el selector de sitio de documentación para ver la documentación apropiada para el sitio que estás utilizando.

6. Despliega el DaemonSet con el comando:

   kubectl apply -f datadog-agent.yaml
   

7. Verificación: para verificar que el Datadog Agent se está ejecutando en tu entorno como DaemonSet, ejecuta:

   kubectl get daemonset
   

   Si se despliega el Agent, aparecerá una salida similar al texto siguiente, donde DESIRED y CURRENT son iguales al número de nodos que se ejecutan en tu clúster.

   NAME      DESIRED   CURRENT   READY     UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   datadog   2         2         2         2            2           <none>          10s
   

Configuración

Recopilación de trazas

  # (...)
  containers:
  - name: trace-agent
    # (...)
    env:
    - name: DD_APM_ENABLED
      value: "true"
    - name: DD_APM_RECEIVER_SOCKET
      value: "/var/run/datadog/apm.socket"
  # (...)
    volumeMounts:
    - name: apmsocket
      mountPath: /var/run/datadog/
  volumes:
  - hostPath:
      path: /var/run/datadog/
      type: DirectoryOrCreate
  # (...)

Recopilación de logs

Nota: Esta opción no es compatible con Windows. Utiliza en su lugar la opción Helm.

Para activar la recopilación de logs con tu DaemonSet:

1. Establece la variable DD_LOGS_ENABLED y DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL en true en la sección env del manifiesto datadog.yaml del Agent:

    # (...)
     env:
       # (...)
       - name: DD_LOGS_ENABLED
         value: "true"
       - name: DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL
         value: "true"
       - name: DD_CONTAINER_EXCLUDE_LOGS
         value: "name:datadog-agent"
    # (...)
   

   Nota: Configurar DD_CONTAINER_EXCLUDE_LOGS impide que Datadog Agent recopile y envíe sus propios logs. Elimina este parámetro si deseas recopilar logs del Datadog Agent. Consulta la variable de entorno para ignorar contenedores para obtener más información. Cuando utilices ImageStreams dentro de entornos de OpenShift, configura DD_CONTAINER_INCLUDE_LOGS con el contenedor name para recopilar logs. Ambos parámetros Exclude/Include admiten expresiones regulares.

2. Monta el volumen pointerdir para evitar la pérdida de logs de contenedor durante reinicios o problemas de red y /var/lib/docker/containers para recopilar logs a través de archivo de log de Kubernetes también, dado que /var/log/pods es symlink a este directorio:

     # (...)
       volumeMounts:
         # (...)
         - name: pointerdir
           mountPath: /opt/datadog-agent/run
         - name: logpodpath
          mountPath: /var/log/pods
         # Docker runtime directory, replace this path
         # with your container runtime logs directory,
         # or remove this configuration if `/var/log/pods`
         # is not a symlink to any other directory.
         - name: logcontainerpath
          mountPath: /var/lib/docker/containers
     # (...)
     volumes:
       # (...)
       - hostPath:
           path: /opt/datadog-agent/run
         name: pointerdir
       - hostPath:
           path: /var/log/pods
         name: logpodpath
       # Docker runtime directory, replace this path
       # with your container runtime logs directory,
       # or remove this configuration if `/var/log/pods`
       # is not a symlink to any other directory.
       - hostPath:
           path: /var/lib/docker/containers
         name: logcontainerpath
       # (...)
   

   pointerdir se utiliza para almacenar un archivo con un puntero a todos los contenedores de los que el Agent está recopilando logs. Esto es para asegurarse de que no se pierde ninguno cuando se reinicia Agent, o en el caso de un problema de red.

Sin privilegios

(Opcional) Para ejecutar una instalación sin privilegios, añade lo siguiente a tu plantilla de pod:

  spec:
    securityContext:
      runAsUser: <USER_ID>
      supplementalGroups:
        - <DOCKER_GROUP_ID>

donde <USER_ID> es el UID para ejecutar el Agent y <DOCKER_GROUP_ID> es el ID grupal del propietario del socket de Docker o containerd.

Cuando el Agent se ejecuta con un usuario no raíz, no puede leer directamente los archivos de log contenidos en /var/lib/docker/containers. En este caso, es necesario montar el socket de Docker en el contenedor del Agent para que pueda obtener los logs del contenedor del daemon de Docker.

Recopilación de eventos de Cluster Agent

Si deseas que el Datadog Cluster Agent recopile eventos de Kubernetes, sigue estos pasos:

1. Desactiva la elección de líder en tu Agent de nodo estableciendo la variable leader_election o la variable de entorno DD_LEADER_ELECTION en false.

2. En el archivo de despliegue del Cluster Agent, establece la variable de entorno DD_COLLECT_KUBERNETES_EVENTS y DD_LEADER_ELECTION en true:

     - name: DD_COLLECT_KUBERNETES_EVENTS
       value: "true"
     - name: DD_LEADER_ELECTION
       value: "true"
   

La configuración de la elección del líder, como se describe en los pasos anteriores, asegura que solo un Cluster Agent recopile los eventos.

Alternativamente, para recopilar los eventos de Kubernetes de un Agent de nodo, establece las variables de entorno DD_COLLECT_KUBERNETES_EVENTS y DD_LEADER_ELECTION en true en tu manifiesto de Agent.

- name: DD_COLLECT_KUBERNETES_EVENTS
  value: "true"
- name: DD_LEADER_ELECTION
  value: "true"

Variables de entorno

A continuación, se muestra la lista de variables de entorno disponibles para el Datadog Agent utilizando un DaemonSet.

Opciones globales

Configuraciones de proxy

A partir del Agent v6.4.0 (y v6.5.0 para el Trace Agent), se pueden sobreescribir los valores de configuración de proxy del Agent con las siguientes variables de entorno:

Para obtener más información sobre la configuración de proxy, consulta la documentación de proxy del Agent v6.

DogStatsD (métricas personalizadas)

Enviar métricas personalizadas con el protocolo StatsD:

Obtén más información sobre DogStatsD en Unix Domain Sockets.

Etiquetado

Datadog recopila automáticamente etiquetas comunes de Kubernetes. Para extraer aún más etiquetas, utiliza las siguientes opciones:

Consulta la documentación de Extracción de etiquetas de Kubernetes para aprender más.

Ignora los contenedores

Excluye contenedores de la recopilación de logs, la recopilación de métricas y Autodiscovery. Datadog excluye los contenedores pause de Kubernetes y OpenShift por defecto. Estas listas de permisos y bloqueos se aplican únicamente a Autodiscovery; trazas y DogStatsD no se ven afectados. Estas variables de entorno admiten expresiones regulares en sus valores.

Encontrarás más ejemplos en la página Gestió de Container Discovery.

Nota: Las métricas kubernetes.containers.running, kubernetes.pods.running, docker.containers.running, .stopped, .running.total y .stopped.total no se ven afectadas por estos ajustes. Se cuentan todos los contenedores.

Autodiscovery

Varios