Présentation

La page Metrics Summary affiche la liste des métriques transmises à Datadog pendant un intervalle précis, à savoir l’heure précédente, le jour précédent ou la semaine précédente.

Recherchez vos métriques par nom de métrique ou par tag en utilisant les champs de recherche Metric ou Tag :

Remarque : Les valeurs de tag sont conservées dans le champ de recherche Tag pendant 28 heures. Les valeurs non soumises au cours des 28 dernières heures n’apparaissent pas comme options de recherche, même si elles restent visibles dans le panneau latéral des détails de la métrique.

Vous pouvez également découvrir des métriques pertinentes en utilisant la prise en charge améliorée de la recherche approximative (fuzzy matching) dans le champ de recherche Metrics :

Le filtrage par tag prend en charge la syntaxe booléenne et les caractères génériques afin que vous puissiez identifier :

• Les métriques marquées avec une clé de tag particulière, par exemple, team : team:*
• Les métriques auxquelles il manque une clé de tag particulière, par exemple, team : NOT team:*

Panneau de facettes

Les barres de recherche offrent l’ensemble d’actions le plus complet pour filtrer la liste des métriques. Mais les facettes peuvent également filtrer vos métriques par :

• Configuration : Métriques avec configurations de tags
• Percentiles : Métriques de distribution activées par des centiles/capacités de requête avancées
• Historical Metrics : Métriques pour lesquelles l’ingestion de métriques historiques est activée
• Query Activity : Métriques non interrogées dans Datadog ou par l’API au cours des 30, 60 ou 90 derniers jours
• Related Assets : Métriques utilisées dans des dashboards, notebooks, monitors et SLOs.
• Metric Type : Différencier les métriques de distribution des métriques non liées à la distribution (comptes, jauges, taux)
• Metric Origin : Le produit dont provient la métrique (par exemple, les métriques générées à partir de Logs ou d’APM Spans). Pour en savoir plus sur les différents types d’origine des métriques, consultez Définitions de l’origine des métriques

Définitions

Une métrique est non interrogée si elle n’a pas fait l’objet d’un accès dans des moniteurs, des SLO, des notebooks exécutés, des tableaux de bord ouverts, utilisée dans des requêtes Metrics Explorer ou accédée via des appels API au cours des 30, 60 ou 90 derniers jours.

Une métrique est considérée comme utilisée tant qu’elle existe sur une ressource, indépendamment du fait qu’elle ait été activement interrogée.

Configuration de plusieurs métriques

Cliquer sur Configure Metrics vous donne plusieurs options pour configurer plus d’une métrique à la fois :

• Manage tags : Configurer des tags sur plusieurs métriques personnalisées correspondant à un espace de noms en utilisant Metrics without Limits™.

• Enable or disable percentiles : Gérer les agrégations de centiles sur plusieurs métriques de distribution. Consultez la page Distributions pour plus d’informations.

• Enable or disable historical metrics ingestion : Gérer l’ingestion de données de métriques historiques. Consultez la page Ingestion de métriques historiques pour plus d’informations.

Panneau latéral des détails de la métrique

Cliquez sur un nom de métrique pour afficher dans son volet latéral des détails concernant les métadonnées et les tags de cette métrique :

Nom de la métrique

Le nom de votre métrique dans le Metrics Explorer, les dashboards, etc.

Métriques personnalisées ingérées

Un nom de métrique peut émettre plusieurs métriques personnalisées ingérées en fonction de ses combinaisons de valeurs de tags associées. Les métriques personnalisées ingérées représentent toutes les données soumises à l’origine avec le code.

Pour en savoir plus, consultez la documentation relative aux métriques custom.

Métriques personnalisées indexées

Contrairement aux métriques personnalisées ingérées, les métriques personnalisées indexées représentent celles qui restent interrogeables sur l’ensemble de la plateforme Datadog. Ce nombre peut être impacté par l’ajout ou la suppression d’agrégations de centiles ou par l’utilisation de Metrics without Limits™. En savoir plus dans la documentation Metrics without Limits™.

Hôtes

Le nombre total de hosts qui transmettre une métrique.

Valeurs de tag

Le nombre total de valeurs de tag uniques associées à une métrique.

En savoir plus sur le tagging.

Métadonnées de métrique

Les métadonnées associées à votre métrique. La plupart des métadonnées peuvent être modifiées sur la page de résumé des métriques ou avec la Datadog API.

Unité de métrique

L’unité de votre métrique (octet, seconde, requête, interrogation, etc.). Consultez la page metric unit pour plus de détails.

Lors de l’envoi de métriques custom à Datadog, vous pouvez modifier l’unité de mesure affichée lorsque vous passez votre curseur sur une métrique dans un graphique.

Remarque : cela ne modifie pas la façon dont un graphique de métrique est affiché. Cela modifie uniquement les unités de mesure considérées pour les valeurs brutes lorsque vous survolez une métrique. Le formatage est automatiquement appliqué pour la lisibilité. Par exemple, les octets (B) peuvent être affichés en kilo-octets (KiB).

Type de métrique

Le type de votre métrique (jauge, taux, compte, distribution). Consultez la page metric type pour plus de détails.

Avertissement : La modification du type de métrique change le comportement de cette métrique pour TOUS vos dashboards et monitors.

Nom de l’intégration

Si la métrique provient d’une intégration prise en charge, les métadonnées indiquent le nom de l’intégration. Ces informations ne peuvent pas être modifiées.

Intervalle

L’intervalle de collecte pour la métrique en secondes.

Description de la métrique

La description de la métrique vous aide à comprendre ce qu’elle représente, pourquoi elle existe et comment elle est généralement utilisée. Utilisez ce champ pour générer une vue et mettre à jour les descriptions de vos métriques personnalisées. Les descriptions sont pré-remplies pour les métriques provenant d’intégrations prises en charge.

Description générée par IA

Pour les métriques personnalisées, Datadog peut générer automatiquement des descriptions en utilisant le contexte disponible, notamment le nom de la métrique, les tags pertinents, l’activité des requêtes et le code source associé. Pour utiliser le code source comme contexte supplémentaire, installez l’intégration GitHub, GitLab ou Azure DevOps de Datadog et connectez vos dépôts.

Code source

La section Code source du panneau latéral des métriques offre une vue centralisée de chaque métrique personnalisée et de son contexte sous-jacent.

Utilisez la section Code source du panneau latéral des métriques pour identifier le code source d’une métrique, comprendre comment elle est générée et déterminer qui en est responsable. Elle offre une visibilité sur le contexte et la responsabilité, ce qui vous aide à résoudre les problèmes et à optimiser plus rapidement en établissant un lien direct vers le fichier source, l’historique des commits et les données de blame de la métrique.

Dépannage des métriques manquantes

Si une métrique n’apparaît pas dans le code source, cela peut être dû à la manière dont elle est définie.

Datadog détecte mieux les métriques lorsque les noms sont écrits sous forme de chaînes explicites. Les métriques créées à l’aide de variables, de constantes ou d’assistants personnalisés peuvent ne pas être détectées.

Raisons courantes pour lesquelles des métriques sont manquantes :

• Le nom de la métrique est généré dynamiquement
• La métrique est émise via des wrappers personnalisés
• Le dépôt n’est pas entièrement indexé

Bonne pratique :

• Définissez les noms de métriques sous forme de chaînes explicites lorsque cela est possible

Exemple :

Envoi d’une métrique à l’aide d’une variable (non recommandé)

public static final String METRIC_NAME = "my.metric.name";
statsEmitter.distribution(METRIC_NAME, value, tags);

Envoi d’une métrique sous forme de chaîne explicite (recommandé) :

timer = meterRegistry.timer("my.metric.name");

Pour garantir une couverture complète du code source de votre métrique, assurez-vous d’avoir installé l’intégration Datadog GitHub, GitLab ou Azure DevOps et que tous vos dépôts sont connectés.

Tableau des tags

Le tableau des tags vous permet d’explorer de plusieurs façons toutes les clés et toutes les valeurs des tags qui sont activement transmises dans les données de votre métrique.

Grâce au tableau des tags, vous pouvez accomplir les actions suivantes :

• Triez les clés de tag par la colonne Count (nombre de valeurs de tag uniques).
• Recherchez une clé de tag particulière dans le tableau paginé des tags.
• Exportez le tableau des tags sous forme de fichier CSV téléchargeable.
• Basculez entre les tags que vous avez configurés sur votre métrique et les tags soumis à l’origine pour la métrique

Pour chaque clé de tag spécifique, vous pouvez également effectuer les opérations suivantes :

• Inspectez toutes les valeurs de tag de cette clé de tag.
• Utilisez un tag spécifique key:value pour filtrer davantage la liste des métriques affichées sur la page Metrics Summary.
• Ouvrez un graphique de cette métrique filtré par votre paire key:value de tags dans Metrics Explorer.
• Copiez n’importe quel tag key:value pour filtrer dans l’ensemble de l’application.

En savoir plus sur le tagging.

Ressources associées aux métriques

Pour déterminer la valeur de n’importe quel nom de métrique pour votre organisation, utilisez les Ressources associées aux métriques. Les ressources associées aux métriques désignent tout dashboard, notebook, monitor ou SLO qui interroge une métrique particulière.

1. Faites défiler jusqu’au bas du panneau latéral des détails de la métrique vers la section Related Assets.
2. Cliquez sur le bouton déroulant pour afficher le type de ressource associée qui vous intéresse (tableaux de bord, monitors, notebooks, SLO). Vous pouvez également utiliser la barre de recherche pour valider des ressources spécifiques.
3. La colonne Tags indique exactement quelles balises sont utilisées dans chaque ressource.

Custom Metrics Tags Cardinality Explorer

Metrics without Limits™

Metrics without Limits™ vous permet de contrôler la taille de vos métriques personnalisées sans nécessiter de modifications au niveau de l’agent ou du code.

Remarque : Metrics without Limits™ est uniquement disponible pour les métriques personnalisées.

Vous pouvez configurer des balises en masse en accédant à Configure Metrics > Manage tags sur la page Métriques, ou en cliquant sur le bouton Manage Tags dans le panneau latéral des détails d’une métrique.

1. Cliquez sur le nom de votre métrique de distribution personnalisée dans le tableau Metrics Summary pour ouvrir le panneau latéral des détails des métriques.
2. Cliquez sur le bouton Manage Tags pour ouvrir la modale de configuration des tags.
3. Sélectionnez Include tags… ou Exclude tags… pour personnaliser les tags que vous souhaitez ou ne souhaitez pas interroger. Pour plus d’informations sur la configuration des tags, consultez la documentation Metrics without Limits.
4. Prévisualisez les effets de votre configuration de tags proposée avec l’estimateur de cardinalité avant de sélectionner Save.

Remarque : L’estimateur de cardinalité nécessite que la métrique date de plus de 48 heures.

Tags interrogeables

Une fois votre métrique configurée avec Metrics without Limits™, vous pouvez voir quels tags restent interrogeables, c’est-à-dire ceux qui contribuent au volume d’Indexed Custom Metrics. Et vous pouvez revenir à tous les tags initialement soumis et ingérés qui contribuent à votre volume d’Ingested Custom Metrics.

Définitions de l’origine des métriques

Ce tableau présente la correspondance entre l’origine de la métrique telle qu’elle apparaît dans la facette et sa source d’envoi :

Lectures complémentaires

Documentation, liens et articles supplémentaires utiles:

Metrics ExplorerDOCUMENTATION Distributions de métriquesDOCUMENTATION