Avant de commencer

Une carte thermique affiche l'intensité des valeurs de données à l'aide de couleurs. Chaque cellule représente la valeur agrégée des données à l'intersection de deux dimensions telles que le temps - le service, le point final - la latence, ou la région - le code d'état. Cela permet d'identifier facilement les pics et les modèles qui pourraient être difficiles à voir dans un graphique linéaire ou à barres.

Tenez compte des informations suivantes lors de la configuration de la carte thermique :

• Le nombre total de combinaisons X×Y renvoyées par la requête doit rester inférieur à 2 000 lignes de données.

• Si votre requête renvoie plus de 2000 enregistrements, augmentez l'intervalle de temps ou réduisez le nombre de rubriques Groupe par.

• N'utilisez pas plus de 5 champs de regroupement par widget. Des champs supplémentaires peuvent nuire à la lisibilité et aux performances.

• Évitez de regrouper les données en fonction d'étiquettes à forte cardinalité comme user_id.

• Limiter les champs de regroupement pour éviter de surcharger les résultats de la visualisation.

Étape 1 : Saisir le nom et la description

Procédez comme suit :

1. Dans une page tableau de bord personnalisé, cliquez sur Ajouter un widget et faites glisser le widget Carte thermique depuis votre barre latérale.

2. Remplacez Nouvelle carte thermique par le nom du widget.

3. Entrez une description.

   Cliquez sur l'icône d'action . Sélectionnez ensuite Ajouter une description.

Étape 2 : Configurer la requête pour définir l'ensemble de données

Procédez comme suit :

1. Cliquez sur l'icône d'action . Sélectionnez ensuite le mode Édition.

2. Pour Query 1, procédez comme suit :

   Sélectionnez le type de données. Les valeurs valides sont : Logs, Metrics, et DataPrime.

   Sélectionnez la source. Les options valables sont : Priority Insights et Analyze and Alert.

   Vous pouvez renommer la requête. Sélectionnez l' et cliquez sur Renommer la requête.

3. Saisissez la requête.

   Lorsque le type de données est DataPrime, saisissez une requête Dataprime dans le champ Query.

   Lorsque le type de données est Logs, saisissez une requête Lucene dans le champ Query. Vous pouvez appliquer des filtres et des agrégations.

   Lorsque le type de données est Metrics, spécifiez la métrique ou la valeur souhaitée PromQL dans le champ Query. Vous pouvez appliquer des filtres et des agrégations.

4. [Facultatif] Ajoutez un ou plusieurs filtres spécifiques au widget pour restreindre les données affichées dans votre jauge.

   Sélectionnez une étiquette et sa valeur correspondante.

   Les filtres sont appliqués au niveau du widget et fonctionnent en parallèle avec les filtres du tableau de bord. En cas de conflit, les filtres du tableau de bord ont la priorité sur les filtres des widgets.

5. Ajoutez une fonction pour grouper et agréger vos données pour la carte thermique.

   Sélectionnez une fonction d'agrégation telle que Count, Sum ou Average pour calculer la valeur représentée par l'intensité de la couleur.

   Sélectionnez Grouper par champs. Ces champs sont utilisés pour les axes de la carte thermique. Ces champs doivent être de type chaîne de caractères, horodatage ou gravité. Si un champ est numérique, tel que status_code, vous pouvez le convertir en chaîne de caractères dans une requête DataPrime avant de le regrouper. Par exemple, vous pouvez utiliser dans votre requête : status_code:string

Étape 3 : Configurer le widget

Procédez comme suit :

1. Cliquez sur l'icône d'action . Sélectionnez ensuite le mode Édition.

2. Dans la section Gestion visuelle, sélectionnez jusqu'à 5 catégories ou champs que vous souhaitez voir apparaître sur les axes X et Y.

   Pour contrôler quel champ apparaît sur l'axe des X et quel champ apparaît sur l'axe des Y, faites glisser les champs entre Y-axis et X-axis.

   Lorsqu'un champ d'horodatage apparaît sur l'axe des X, sélectionnez la manière dont les étiquettes de temps sont affichées. La valeur par défaut est Auto, qui ajuste le format en fonction de l'intervalle de temps sélectionné. Les formats suivants sont disponibles :

   Formats des champs d'horodatage

   Format	Exemple
   Auto	S'ajuste automatiquement
   DD/MM	25/04
   dd/mm	04/25
   hh:mm	14:30
   JJ/MM HH:mm	25/04 14:30
   HH:mm DD/MM	14:30 25/04
   MM/DD HH:mm	04/25 14:30
   HH:mm MM/DD	14:30 04/25

3. Afficher les valeurs des cellules. Permet de superposer des valeurs numériques à l'intérieur de chaque cellule. Ceci est utile lorsque les cellules sont plus grandes et lisibles.

4. Sélectionnez une palette de couleurs prédéfinie pour représenter l'intensité des données. Vous pouvez inverser l'ordre des couleurs (clair → foncé ou foncé → clair).

   Sélectionnez la palette de couleurs à l'aide de la configuration de la légende. Par défaut, il établit une correspondance entre les valeurs claires et les valeurs foncées. Utilisez les seuils Min et Max pour contrôler l'étendue de l'échelle des couleurs et améliorer la lisibilité des données dont la distribution est large ou inégale.

5. Choisissez le type d'échelle. Les valeurs valides sont Linear (valeur par défaut), où les couleurs changent uniformément selon les valeurs, ou Logarithmic, où la couleur s'applique globalement à l'accès Z (barre d'intensité de la couleur) pour les ensembles de données comportant de larges plages de valeurs.

6. Dans la section Gestion des infobulles, personnalisez les informations qui s'affichent lorsque vous survolez un point ou un groupe sur la carte. Ajoutez le message et sélectionnez les étiquettes ou les attributs à inclure dans l'infobulle.

   Ajouter le message ou la valeur qui s'affiche lors du survol d'un point ou d'une grappe. Vous pouvez faire référence à des champs dynamiques, tels que la valeur agrégée, en utilisant la syntaxe {{ }}.

   Lorsqu'un champ référencé se résout en plusieurs valeurs distinctes au sein d'une grappe, l'infobulle affiche une étiquette générique telle que "multiple" au lieu d'une valeur spécifique. Cela indique que la grappe contient des valeurs mixtes et incite à approfondir la question pour obtenir plus de détails.

   Sélectionnez les étiquettes ou les attributs à inclure dans l'infobulle, tels que le service, l'application ou le pays.

Étape 5 : Enregistrer le widget

Procédez comme suit :

1. [Facultatif] Définir l'heure du tableau de bord du widget si vous souhaitez utiliser une plage horaire différente de celle sélectionnée pour le tableau de bord.

2. Cliquez sur Enregistrer pour sauvegarder votre widget.

3. [Facultatif] Ajouter une action personnalisée. Pour plus d'informations, voir Utilisation d'actions pour intégrer des services tiers.

Actions sur une carte

Utilisez les actions rapides pour étudier les données directement à partir de l'hetamap.

Lorsque vous sélectionnez un point ou un cluster, un menu contextuel propose les actions suivantes :

• Open Explore: Ouvre les journaux dans la vue Explore, pré-filtrés à l'aide de l'emplacement sélectionné et du contexte du cluster.

• Filter in: Ajoute le lieu sélectionné et le contexte de valeur à la requête du tableau de bord.

• Filter out: Exclut le lieu et le contexte de valeur sélectionnés de la requête du tableau de bord.

• Copy name: Copie l'étiquette de localisation ou la paire clé=valeur associée au point ou au cluster sélectionné.