Instala el Datadog Agent en Kubernetes

Documentos > Monitorización de contenedores > Kubernetes > Instala el Datadog Agent en Kubernetes

Información general

Esta página proporciona instrucciones para instalar el Datadog Agent en un entorno Kubernetes.

Para obtener documentación específica y ejemplos para las principales distribuciones de Kubernetes, incluido AWS Elastic Kubernetes Service (EKS), Azure Kubernetes Service (AKS), Google Kubernetes Engine (GKE), Red Hat OpenShift, Rancher y Oracle Container Engine para Kubernetes (OKE), consulta distribuciones de Kubernetes.

Para obtener documentación específica y ejemplos de monitorización del plano de control de Kubernetes, consulta Monitorización del plano de control de Kubernetes.

Versiones mínimas de Kubernetes y Datadog Agent

Algunas funciones relacionadas con versiones posteriores de Kubernetes requieren una versión mínima de Datadog Agent.

Versión de Kubernetes	Versión del Agent	Motivo
1.16.0+	7.19.0+	Obsolescencia de las métricas de Kubelet
1.21.0+	7.36.0+	Eliminación de recursos de Kubernetes
1.22.0+	7.37.0+	Admite el token de cuenta de servicio dinámico

Consulta también: Versiones mínimas de Kubernetes y Cluster Agent.

Instalación

Utiliza la página Instalación en Kubernetes de Datadog como guía para el proceso de instalación.

Selecciona el método de instalación
Elige uno de los siguientes métodos de instalación:
- Datadog Operador (recomendado): un operador de Kubernetes que puedes utilizar para desplegar el Datadog Agent en Kubernetes y OpenShift. Informa del estatus del despliegue, el estado y los errores en su estado de recurso personalizado, y limita el riesgo de configuración incorrecta gracias a las opciones de configuración más avanzadas.
- Helm
- Instalación manual. Consulta Instalación manual y configuración del Datadog Agent con un DaemonSet.

Requiere Helm y la CLI kubectl.

Instalar el Datadog Operator

Para instalar el Operador Datadog en tu espacio de nombres actual, ejecuta:

helm repo add datadog https://helm.datadoghq.com
helm install datadog-operator datadog/datadog-operator
kubectl create secret generic datadog-secret --from-literal api-key=<DATADOG_API_KEY>

Sustituye <DATADOG_API_KEY> por tu clave de API Datadog.

Configurar datadog-agent.yaml

Crea un archivo, datadog-agent.yaml, que contenga:

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

Sustituye <CLUSTER_NAME> por un nombre para tu clúster.
Sustituye <DATADOG_SITE> por tu sitio de Datadog. Tu sitio es . (Asegúrate de seleccionar el SITIO correcto a la derecha).

Despliega el Agent con el archivo de configuración anterior
Ejecuta lo siguiente:
```
kubectl apply -f datadog-agent.yaml
```

Requires Helm.

Add the Datadog Helm repository

Run:

helm repo add datadog https://helm.datadoghq.com
helm repo update
kubectl create secret generic datadog-secret --from-literal api-key=<DATADOG_API_KEY>

Replace <DATADOG_API_KEY> with your Datadog API key.

Configure datadog-values.yaml
Create a file, datadog-values.yaml, that contains:
```
datadog:
 apiKeyExistingSecret: datadog-secret
 site: <DATADOG_SITE>
```
- Replace <DATADOG_SITE> with your Datadog site. Your site is . (Ensure the correct SITE is selected on the right).
Deploy Agent with the above configuration file
Run:
```
helm install datadog-agent -f datadog-values.yaml datadog/datadog
```
For Windows, append --set targetSystem=windows to the helm install command.

Confirm Agent installation
Verify that Agent pods (tagged with app.kubernetes.io/component:agent) appear on the Containers page in Datadog. Agent pods are detected within a few minutes of deployment.

<CLUSTER_NAME> allows you to scope hosts and Cluster Checks. This unique name must be dot-separated tokens and abide by the following restrictions:

Must only contain lowercase letters, numbers, and hyphens
Must start with a letter
Must end with a number or a letter
Must be less than or equal to 80 characters

Unprivileged installation

To run an unprivileged installation, add the following to datadog-agent.yaml:

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
agent:
  config:
    securityContext:
      runAsUser: <USER_ID>
      supplementalGroups:
        - <GROUP_ID>

Replace <USER_ID> with the UID to run the Datadog Agent. Datadog recommends setting this value to 100 since Datadog Agent v7.48+.
Replace <GROUP_ID> with the group ID that owns the Docker or containerd socket.

Then, deploy the Agent:

kubectl apply -f datadog-agent.yaml

To run an unprivileged installation, add the following to your datadog-values.yaml file:

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

Replace <USER_ID> with the UID to run the Datadog Agent.
Replace <GROUP_ID> with the group ID that owns the Docker or containerd socket.

Then, deploy the Agent:

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

Container registries

Datadog publishes container images to Google Artifact Registry, Amazon ECR, Azure ACR, and Docker Hub:

Google Artifact Registry	Amazon ECR	Azure ACR	Docker Hub
gcr.io/datadoghq	public.ecr.aws/datadog	datadoghq.azurecr.io	docker.io/datadog

By default, the Agent image is pulled from Google Artifact Registry (gcr.io/datadoghq). If Artifact Registry is not accessible in your deployment region, use another registry.

If you are deploying the Agent in an AWS environment, Datadog recommend that you use Amazon ECR.

Docker Hub is subject to image pull rate limits. If you are not a Docker Hub customer, Datadog recommends that you update your Datadog Agent and Cluster Agent configuration to pull from Google Artifact Registry or Amazon ECR. For instructions, see Changing your container registry.

To use a different container registry, modify global.registry in datadog-agent.yaml.

For example, to use Amazon ECR:

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

To use a different container registry, modify registry in datadog-values.yaml.

For example, to use Amazon ECR:

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

For more information, see Changing your container registry.

Uninstall

kubectl delete datadogagent datadog
helm delete datadog-operator

This command deletes all Kubernetes resources created by installing Datadog Operator and deploying the Datadog Agent.

helm uninstall datadog-agent

Siguientes pasos

Monitoriza tu infraestructura en Datadog

Utiliza la página Contenedores para obtener visibilidad de tu infraestructura de contenedor, con métricas de recurso y búsqueda por facetas. Para obtener más información sobre cómo utilizar la página de Contenedores, consulta Vista de contenedores.

Utiliza la página Imágenes de contenedor para obtener información sobre cada imagen utilizada en tu entorno. Esta página también muestra las vulnerabilidades encontradas en tus imágenes de contenedor desde Cloud Security. Para obtener información sobre cómo utilizar la página Imágenes de contenedor, consulta la Vista de imágenes de contenedor.

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