Resumen

Esta página proporciona instrucciones sobre cómo instalar el Agente de Datadog en un entorno de Kubernetes.

Para documentación y ejemplos dedicados para las principales distribuciones de Kubernetes, incluyendo AWS Elastic Kubernetes Service (EKS), Azure Kubernetes Service (AKS), Google Kubernetes Engine (GKE), Red Hat OpenShift, Rancher y Oracle Container Engine para Kubernetes (OKE), consulte distribuciones de Kubernetes.

Para documentación y ejemplos dedicados para monitorear el plano de control de Kubernetes, consulte monitoreo del plano de control de Kubernetes.

Versiones mínimas de Kubernetes y del Agente de Datadog

Algunas características relacionadas con versiones posteriores de Kubernetes requieren una versión mínima del Agente de Datadog.

Para una compatibilidad óptima, Datadog recomienda mantener sus Cluster Agent y Agent en versiones coincidentes.

Instalación

Utilice la página de Instalación en Kubernetes en Datadog para guiarlo a través del proceso de instalación.

1. Seleccione el método de instalación

   Elija uno de los siguientes métodos de instalación:

   • Datadog Operator (recomendado): un operator de Kubernetes que puede usar para implementar el Datadog Agent en Kubernetes y OpenShift. Informa sobre el estado de despliegue, la salud y los errores en su estado de Custom Resource, y limita el riesgo de mala configuración gracias a opciones de configuración de nivel superior.
   • Helm
   • Instalación manual. Consulte Instalar y configurar manualmente el Datadog Agent con un DaemonSet

5. Confirme la instalación del Datadog Agent

   Verifique que los pods del Datadog Agent (etiquetados con app.kubernetes.io/component:agent) aparezcan en la página de Containers en Datadog. Los pods del Datadog Agent se detectan en pocos minutos después del despliegue.

Instalación no privilegiada

Para ejecutar una instalación no privilegiada, agregue lo siguiente securityContext a su configuración en relación con su <USER_ID> y <GROUP ID> deseados:

• Reemplace <USER_ID> con el UID para ejecutar el Datadog Agent. Datadog recomienda establecer este valor en 100 para el usuario dd-agent preexistente para Datadog Agent v7.48+.
• Reemplace <GROUP_ID> con el ID de grupo que posee el socket de Docker o containerd.

Esto establece el securityContext a nivel de pod para el Datadog Agent.

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    clusterName: <CLUSTER_NAME>
    site: <DATADOG_SITE>
    credentials:
      apiSecret:
        secretName: datadog-secret
        keyName: api-key

  override:
    nodeAgent:
      securityContext:
        runAsUser:  <USER_ID>
        supplementalGroups:
          - <GROUP_ID>

kubectl apply -f datadog-agent.yaml

datadog:
  apiKeyExistingSecret: datadog-secret
  clusterName: <CLUSTER_NAME>
  site: <DATADOG_SITE>
  securityContext:
    runAsUser: <USER_ID>
    supplementalGroups:
      - <GROUP_ID>

helm install datadog-agent -f datadog-values.yaml datadog/datadog

Registros de contenedores

Datadog publica imágenes de contenedor en el Datadog Container Registry, Google Artifact Registry (GAR), Amazon ECR, Azure ACR y Docker Hub:

Por defecto, el Datadog Agent Helm chart determina el registro de imágenes del Datadog Agent a partir de su sitio de Datadog, tipo de clúster y registryMigrationMode. Dependiendo de estos valores y exclusiones de entorno, las imágenes del Datadog Agent pueden ser extraídas del Datadog Container Registry (registry.datadoghq.com) o de un registro específico del sitio. El Datadog Operator chart se incluye como dependencia del Datadog Agent Helm chart por defecto. A partir de la versión 2.19.0 del Datadog Operator chart, cuando instale el Operator a través de esa dependencia, el registryMigrationMode del Datadog Agent Helm chart se aplica a las imágenes del Datadog Agent gestionadas por el Operator. El Datadog Operator chart en sí no define registryMigrationMode; la imagen del pod del Operator se controla por separado mediante el valor image.repository del Datadog Operator chart.

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    clusterName: <CLUSTER_NAME>
    registry: public.ecr.aws/datadog
    site: <DATADOG_SITE>
    credentials:
      apiSecret:
        secretName: datadog-secret
        keyName: api-key

registry: public.ecr.aws/datadog
datadog:
  apiKeyExistingSecret: datadog-secret
  site: <DATADOG_SITE>

Para más información, consulta Cambiando tu registro de contenedores.

Desinstalar

kubectl delete datadogagent datadog
helm delete datadog-operator

helm uninstall datadog-agent

Próximos pasos

Monitorea tu infraestructura en Datadog

Utiliza la página de Contenedores para tener visibilidad de tu infraestructura de contenedores, con métricas de recursos y búsqueda por facetas. Para obtener información sobre cómo usar la página de [Containers], consulta Containers View.

Utiliza la página de Container Images para obtener información sobre cada imagen utilizada en tu entorno. Esta página también muestra las vulnerabilidades encontradas en las imágenes de contenedor de Cloud Security. Para obtener información sobre cómo usar la página de [Container Images], consulta Container Images View.

La sección de Kubernetes presenta una visión general de todos tus recursos de Kubernetes. Orchestrator Explorer te permite monitorear el estado de los pods, despliegues y otros conceptos de Kubernetes en un espacio de nombres o zona de disponibilidad específica, ver las especificaciones de recursos para los pods fallidos dentro de un despliegue, correlacionar la actividad de los nodos con los registros relacionados, y más. La página de Resource Utilization proporciona información sobre cómo tus cargas de trabajo de Kubernetes utilizan tus recursos de cómputo en toda tu infraestructura. Para obtener información sobre cómo usar estas páginas, consulta Orchestrator Explorer y Kubernetes Resource Utilization.

Habilitar funciones

Lectura adicional

Más enlaces, artículos y documentación útiles:

Configure aún más el Datadog Agent en KubernetesDOCUMENTACIÓN Datadog Helm chart – Todas las opciones de configuraciónCÓDIGO FUENTE Actualizando Datadog HelmCÓDIGO FUENTE