Présentation
Recueillez des métriques d’etcd pour :
- Surveiller la santé de votre cluster etcd
- Savoir si des configurations de host sont potentiellement désynchronisées
- Corréler les performances d’etcd avec le reste de vos applications
Configuration
Installation
Le check Etcd est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur vos instances etcd.
Configuration
Host
Pour configurer ce check lorsque l’Agent est exécuté sur un host :
Collecte de métriques
- Modifiez le fichier
etcd.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance Etcd. Consultez le fichier d’exemple etcd.d/conf.yaml pour découvrir toutes les options de configuration disponibles. - Redémarrez l’Agent.
Collecte de logs
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 etcd.d/conf.yaml, puis modifiez-le :
logs:
- type: file
path: "<LOG_FILE_PATH>"
source: etcd
service: "<SERVICE_NAME>"
Modifiez les valeurs des paramètres path et service en fonction de votre environnement. Consultez le fichier d’exemple etcd.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
Redémarrez l’Agent.
Environnement conteneurisé
Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer les paramètres ci-dessous à un environnement conteneurisé.
Collecte de métriques
| Paramètre | Valeur |
|---|
<NOM_INTÉGRATION> | etcd |
<CONFIG_INIT> | vide ou {} |
<CONFIG_INSTANCE> | {"prometheus_url": "http://%%host%%:2379/metrics"} |
Collecte de logs
La collecte des logs est désactivée par défaut dans l’Agent Datadog. Pour l’activer, consultez la section Collecte de logs avec Kubernetes.
| Paramètre | Valeur |
|---|
<CONFIG_LOG> | {"source": "etcd", "service": "<NOM_SERVICE>"} |
Validation
Lancez la sous-commande status de l’Agent et cherchez etcd dans la section Checks.
Données collectées
Métriques
Le tag etcd_state:leader ou etcd_state:follower est appliqué aux métriques etcd, en fonction du statut du nœud. Vous pouvez donc facilement agréger des métriques selon le statut.
Événements
Le check etcd n’inclut aucun événement.
Checks de service
etcd.can_connect :
Renvoie CRITICAL si l’Agent ne parvient pas à recueillir des métriques à partir du endpoint de votre API etcd.
etcd.healthy :
Renvoie CRITICAL si le nœud d’un membre n’est pas sain. Renvoie ‘Unknown’ si l’Agent ne parvient pas à atteindre l’endpoint /health, ou si le statut de santé est manquant.
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
Pour aller plus loin
Pour mieux comprendre comment (ou pourquoi) intégrer Etcd à Datadog, lisez notre article de blog à ce sujet.
