Widget Carte thermique
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

Widget Carte thermique

Les cartes thermiques illustrent les métriques agrégées en fonction de nombreux tags, tels que des hosts. Plus le nombre de hosts partageant une valeur donnée est élevé, plus le carré est foncé.

Cette visualisation affiche une seule requête de métrique. Les requêtes supplémentaires sont ignorées.

Remarque : la détection des singularités n’est pas possible avec cette visualisation.

Configuration

Configuration

Configurez votre requête de métrique comme d’habitude. Notez que ce type de visualisation est uniquement utile lorsque les métriques sont agrégées en fonction de clés de tag, p. ex. pour chaque host.

Utilisez les réglages avg/max/min/sum by/etc. pour visualiser vos données en fonction des tags associés.

Options

Superposer des événements

Intégrez des événements de systèmes associés pour ajouter plus de contexte à votre graphique. Par exemple, vous pouvez ajouter des commits Github, des déploiements Jenkins ou des événements de création Docker. Développez la section Event Overlays et saisissez une requête pour afficher ces événements. Utilisez le même format de requête que pour le flux d’événements, par exemple :

RequêteDescription
sources:jenkinsAffiche tous les événements provenant de la source Jenkins.
tag:role:webAffiche tous les événements avec le tag role:web.
tags:$<TEMPLATE_VARIABLE>Affiche tous les événements provenant de la template variable sélectionnée.

Commandes de l’axe des ordonnées

Les commandes de l’axe des ordonnées sont disponibles via l’interface utilisateur et l’éditeur JSON. Grâce à ces commandes, vous pouvez :

  • Régler l’axe des ordonnées sur un intervalle donné.
  • Changer automatiquement les limites de l’axe des ordonnées en définissant un pourcentage ou une valeur absolue. Une limite peut être appliquée à l’une des deux extrémités du graphique (inférieure ou supérieure) pour supprimer les singularités.
  • Changer l’échelle de l’axe des ordonnées afin de passer d’une échelle linéaire à une échelle logarithmique, racine carrée ou puissance.

Changer l’échelle de l’axe des ordonnées en développant le bouton Y-Axis Controls.

Les options de configuration suivantes sont disponibles :

OptionObligatoireDescription
Min/MaxNonSpécifie la valeur minimale (et/ou maximale) à afficher sur l’axe des ordonnées. Indiquez un nombre ou Auto (la valeur par défaut).
ScaleNonSpécifie le type d’échelle. Valeurs autorisées :
- *linear* : une échelle linéaire (échelle par défaut).
- *log* : une échelle logarithmique
- *pow* : une échelle exprimée en puissance de 2. La valeur par défaut est 2, mais celle-ci peut être modifiée dans l’éditeur JSON.
- *sqrt* : une échelle exprimée sous la forme d’une racine carrée.
Always include zeroNonIndique s’il faut toujours inclure le zéro ou ajuster l’axe à la plage de données. Par défaut, le zéro est toujours inclus.

Remarque : comme la fonction log mathématique n’accepte pas les valeurs négatives, notre échelle log ne fonctionne que si les valeurs ont le même signe (tout > 0 ou tout < 0). Si ce n’est pas le cas, un graphique vide s’affiche.

API

Le schéma JSON utilisé pour le widget Carte thermique est le suivant :

HEATMAP_SCHEMA = {
    "type": "object",
    "properties": {
        "type": {"enum": ["heatmap"]},
        "requests": {
            "type":     "array",
            "items":    REQUEST_SCHEMA,
            "minItems": 1,
            "maxItems": 1
        },
        "yaxis":  AXIS_SCHEMA,
        "events": EVENTS_SCHEMA,
        "title":   {"type": "string"},
        "show_legend": {"type": "boolean"}
    },
    "required": ["type", "requests"],
    "additionalProperties": false
}
ParamètreTypeObligatoireDescription
typechaîneouiType de widget (utilisez heatmap pour le widget Carte thermique)
requeststableau d’objetsouiTableau d’un objet request à afficher dans le widget. Consultez la documentation relative au schéma JSON des requêtes pour apprendre à élaborer le REQUEST_SCHEMA.
yaxisobjetnonOptions de commande de l’axe des ordonnées. Consultez la [documentation relative au schéma JSON de l’axe des ordonnées][12] pour apprendre à élaborer le <AXIS_SCHEMA>.
eventsobjetnonOptions de commande des superpositions d’événement. Consultez la documentation relative au schéma JSON des événements pour apprendre à élaborer le <EVENTS_SCHEMA>
titlechaînenonTitre de votre widget.
show_legendbooléennon(screenboard uniquement) Afficher la légende pour ce widget

Propriétés supplémentaires autorisées dans l’objet requests :

{
  "style": {
    "type": "object",
    "properties": {"palette": {"type": "string"}},
    "additionalProperties": false
  }
}
ParamètreTypeObligatoireDescription
style.palettechaînenonPalette de couleurs à appliquer au widget.

Pour aller plus loin