Información general

El Datadog Agent recopila métricas de Druid utilizando DogStatsD. DogStatsD recopila métricas sobre consultas, ingesta y datos de coordinación de Druid. Para obtener 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 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, que se encuentra en la carpeta conf.d/ en la raíz del directorio de configuración de tu Agent, para empezar a recopilar los datos de rendimiento de tus checks de servicio de Druid. Para conocer todas las opciones de configuración disponibles, consulta el druid.d/conf.yaml de ejemplo.
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 en el que se configura la extensión statsd-emitter para recopilar la mayor parte de las métricas de Druid.

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

   $ 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 la carga de 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 tus checks de servicio de Druid. Consulta el druid.d/conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles.

Recopilación de logs

Disponible para la versión 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

Solucionar problemas

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