Présentation

L’Agent Datadog recueille des métriques en provenance de Druid via DogStatsD. DogStatsD recueille des métriques sur les requêtes Druid ainsi que sur les données d’ingestion et de coordination. Pour en savoir plus, consultez la documentation relative aux métriques Druid.

En plus de recueillir des métriques, l’Agent envoie également un check de service relatif à la santé de Druid.

Configuration

Prérequis

La version 0.16 (ou ultérieure) de Druid est requise pour que cette intégration fonctionne correctement.

Installation

Les étapes décrites ci-dessous sont toutes les deux nécessaires pour faire fonctionner l’intégration Druid. Avant de commencer, vous devez installer l’Agent Datadog.

Étape 1 : configurez Druid de façon à recueillir ses métriques de santé et ses checks de service

Configurez le check Druid inclus avec le package de l’Agent Datadog pour recueillir ses métriques de santé et ses checks de service.

1. Modifiez le fichier druid.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos checks de service Druid. Consultez le fichier d’exemple druid.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
2. Redémarrez l’Agent.

Étape 2 : connectez Druid à DogStatsD (inclus avec l’Agent Datadog) à l’aide de l’extension statsd-emitter pour recueillir des métriques.

Pour configurer l’extension statsd-emitter et recueillir la plupart des métriques Druid :

1. Installez l’extension 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"
   

   Pour une explication plus détaillée de cette étape, consultez le guide officiel relatif au chargement d’extensions Druid (en anglais).

2. Mettez à jour les propriétés Java de Druid en ajoutant les configurations suivantes :

   # 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. Redémarrez Druid pour commencer à envoyer vos métriques Druid à l’Agent via DogStatsD.

Checks de service de l’intégration

Utilisez la configuration par défaut de votre fichier druid.d/conf.yaml pour activer la collecte de vos checks de service Druid. Consultez le fichier d’exemple druid.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

1. La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml :

   logs_enabled: true
   

2. Supprimez la mise en commentaire du bloc de configuration suivant en bas de votre fichier redisdb.d/conf.yaml, puis modifiez-le :

   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}
   

   Modifiez les valeurs des paramètres path et service et configurez-les pour votre environnement.

3. Redémarrez l’Agent.

Validation

Lancez la sous-commande status de l’Agent et cherchez druid dans la section Checks.

Données collectées

Métriques

Événements

Le check Druid n’inclut aucun événement.

Checks de service

druid.service.can_connect
Returns CRITICAL if the check cannot connect to Druid service. Returns OK otherwise.
Statuses: ok, critical

druid.service.health
Returns CRITICAL if Druid service is not healthy. Returns OK otherwise.
Statuses: ok, critical

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.