Identificadores de contenedor de Autodiscovery

Este documento explica cómo aplicar una plantilla de configuración de Autodiscovery a un contenedor específico. El parámetro ad_identifiers puede coincidir con un nombre de imagen del contenedor o con un identificador personalizado.

Nombre de la imagen del contenedor

Para aplicar la siguiente plantilla de configuración de Autodiscovery a un determinado contenedor, sustituye <AUTODISCOVERY_IDENTIFIER> por el nombre corto de la imagen de contenedor:

ad_identifiers:
  <AUTODISCOVERY_IDENTIFIER>

init_config:
  <INIT_CONFIG>

instances:
  <INSTANCES_CONFIG>

Ejemplo: la siguiente plantilla de configuración de Autodiscovery en Apache se aplica a una imagen de contenedor llamada httpd:

ad_identifiers:
  - httpd
init_config:
instances:
  - apache_status_url: http://%%host%%/server-status?auto
logs:
  source: apache
  service: webapp

Esto coincide con cualquier imagen de contenedor httpd en tu host. Si tienes un contenedor que ejecuta foo/httpd:latest y otro que ejecuta bar/httpd:v2, el Agent aplica la plantilla anterior a ambos contenedores.

Cuando se utilizan nombres cortos de imágenes como identificadores de contenedores de Autodiscovery, el Agent no puede distinguir entre imágenes con nombres idénticos procedentes de distintas fuentes o con diferentes etiquetas (tags).

Múltiples identificadores

Define múltiples nombres de imágenes añadiéndolos a la lista de ad_identifiers, por ejemplo:

ad_identifiers:
  - httpd
  - my-custom-httpd-image

Esto coincide con cualquier imagen de contenedor en tu host que coincida con httpd o my-custom-httpd-image.

Identificadores de contenedores de Autodiscovery personalizados

Si deseas aplicar diferentes plantillas de configuración a contenedores que ejecutan la misma imagen, utiliza identificadores personalizados de contenedor.

  1. Proporciona un identificador personalizado de contenedor a tu contenedor utilizando una etiqueta de Docker o una anotación de Kubernetes.

    Ejemplo: Aplica una etiqueta de Docker o una anotación de Kubernetes para identificar tu contenedor como foo:

      LABEL com.datadoghq.ad.check.id="foo"

      Nota: La etiqueta com.datadoghq.ad.check.id tiene prioridad sobre el nombre de la imagen.

      ad.datadoghq.com/<CONTAINER_NAME>.check.id: 'foo'

      Sustituye <CONTAINER_NAME> por el nombre de contenedor dentro del pod.

      Nota: Compatible con Datadog Agent v6.25+ y v7.25. La etiqueta ad.datadoghq.com/<CONTAINER_NAME>.check.id tiene prioridad sobre el nombre de la imagen.

    • Haz referencia a este valor personalizado en tu plantilla de configuración de Autodiscovery.

      Ejemplo: La siguiente plantilla de configuración de Apache Autodiscovery designa una imagen de contenedor con el nombre personalizado foo:

      ad_identifiers:
  - foo
init_config:
instances:
  - apache_status_url: http://%%host%%/server-status?auto
logs:
  source: apache
  service: webapp

    Referencias adicionales

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

    Configurar integraciones con Autodiscovery en KubernetesDOCUMENTACIÓN more more Configurar integraciones con Autodiscovery en DockerDOCUMENTACIÓN more more Determina qué contenedor debe incluirse en el Autodiscovery del AgentDOCUMENTACIÓN more more