Module 1 — Comprendre les métriques Dynatrace Managed : clés, dimensions, rétention

Comprendre les métriques de Dynatrace Managed : clés builtin:, dimensions, unités, gauge ou count, agrégation par défaut et rétention, avec exercice.
Module 1 — Comprendre les métriques Dynatrace Managed : clés, dimensions, rétention

Module 1 du parcours Formation aux métriques Dynatrace Managed : comprendre les métriques avant de les interroger, c’est-à-dire savoir lire une clé, ses dimensions, son unité, ses agrégations et sa durée de vie.

Parcours : Formation aux métriques Dynatrace Managed · Module 1/7 · Durée : ~35 min · Niveau : Débutant à intermédiaire

Objectifs :

  • Lire une clé de métrique et reconnaître son préfixe (builtin:, ext:, calc:)
  • Distinguer dimensions, unité et agrégations d’une métrique
  • Différencier les données de type gauge et count
  • Savoir quelle résolution et quelle rétention s’appliquent aux séries temporelles

Prérequis : un accès en lecture à un environnement Managed et un jeton d’API avec le scope metrics.read pour l’exercice.

Un graphique de CPU qui montre 40 % alors que l’équipe système voit 90 % sur la machine : ce genre d’écart fait perdre une heure en plein incident. Il vient presque toujours d’une métrique mal lue, une moyenne prise pour un maximum ou une série fusionnée sur plusieurs hôtes. Pour comprendre les métriques de Dynatrace Managed, il faut savoir ce que contient une clé et comment Dynatrace agrège ses points.

Ce module pose ces bases. Il vaut pour Dynatrace Managed et pour les métriques dites « classiques » de Dynatrace SaaS ; les métriques stockées dans Grail (clés dt.*, commande DQL timeseries) sont traitées dans le parcours Métriques Dynatrace SaaS.

Comprendre les métriques : anatomie d’une clé

Chaque métrique a une clé unique, en minuscules, avec des points pour la hiérarchie. Le préfixe indique son origine :

Préfixe Origine Exemple
builtin: Métriques fournies par OneAgent et la plateforme builtin:host.cpu.usage
ext: Extensions OneAgent ou ActiveGate (et métriques classiques de l’intégration AWS) selon l’extension
calc: Métriques calculées que vous créez module 7
uscm. / uacm. Métriques personnalisées USQL (sessions, actions utilisateur) selon votre définition
aucun préfixe fixe Métriques ingérées (protocole d’ingestion) cpu.temperature

Lisez la clé de gauche à droite : builtin:host.disk.avail se lit « métrique intégrée, famille hôte, sous-famille disque, espace disponible ». La liste complète figure dans la page Built-in metrics de la documentation Managed ; l’appel GET /api/v2/metrics donne celles réellement présentes dans votre environnement.

Le descripteur : dimensions, unité, agrégations

Chaque clé possède un descripteur, que l’API Metrics v2 renvoie. Voici l’exemple que donne la documentation pour l’espace disque disponible :

Descripteur JSON de la métrique builtin:host.disk.avail tel que le montre la documentation Dynatrace Managed : unité Byte, agrégations auto avg max min, agrégation par défaut avg, dimensions dt.entity.host et dt.entity.disk

Quatre champs méritent votre attention :

  • unit : ici des octets. Les temps de réponse de service sont en microsecondes, ce qui surprend souvent la première fois.
  • dimensionDefinitions : la découpe de la métrique. Une série existe par combinaison de valeurs, ici par hôte et par disque. La première dimension est une entité, ce qui permet de cibler la requête avec un entitySelector.
  • aggregationTypes : les agrégations autorisées (auto, avg, max, min, et selon la métrique count, sum, median, percentile, value).
  • defaultAggregation : celle qu’on obtient sans rien préciser, ici la moyenne.

Ce dernier point explique l’écart du début : sans agrégation explicite, Dynatrace applique l’agrégation par défaut. Une moyenne sur une minute lisse les pics qu’un max aurait montrés.

Gauge ou count : deux natures de données

Le protocole d’ingestion distingue deux formats de points :

  • gauge : une mesure à un instant (température, pourcentage de CPU, mémoire utilisée). Un point gauge peut porter un résumé min, max, sum, count.
  • count : un compteur envoyé sous forme de delta (count,delta=500). En métriques classiques, Dynatrace suffixe alors la clé par .count.

Dans les métriques intégrées, la même logique se lit dans les agrégations : builtin:service.requestCount.total n’accepte que auto et value, c’est un comptage ; builtin:host.cpu.usage accepte avg, max et min, c’est une jauge.

Résolution, rollups et rétention en Managed

Les métriques d’infrastructure sont mesurées toutes les 10 secondes et stockées en agrégats d’une minute (min, max, count, sum, moyenne). La finesse disponible dépend ensuite de l’âge de la donnée : Dynatrace Managed conserve les métriques 5 ans, mais en les regroupant par intervalles de plus en plus larges.

Extrait de la page Data retention periods de la documentation Managed : granularité de 1 minute jusqu'à 14 jours, 5 minutes jusqu'à 28 jours, 1 heure jusqu'à 400 jours, 1 jour jusqu'à 5 ans

Conséquence pratique : un pic de deux minutes survenu il y a deux mois ne se voit plus, il est dilué dans une moyenne horaire. Si une analyse post-incident a besoin de la minute, faites-la dans les 14 jours. Dans un cluster Managed, ces séries sont stockées dans le dépôt de métriques (Cassandra) et répliquées sur trois nœuds ; l’article sur l’architecture de Dynatrace Managed détaille ce stockage.

À la requête, le paramètre resolution de l’API règle le pas : par défaut 120 points sur la période, ou un pas explicite comme resolution=10m. La résolution la plus fine est la minute.

Exercice pratique

Réalisez-le sur un environnement de recette ou de démonstration Managed.

Étape 1 — Lister les métriques hôte de votre environnement

export DT_URL="https://{votre-domaine}/e/{id-environnement}"
curl -s "$DT_URL/api/v2/metrics?metricSelector=builtin:host.*&fields=displayName,unit,aggregationTypes" \
  -H "Authorization: Api-Token $DT_TOKEN"

Résultat attendu : une liste de clés builtin:host.* avec leur nom et leur unité.

Étape 2 — Lire un descripteur

curl -s "$DT_URL/api/v2/metrics/builtin:host.cpu.usage" \
  -H "Authorization: Api-Token $DT_TOKEN"

Résultat attendu : l’unité Percent, l’agrégation par défaut avg et la dimension dt.entity.host.

Étape 3 — Comparer moyenne et maximum

Interrogez la même métrique avec builtin:host.cpu.usage:avg puis builtin:host.cpu.usage:max sur deux heures. Résultat attendu : des valeurs maximales nettement plus hautes que les moyennes sur un hôte chargé.

Étape 4 — Observer l’effet de l’âge

Dans le Data Explorer, affichez la même métrique sur 7 jours puis sur 60 jours. Résultat attendu : des points plus espacés sur la longue période, conformément au tableau de rétention.

Quiz

  1. Quel préfixe porte une métrique calculée ? a) builtin: b) ext: c) calc: d) dt.
  2. Que renvoie une requête sans agrégation explicite ? a) Le maximum b) L’agrégation par défaut du descripteur c) Toutes les agrégations d) Une erreur
  3. Quelle granularité reste disponible pour une métrique vieille de 3 mois ? a) 1 minute b) 5 minutes c) 1 heure d) 1 jour
  4. Comment est envoyé un point de type count ? a) Sous forme de delta b) Sous forme de min/max c) Sous forme de pourcentage d) Sous forme de log

Corrigé

  1. c) Les métriques calculées que vous créez portent le préfixe calc:.
  2. b) Le champ defaultAggregation du descripteur s’applique.
  3. c) Entre 28 et 400 jours, la granularité est d’une heure.
  4. a) Le format count transporte la différence avec le point précédent.

Pour aller plus loin

Sommaire du parcours · Module 2 : hôtes infrastructure →

Questions fréquentes

Pourquoi mon graphique Dynatrace ne correspond-il pas à top ou au Gestionnaire des tâches ?

L’outil système montre une valeur instantanée ; Dynatrace affiche par défaut une moyenne par intervalle, et l’intervalle grandit avec la période affichée. Demandez max et réduisez la période pour vous rapprocher de l’instantané.

Peut-on allonger la granularité d’une minute au-delà de 14 jours ?

La documentation de Managed présente ces paliers comme fixes pour les tableaux de bord et l’API. Pour garder un historique fin, exportez les séries utiles par l’API pendant qu’elles sont à la minute.

Les clés builtin: existent-elles aussi en SaaS ?

Oui, comme métriques classiques. Avec Grail, la plupart ont un équivalent dt.* interrogé en DQL ; le parcours SaaS traite cette correspondance.

Vous savez maintenant lire une clé, son descripteur et sa granularité. Le module suivant applique cette grille aux métriques d’hôte : CPU, mémoire, disque, réseau et disponibilité.

span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC. Ce parcours ne remplace pas les formations et certifications officielles de Dynatrace University. Vérifiez les fonctionnalités dans la documentation officielle de votre version.

Total
0
Shares
Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Previous Post
Parcours métriques Dynatrace Managed : la formation en 6 modules

Parcours métriques Dynatrace Managed : la formation en 7 modules

Next Post
Module 2 — Hôtes infrastructure : 20 métriques builtin de Dynatrace Managed

Module 2 — Hôtes infrastructure : 20 métriques builtin de Dynatrace Managed

Related Posts