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.
Configurez le check Druid inclus avec le package de l’Agent Datadog pour recueillir ses métriques de santé et ses checks de service.
- 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. - 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 :
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).
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
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
La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml :
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.
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
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
