Esta página cubre cómo instalar y configurar integraciones para su infraestructura Docker utilizando la función de Datadog conocida como Autodiscovery. Autodiscovery le permite usar variables como %%host%% para poblar dinámicamente la configuración de sus ajustes.

Para una explicación detallada de cómo funciona Autodiscovery, consulte Getting Started with Containers: Autodiscovery. Para opciones avanzadas de Autodiscovery, como excluir ciertos contenedores de Autodiscovery o tolerar pods no listos, consulte Container Discovery Management.

Si utiliza Kubernetes, consulte Kubernetes and Integrations.

Configure su integración

Algunas integraciones requieren pasos de configuración, como crear un token de acceso o otorgar permiso de lectura al Datadog Agent. Siga las instrucciones en la sección Configuración de la documentación de su integración.

Integraciones comunitarias

Para utilizar una integración que no está empaquetada con el Datadog Agent, construya una imagen personalizada que contenga la integración deseada. Consulte Use Community Integrations para obtener instrucciones.

Configuración

Algunas integraciones de uso común vienen con una configuración predeterminada para Autodiscovery. Consulte Autodiscovery auto-configuration para obtener detalles, incluyendo una lista de integraciones autoconfiguradas y sus correspondientes archivos de configuración predeterminados. Si su integración está en esta lista y la configuración predeterminada es suficiente para su caso de uso, no se requiere ninguna acción adicional.

De lo contrario:

1. Elija un método de configuración (etiquetas de Docker, un archivo local o un almacén de clave-valor) que se adapte a su caso de uso.
2. Consulte el formato de plantilla para el método que eligió. Cada formato contiene marcadores de posición, como <CONTAINER_IMAGE>.
3. Proporcione valores para estos marcadores de posición.

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 marcador de posición

Proporcione valores de marcador de posición de la siguiente manera:

<INTEGRATION_NAME>

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

<CONTAINER_IMAGE>

Un identificador para hacer coincidir con la imagen del contenedor.

Por ejemplo: si proporciona redis como un identificador de contenedor, su plantilla de Autodiscovery se aplica a todos los contenedores con nombres de imagen que coincidan con redis. Si tiene un contenedor ejecutándose foo/redis:latest y bar/redis:v2, su plantilla de Autodiscovery se aplica a ambos contenedores.

El parámetro ad_identifiers toma una lista, por lo que puede proporcionar múltiples identificadores de contenedor. También puede usar identificadores personalizados. Consulte Custom Autodiscovery Identifiers.

<INIT_CONFIG>

Los parámetros de configuración enumerados bajo init_config en el archivo <INTEGRATION_NAME>.d/conf.yaml.example de su integración. La sección init_config suele estar vacía.

<INSTANCES_CONFIG>

Los parámetros de configuración enumerados bajo instances en el archivo <INTEGRATION_NAME>.d/conf.yaml.example de su integración.

<LOGS_CONFIG>

Los parámetros de configuración enumerados bajo logs en el archivo <INTEGRATION_NAME>.d/conf.yaml.example de su integración.

Ejemplos

Integración de Redis

Redis es una de las tecnologías para las cuales está disponible Autodiscovery auto-configuration. Los siguientes ejemplos demuestran cómo anular esta configuración básica con una configuración personalizada que proporciona un parámetro password.

Almacene su contraseña como una variable de entorno llamada REDIS_PASSWORD; luego:

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 Autodiscovery template variables:

• %%host%% se completa dinámicamente con la IP del contenedor.
• %%env_REDIS_PASSWORD%% Hace referencia a una variable de entorno llamada REDIS_PASSWORD tal como la ve el proceso del Datadog Agent.

Consulte Autodiscovery: Scenarios & Examples para más ejemplos, incluyendo cómo configurar múltiples verificaciones para múltiples conjuntos de contenedores.