Esta página explica cómo instalar y configurar integraciones para tu infraestructura de Docker utilizando una función de Datadog conocida como Autodiscovery. Autodiscovery te permite utilizar variables como %%host%% para rellenar dinámicamente tu configuración.

Para una explicación detallada de cómo funciona Autodiscovery, consulta Empezando con contenedores: Autodiscovery. Para opciones avanzadas de Autodiscovery, como excluir ciertos contenedores de Autodiscovery o tolerar pods no preparados, consulta Gestión de detección de contenedores.

Si utilizas Kubernetes, consulta Kubernetes e integraciones.

Configurar tu integración

Algunas integraciones requieren pasos de configuración, como la creación de un token de acceso o la concesión de permisos de lectura al Datadog Agent. Sigue las instrucciones de la sección Configuración de la documentación de integraciones.

Integraciones de la comunidad

Para utilizar una integración que no esté empaquetada con el Datadog Agent, debes crear una imagen personalizada que contenga la integración deseada. Consulta Uso de integraciones de la comunidad para obtener instrucciones.

Configuración

Algunas integraciones de uso común vienen con la configuración por defecto para Autodiscovery. Ve configuración automática de Autodiscovery para obtener más detalles, incluyendo una lista de integraciones configuradas automáticamente y sus correspondientes archivos de configuración por defecto. Si tu integración está en esta lista y la configuración por defecto es suficiente para tu caso de uso, no se requiere ninguna acción adicional.

O:

1. Elige un método de configuración (etiquetas de Docker, un archivo local o un almacén de clave-valor) que se adapte a tu caso de uso.
2. Consulta el formato de plantilla para el método elegido. Cada formato contiene parámetros, como <CONTAINER_IMAGE>.
3. Proporciona valores para estos parámetros.

LABEL "com.datadoghq.ad.checks"='{"<INTEGRATION_NAME>": {"instances": [<INSTANCE_CONFIG>], "logs": [<LOGS_CONFIG>]}}'

LABEL "com.datadoghq.ad.check_names"='[<INTEGRATION_NAME>]'
LABEL "com.datadoghq.ad.init_configs"='[<INIT_CONFIG>]'
LABEL "com.datadoghq.ad.instances"='[<INSTANCE_CONFIG>]'
LABEL "com.datadoghq.ad.logs"='[<LOGS_CONFIG>]'

labels:
  com.datadoghq.ad.checks: '{"<INTEGRATION_NAME>": {"instances": [<INSTANCE_CONFIG>], "logs": [<LOGS_CONFIG>]}}'

labels:
  com.datadoghq.ad.check_names: '[<INTEGRATION_NAME>]'
  com.datadoghq.ad.init_configs: '[<INIT_CONFIG>]'
  com.datadoghq.ad.instances: '[<INSTANCE_CONFIG>]'
  com.datadoghq.ad.logs: '[<LOGS_CONFIG>]'

docker run -l com.datadoghq.ad.checks="{\"<INTEGRATION_NAME>\": {\"instances\": [<INSTANCE_CONFIG>], \"logs\": [<LOGS_CONFIG>]}}"

docker run -l com.datadoghq.ad.check_names='[<INTEGRATION_NAME>]' -l com.datadoghq.ad.init_configs='[<INIT_CONFIG>]' -l com.datadoghq.ad.instances='[<INSTANCE_CONFIG>]' -l com.datadoghq.ad.logs='[<LOGS_CONFIG>]'

docker run -l "com.datadoghq.ad.checks="{\"apache\": {\"instances\": [{\"apache_status_url\":\"http://%%host%%/server-status?auto2\"}]}}"

version: "1.0"
services:
...
  project:
    image: '<IMAGE_NAME>'
    labels:
      com.datadoghq.ad.checks: '{"<INTEGRATION_NAME>": {"instances": [<INSTANCE_CONFIG>], "logs": [<LOGS_CONFIG>]}}'

version: "1.0"
services:
...
  project:
    image: '<IMAGE_NAME>'
    labels:
      com.datadoghq.ad.check_names: '[<INTEGRATION_NAME>]'
      com.datadoghq.ad.init_configs: '[<INIT_CONFIG>]'
      com.datadoghq.ad.instances: '[<INSTANCE_CONFIG>]'
      com.datadoghq.ad.logs: '[<LOGS_CONFIG>]'

config_providers:
  - name: etcd
    polling: true
    template_dir: /datadog/check_configs
    template_url: '<KV_STORE_IP>:<KV_STORE_PORT>'
    username:
    password:

  - name: consul
    polling: true
    template_dir: datadog/check_configs
    template_url: '<KV_STORE_IP>:<KV_STORE_PORT>'
    ca_file:
    ca_path:
    cert_file:
    key_file:
    username:
    password:
    token:

  - name: zookeeper
    polling: true
    template_dir: /datadog/check_configs
    template_url: '<KV_STORE_IP>:<KV_STORE_PORT>'
    username:
    password:

/datadog/
  check_configs/
    <CONTAINER_IMAGE>/
      - check_names: ["<INTEGRATION_NAME>"]
      - init_configs: ["<INIT_CONFIG>"]
      - instances: ["<INSTANCES_CONFIG>"]
      - logs: ["<LOGS_CONFIG>"]
    ...

Valores de parámetros

Proporciona los siguientes valores de parámetros:

<INTEGRATION_NAME>

nombre de tu integración de Datadog, como etcd o redisdb.

<CONTAINER_IMAGE>

un identificador para comparar con la imagen del contenedor.

Por ejemplo: si proporcionas redis como identificador del contenedor, tu plantilla de Autodiscovery se aplicará a todos los contenedores cuyos nombres de imagen coincidan con redis. Si tienes un contenedor ejecutando foo/redis:latest y bar/redis:v2, tu plantilla de Autodiscovery se aplica a ambos contenedores.

El parámetro ad_identifiers toma una lista, por lo que puedes suministrar varios identificadores de contenedor. También puedes utilizar identificadores personalizados. Consulta Identificadores personalizados de Autodiscovery.

<INIT_CONFIG>

parámetros de configuración que figuran en init_config, en el archivo <INTEGRATION_NAME>.d/conf.yaml.example de tu integración. La sección init_config suele estar vacía.

<INSTANCES_CONFIG>

parámetros de configuración que figuran en instances, en el archivo <INTEGRATION_NAME>.d/conf.yaml.example de tu integración.

<LOGS_CONFIG>

parámetros de configuración que figuran en logs, en el archivo <INTEGRATION_NAME>.d/conf.yaml.example de tu integración.

Ejemplos

Integración de Redis

Redis es una de las tecnologías para las que está disponible la configuración automática de Autodiscovery. Los siguientes ejemplos demuestran la sustitución de esta configuración básica con una configuración personalizada que proporciona un parámetro password.

Guarda tu contraseña como una variable de entorno llamada REDIS_PASSWORD; entonces:

labels:
  com.datadoghq.ad.checks: '{"redisdb": {"instances": [{"host": "%%host%%","port":"6379","password":"%%env_REDIS_PASSWORD%%"}], "logs": [{"type": "file", "path": "/var/log/redis_6379.log", "source": "redis", "service": "redis_service"}]}}'

labels:
  com.datadoghq.ad.check_names: '["redisdb"]'
  com.datadoghq.ad.init_configs: '[{}]'
  com.datadoghq.ad.instances: '[{"host": "%%host%%","port":"6379","password":"%%env_REDIS_PASSWORD%%"}]'
  com.datadoghq.ad.logs: '[{"type": "file", "path": "/var/log/redis_6379.log", "source": "redis", "service": "redis_service"}]'

etcdctl mkdir /datadog/check_configs/redis
etcdctl set /datadog/check_configs/redis/check_names '["redisdb"]'
etcdctl set /datadog/check_configs/redis/init_configs '[{}]'
etcdctl set /datadog/check_configs/redis/instances '[{"host": "%%host%%","port":"6379","password":"%%env_REDIS_PASSWORD%%"}]'

Todos estos ejemplos utilizan Variables de plantilla de Autodiscovery:

• %%host%% se rellena dinámicamente con la dirección IP del contenedor.
• %%env_REDIS_PASSWORD%% hace referencia a una variable de entorno denominada REDIS_PASSWORD vista por el proceso del Agent.

Para más ejemplos, incluyendo cómo configurar multiple checks para múltiples conjuntos de contenedores, ve Autodiscovery: escenarios y ejemplos.