Que vous utilisiez les métriques, les monitors, les dashboards ou encore les notebooks, tous les graphiques Datadog offrent les mêmes fonctionnalités de base. Cette page décrit comment créer des requêtes avec l’éditeur de graphiques. Les utilisateurs avancés peuvent également modifier des graphiques avec JSON. Pour en savoir plus, consultez la section Graphiques JSON.
Depuis les widgets, ouvrez l’éditeur de graphiques en cliquant sur l’icône en forme de crayon en haut à droite. L’éditeur de graphiques présente les onglets suivants :
Lorsque vous ouvrez l’éditeur de graphiques pour la première fois, vous accédez à l’onglet Edit. De là, vous pouvez utiliser l’interface pour définir la plupart des paramètres. Voici un exemple :
Pour configurer votre graphique sur un dashboard, suivez ce processus :
Sélectionnez votre visualisation à partir des widgets disponibles.
Choisissez la métrique à représenter en la recherchant ou en la sélectionnant dans le menu déroulant à proximité de Metric. Si vous ne savez pas quelle métrique utiliser, vous pouvez commencer par consulter le Metrics Explorer ou un notebook. Vous pouvez également consulter la liste des métriques sur la page Metrics Summary.
La métrique choisie peut être filtrée en fonction d’un host ou d’un tag à l’aide du menu déroulant from à droite de la métrique. Le filtre par défaut est (everywhere).
Vous pouvez également utiliser le filtrage avancé dans le menu déroulant from
pour évaluer les requêtes filtrées avec un opérateur booléen, comme suit :
Pour en savoir plus sur les tags, consultez la documentation relative au tagging.
La méthode d’agrégation est indiquée à côté de la liste déroulante du filtre. La méthode par défaut est avg by
, mais vous pouvez la définir sur max by
, min by
ou sum by
. Dans la plupart des cas, la métrique possède de nombreuses valeurs issues d’un grand nombre de hosts ou d’instances pour chaque intervalle de temps. La méthode d’agrégation choisie détermine comment les valeurs de la métrique sont agrégées en une seule ligne.
Après la méthode d’agrégation, vous pouvez déterminer ce qui constitue une ligne ou un groupe dans un graphique. Par exemple, si vous choisissez host
, une ligne apparaîtra pour chaque host
. Chaque ligne représente la métrique sélectionnée pour un host
spécifique, ses valeurs étant agrégées selon la méthode choisie.
Indépendamment des options précédemment choisies, en raison des contraintes de taille physique de la fenêtre du graphique, les données font toujours l’objet d’une certaine agrégation. Si une métrique est mise à jour toutes les secondes et que vous consultez 4 heures de données, vous avez besoin d’afficher 14 400 points pour tout représenter. Chaque graphique illustre environ 300 points à la fois. Ainsi, chaque point de données affiché à l’écran représente 48 points de données.
Dans la pratique, les métriques sont recueillies par l’Agent toutes les 15 à 20 secondes. Ainsi, un jour de données représente 4 320 points. Si vous représentez les données d’un jour entier sur un seul graphique, les données sont automatiquement cumulées par Datadog. Pour en savoir plus, consultez la page Présentation des métriques.
Pour cumuler manuellement les données, utilisez la fonction rollup. Cliquez sur le signe « + » à droite du groupe d’agrégation et choisissez rollup
dans la liste déroulante. Choisissez ensuite la méthode d’agrégation de vos données ainsi que l’intervalle en secondes.
Cette requête crée une ligne unique représentant l’espace disque total disponible en moyenne sur l’ensemble des machines déployées, avec un intervalle de cumul des données de 60 secondes :
Lorsque vous passez à la vue JSON, voici à quoi ressemble la requête :
"q": "avg:system.disk.free{*}.rollup(avg, 60)"
Pour obtenir davantage d’informations sur l’utilisation de la vue JSON, consultez la section Graphiques JSON.
En fonction de vos besoins d’analyse, vous pouvez choisir d’appliquer d’autres fonctions mathématiques à votre requête. Vous pouvez par exemple calculer les taux et les dérivées, appliquer un lissage, et plus encore. Consultez la liste des fonctions disponibles.
Datadog vous permet également de représenter graphiquement vos métriques avec différentes opérations arithmétiques. Utilisez les options +
, -
, /
et *
pour modifier les valeurs affichées sur vos graphiques. Cette syntaxe accepte à la fois des nombres entiers et des opérations arithmétiques sur plusieurs métriques.
Pour représenter les métriques séparément, ajoutez une virgule (,
). Par exemple, a, b, c
.
Modifiez la valeur affichée pour une métrique sur un graphique en effectuant une opération arithmétique. Par exemple, vous pouvez visualiser le double d’une métrique spécifique en cliquant sur le lien Advanced… de l’éditeur de graphiques. Saisissez ensuite votre opération arithmétique dans la case Formula
, à savoir ici : a * 2
.
Visualisez le pourcentage d’une métrique en divisant une métrique par une autre. Par exemple :
jvm.heap_memory / jvm.heap_memory_max
Utilisez l’option Advanced… sur l’éditeur de graphiques et sélectionnez Add Query. Chaque requête se voit attribuer une lettre dans l’ordre alphabétique : la première métrique est représentée par a
, la seconde par b
, etc.
Dans la case Formula
, saisissez ensuite l’opération arithmétique (a / b
dans cet exemple) :
Pour afficher uniquement la formule sur votre graphique, cliquez sur les coches correspondant aux métriques a
et b
.
Remarque : les formules ne sont pas représentées par des lettres. Vous ne pouvez donc pas effectuer d’opérations arithmétiques entre plusieurs formules.
Si vous ne saisissez pas de titre, Datadog en génère un automatiquement en fonction de vos sélections. Nous vous conseillons toutefois de définir un titre qui décrit précisément l’objectif du graphique.
Cliquez sur Done pour enregistrer votre travail et quitter l’éditeur. Vous pourrez toujours revenir à l’éditeur pour modifier le graphique. Si vous ne souhaitez pas enregistrer les modifications effectuées, cliquez sur Cancel.
Pour configurer votre graphique à l’aide des données statistiques APM, suivez ces étapes :
Choisissez le niveau de détail pour lequel vous souhaitez visualiser des statistiques : services, ressources ou spans. Tous les niveaux de détail ne sont pas disponibles pour chaque type de widget.
Sélectionnez les paramètres suivants depuis l’éditeur de graphiques : Environnement (env
), Tag primaire (primary_tag
), Service (service
) et Nom de l’opération (name
).
Si le niveau de détail choisi correspond à une ressource ou à une span, vous devrez également sélectionner un Nom de ressource (resource
) pour certains types de widget afin d’affiner le contexte de votre requête.
Identifiez les corrélations avec vos événements à l’aide de la section Event Overlays dans l’éditeur de graphiques. Dans la barre de recherche, saisissez du texte ou une requête de recherche structurée. Pour en savoir plus sur les recherches, consultez la documentation sur le langage de requête d’événement de Datadog.
Documentation, liens et articles supplémentaires utiles: