Información general

Datadog Agent recopila métricas de Druid mediante DogStatsD. DogStatsD recopila métricas sobre consultas, ingesta y datos de coordinación de Druid. Para más información, consulta la documentación de métricas de Druid.

Además de recopilar métricas, el Agent también envía un check de servicio relacionado con el estado de Druid.

Configuración

Requisito previo

Druid v0.16 o posterior es necesario para que esta integración funcione correctamente.

Instalación

Los dos pasos siguientes son necesarios para que la integración de Druid funcione correctamente. Antes de empezar, debes instalar el Datadog Agent.

Paso 1: Configurar Druid para recopilar métricas de estado y checks de servicio

Configura el check de Druid incluido en el paquete del Datadog Agent para recopilar métricas de estado y checks de servicio.

1. Edita el archivo druid.d/conf.yaml, en la carpeta conf.d/ en la raíz del directorio de configuración de tu Agent para comenzar a recopilar tus checks de servicio de druid. Consulta el druid.d/conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles.
2. Reinicia el Agent.

Paso 2: Conectar Druid a DogStatsD (incluido en el Datadog Agent) utilizando la extensión statsd-emitter para recopilar métricas

Paso para configurar la extensión statsd-emitter para recopilar la mayoría de las métricas de Druid.

1. Instala la extensión de Druid statsd-emitter.

   $ java \
     -cp "lib/*" \
     -Ddruid.extensions.directory="./extensions" \
     -Ddruid.extensions.hadoopDependenciesDir="hadoop-dependencies" \
     org.apache.druid.cli.Main tools pull-deps \
     --no-default-hadoop \
     -c "org.apache.druid.extensions.contrib:statsd-emitter:0.15.0-incubating"
   

   Puedes encontrar más información sobre este paso en la guía oficial para cargar extensiones de Druid

2. Actualiza las propiedades java de Druid añadiendo las siguientes configuraciones:

   # Add `statsd-emitter` to the extensions list to be loaded
   druid.extensions.loadList=[..., "statsd-emitter"]
   
   # By default druid emission period is 1 minute (PT1M).
   # We recommend using 15 seconds instead:
   druid.monitoring.emissionPeriod=PT15S
   
   # Use `statsd-emitter` extension as metric emitter
   druid.emitter=statsd
   
   # Configure `statsd-emitter` endpoint
   druid.emitter.statsd.hostname=127.0.0.1
   druid.emitter.statsd.port:8125
   
   # Configure `statsd-emitter` to use dogstatsd format. Must be set to true, otherwise tags are not reported correctly to Datadog.
   druid.emitter.statsd.dogstatsd=true
   druid.emitter.statsd.dogstatsdServiceAsTag=true
   

3. Reinicia Druid para empezar a enviar tus métricas de Druid al Agent a través de DogStatsD.

Checks de servicio de integraciones

Utiliza la configuración predeterminada de tu archivo druid.d/conf.yaml para activar la recopilación de checks de servicio de Druid. Consulta el [druid.d/conf.yaml] de ejemplo(https://github.com/DataDog/integrations-core/blob/master/druid/datadog_checks/druid/data/conf.yaml.example) para conocer todas las opciones de configuración disponibles.

Recopilación de logs

Disponible para las versiones 6.0 o posteriores del Agent

1. La recopilación de logs está desactivada por defecto en el Datadog Agent, actívala en tu archivo datadog.yaml:

   logs_enabled: true
   

2. Deselecciona y edita este bloque de configuración en la parte inferior de tu druid.d/conf.yaml:

   logs:
     - type: file
       path: '<PATH_TO_DRUID_DIR>/var/sv/*.log'
       source: druid
       service: '<SERVICE_NAME>'
       log_processing_rules:
         - type: multi_line
           name: new_log_start_with_date
           pattern: \d{4}\-\d{2}\-\d{2}
   

   Cambia los valores de los parámetros path y service y configúralos para tu entorno.

3. Reinicia el Agent.

Validación

Ejecuta el subcomando de estado del Agent y busca druid en la sección Checks.

Datos recopilados

Métricas

Eventos

El check de Druid no incluye eventos.

Checks de servicio

druid.service.can_connect

Devuelve CRITICAL si el check no puede conectarse al servicio de Druid. En caso contrario, devuelve OK.

Estados: ok, critical

druid.service.health

Devuelve CRITICAL si el servicio de Druid no está en buen estado. En caso contrario, devuelve OK.

Estados: ok, critical

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el soporte de Datadog.