Descripción general

El Controlador de Admisión de Datadog es un componente del Agente de Clúster de Datadog. El principal beneficio del Controlador de Admisión es simplificar la configuración de su Pod de aplicación. Para ello, tiene dos funcionalidades principales:

• Inyectar variables de entorno (DD_AGENT_HOST, DD_TRACE_AGENT_URL, DD_ENTITY_ID y DD_EXTERNAL_ENV) para configurar DogStatsD y los SDK de Datadog en los contenedores de la aplicación del usuario.
• Inyectar etiquetas estándar de Datadog (env, service, version) desde las etiquetas de la aplicación en las variables de entorno del contenedor.

El Controlador de Admisión de Datadog es de tipo MutatingAdmissionWebhook. Para más detalles sobre los controladores de admisión, consulte la guía de Kubernetes sobre controladores de admisión.

Requisitos

• Agente de Clúster de Datadog v7.40+

Configuración

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  #(...)
  features:
    admissionController:
      enabled: true
      mutateUnlabelled: false

#(...)
clusterAgent:
  #(...)
  ## @param admissionController - object - required
  ## Enable the admissionController to automatically inject APM and
  ## DogStatsD config and standard tags (env, service, version) into
  ## your pods
  #
  admissionController:
    enabled: true

    ## @param mutateUnlabelled - boolean - optional
    ## Enable injecting config without having the pod label:
    ## admission.datadoghq.com/enabled="true"
    #
    mutateUnlabelled: false

- apiGroups:
  - admissionregistration.k8s.io
  resources:
  - mutatingwebhookconfigurations
  verbs: ["get", "list", "watch", "update", "create"]
- apiGroups: [""]
  resources: ["secrets"]
  verbs: ["get", "list", "watch", "update", "create"]
- apiGroups: ["batch"]
  resources: ["jobs", "cronjobs"]
  verbs: ["get"]
- apiGroups: ["apps"]
  resources: ["statefulsets", "replicasets", "deployments"]
  verbs: ["get"]

apiVersion: v1
kind: Service
metadata:
  name: datadog-cluster-agent-admission-controller
  labels:
    app: "datadog"
    app.kubernetes.io/name: "datadog"
spec:
  selector:
    app: datadog-cluster-agent
  ports:
  - port: 443
    targetPort: 8000

- name: DD_ADMISSION_CONTROLLER_ENABLED
  value: "true"
- name: DD_ADMISSION_CONTROLLER_SERVICE_NAME
  value: "datadog-cluster-agent-admission-controller"

# Uncomment this to configure Datadog SDKs automatically (see below)
# - name: DD_ADMISSION_CONTROLLER_MUTATE_UNLABELLED
#   value: "true"

Inyección de biblioteca de instrumentación APM

Puede configurar el Agente de Clúster (versión 7.39 y superior) para inyectar bibliotecas de instrumentación utilizando Instrumentación de Paso Único. Lee Instrumentación APM de Paso Único para más información.

Si no desea utilizar la Instrumentación de Paso Único, se puede usar el Controlador de Admisión de Datadog para inyectar SDKs de Datadog directamente como una alternativa manual a nivel de pod. Lee Inyección de SDK Local para más información.

Inyección de variables de entorno APM y DogStatsD

Para configurar clientes de DogStatsD u otras bibliotecas APM que no soportan inyección de bibliotecas, inyecte las variables de entorno DD_AGENT_HOST y DD_ENTITY_ID haciendo una de las siguientes acciones:

• Agregue la etiqueta admission.datadoghq.com/enabled: "true" a su Pod.
• Configure el controlador de admisión del Agente de Clúster estableciendo mutateUnlabelled (o DD_ADMISSION_CONTROLLER_MUTATE_UNLABELLED, dependiendo de su método de configuración) a true.

Agregar una configuración de Agente mutateUnlabelled: true en el chart de Helm hace que el Agente de Clúster intente interceptar cada Pod sin etiquetar.

Para evitar que los Pods reciban variables de entorno, agregue la etiqueta admission.datadoghq.com/enabled: "false". Esto funciona incluso si establece mutateUnlabelled: true.

Si mutateUnlabelled está establecido en false, la etiqueta del Pod debe establecerse en admission.datadoghq.com/enabled: "true".

Opciones posibles:

Orden de prioridad

El Controlador de Admisión de Datadog no inyecta las variables de entorno DD_VERSION, DD_ENV o DD_SERVICE si ya existen.

Cuando estas variables de entorno no están configuradas, el Controlador de Admisión utiliza el valor de las etiquetas estándar en el siguiente orden (de mayor a menor):

• Etiquetas en el Pod
• Etiquetas en el ownerReference (ReplicaSets, DaemonSets, Deployments, etc.)

Configurar el modo de comunicación de APM y DogStatsD

A partir de la versión 1.20.0 del Agente de Clúster de Datadog, el Controlador de Admisión de Datadog se puede configurar para inyectar diferentes modos de comunicación entre la aplicación y el agente de Datadog.

Esta función se puede configurar estableciendo admission_controller.inject_config.mode o definiendo un modo específico del Pod utilizando la etiqueta del Pod admission.datadoghq.com/config.mode.

A partir de la versión 3.22.0 del gráfico de Helm y la versión 1.1.0 del Operador de Datadog, el modo de comunicación se establece automáticamente en socket si se habilita el socket de APM o el socket de DSD.

Opciones posibles:

Nota: El modo específico del pod tiene prioridad sobre el modo global definido a nivel del Controlador de Admisión.

Solución de Problemas

Vea Solución de Problemas del Controlador de Admisión.

Lectura Adicional

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

Solución de problemas del Agente de Clúster de DatadogDOCUMENTACIÓN Solución de problemas del Controlador de AdmisiónDOCUMENTACIÓN Utilizar la inyección de bibliotecas para auto-instrumentar el trazado de aplicaciones de Kubernetes con Datadog APMBLOG Brindar observabilidad de alto rendimiento a entornos de Kubernetes seguros con el controlador CSI de DatadogBLOG Instrumentar su aplicación utilizando el Operador de Datadog y el Controlador de AdmisiónCENTRO DE ARQUITECTURA Deshabilitar el Controlador de Admisión de Datadog con el Agente de ClústerDOCUMENTACIÓN