GUIDE TECHNIQUE · DATADOG
Créer un moniteur métrique Datadog
Créer un moniteur métrique Datadog sur un jeu de données instrumenté, définir une requête explicite, choisir des seuils justifiés et vérifier le cycle alerte/retour à la normale et la notification en recette.
01 · CADRAGE
Ce que vous allez mettre en place
Créer un moniteur métrique Datadog sur un jeu de données instrumenté, définir une requête explicite, choisir des seuils justifiés et vérifier le cycle alerte/retour à la normale et la notification en recette.
Pour qui : Administrateurs, équipes observabilité et exploitation
Datadog Metric Monitor et métrique system.cpu.user émise par l'Agent. Exemple de recette avec seuils illustratifs ; interface et politiques de notification selon compte.
Vérifiez la compatibilité avec votre environnement réel. Les versions ne sont jamais présumées identiques d’un tenant à l’autre.
02 · AVANT DE COMMENCER
Prérequis et points de contrôle
- Agent Datadog envoyant system.cpu.user avec les tags requis.
- Hôte de recette identifié, droits de création/édition de monitor.
- Canal de notification de recette autorisé, sans vraie astreinte client.
- Baseline sur la métrique pour choisir des seuils pertinents.
03 · VUE D’ENSEMBLE
Comprendre l’architecture et les flux
Illustration éditoriale validée ADN Consulting, distincte d’une capture de console.
Source : ADN Consulting04 · TUTORIEL
Procédure complète, étape par étape
Chaque étape explique l’action, sa raison, le contrôle attendu et les erreurs habituelles. Adaptez les exemples aux paramètres de votre propre environnement.
ÉTAPE 1 / 5
Vérifier la métrique
Une alerte sur une métrique absente ou mal taggée restera silencieuse ou en No Data.
- Dans Metrics Explorer, vérifier system.cpu.user et son unité (fraction entre 0 et 1 selon la métrique, et non nécessairement un pourcentage affiché).
- Vérifier l'existence du tag env:prod dans le jeu de test ou choisir un tag réel approprié.
- Choisir un host et établir une baseline de charge.
avg:system.cpu.user{env:prod} by {host}
# Requête graphique illustrative ; elle suppose que env:prod est présent.À vérifier : Séries et tags sont visibles ; l'unité de la métrique est connue.
Point de vigilance ADN : Ne jamais choisir 80 comme seuil si l'unité attendue est une fraction 0..1.
ÉTAPE 2 / 5
Créer le moniteur
La requête du moniteur ajoute une fenêtre temporelle et un comparateur.
- Ouvrir Monitors > New Monitor > Metric.
- Choisir threshold alert, sélection de la métrique et group by host.
- Configurer la moyenne des cinq dernières minutes dans le moteur de monitor.
avg(last_5m):avg:system.cpu.user{env:prod} by {host} > 0.90
# Exemple de requête de monitor ; adapter tags et agrégations à la télémétrie réelle.À vérifier : La requête du moniteur est valide et ses groupes correspondent aux hôtes attendus.
Point de vigilance ADN : Les versions de l'éditeur UI et API peuvent afficher le même monitor sous des formes différentes.
ÉTAPE 3 / 5
Configurer le seuil
Les valeurs doivent être proportionnelles à l'unité et justifiées par les mesures antérieures.
- Exemple de recette pour un signal 0..1 : warning 0.80, critical 0.90.
- Comparer avec la plage nominale du service ; fixer les options de récupération et de données manquantes.
- Évaluer avec preview, sans activer de notifications de production.
warning: 0.80
critical: 0.90
critical_recovery: 0.70
# Valeurs d'exemple pour une métrique exprimée entre 0 et 1, à adapter.À vérifier : Seuils et fenêtre 5 min cohérents avec la métrique et la baseline.
Point de vigilance ADN : No Data, new group delay et require full window ont des effets sur l'évaluation ; les paramétrer selon la fréquence du signal.
ÉTAPE 4 / 5
Rédiger le message
Le message doit contenir un contexte exploitable sans information sensible.
- Donner un titre explicite au monitor, son propriétaire RUN et l'environnement.
- Inclure l'hôte, la valeur/condition, un lien d'investigation et une action réalisable.
- Pointer vers le destinataire de recette, après validation de la convention de notification.
CPU utilisateur élevé sur {{host.name}}
Consulter les métriques de l'hôte et la charge applicative.
@canal-de-recette
# Adapter la variable et le destinataire selon l'intégration configurée.À vérifier : Un message de notification compréhensible est associé à une équipe de recette.
Point de vigilance ADN : La présence d'un @canal fictif n'envoie rien : sélectionner la destination autorisée du compte.
ÉTAPE 5 / 5
Tester le routage
La création du monitor n'est pas sa validation opérationnelle.
- Utiliser preview puis une simulation ou charge contrôlée sur l'hôte de recette.
- Vérifier warning/critical, réception, réarmement et résolution après retour à la normale.
- Vérifier le comportement des données absentes et noter les limites du monitor.
# Contrôle : signal >0.80 puis >0.90 sur la fenêtre choisie,
# notification à l'équipe de recette, puis retour sous 0.70.À vérifier : Le cycle complet alerte → message → retour à la normale est constaté en recette.
Point de vigilance ADN : Ne surchargez pas un serveur de production pour démontrer un monitor.
05 · RECETTE
Comment vérifier que tout fonctionne ?
Métrique réellement ingérée avec les tags host et env.
Requête de monitor, unité et fenêtre d'évaluation contrôlées.
Seuils warning/critical justifiés par une baseline.
Notification effectivement reçue sur un canal de recette.
Résolution et No Data vérifiés avec l'équipe concernée.
06 · DIAGNOSTIC
Problèmes fréquents et résolution
No Data inattendu
Cause probable : Métrique absente, tag incorrect ou fenêtre trop courte
Que faire : Vérifier Metrics Explorer, puis evaluation delay et full window.
Alerte jamais déclenchée
Cause probable : Seuil incompatible avec l'unité
Que faire : Vérifier 0..1 versus 0..100 et la requête réellement évaluée.
Multiples alertes
Cause probable : Group by host et mode multi-alert
Que faire : Confirmer le regroupement et le routage.
Notification absente
Cause probable : Destinataire ou configuration des messages non valide
Que faire : Vérifier l'intégration et les états notifiables.
Le conseil de l’expert ADN
Avant de généraliser cette configuration, validez-la sur un périmètre représentatif, documentez les critères de réussite et conservez une procédure de retour arrière. Une instrumentation utile se juge sur les données effectivement exploitables, pas sur la seule installation de l’outil.
07 · QUESTIONS PRATIQUES
Questions fréquentes
Pourquoi 0.90 et non 90 ?
Cet exemple traite une mesure de fraction du temps CPU ; les unités exactes doivent être vérifiées dans Metrics Explorer.
No Data doit-il systématiquement alerter ?
Non. Choisir la politique selon la fréquence de collecte et le risque métier ; voir les options officielles de monitor.