Création d'un widget de jauge IBM Cloud Logs

Vous pouvez créer un widget de jauge qui peut être inclus dans les tableaux de bord personnalisés de IBM® Cloud Logs.

Utilisez un widget de jauge pour afficher une valeur unique dans une plage spécifiée, ressemblant souvent à un compteur de vitesse ou à un cadran. Il est généralement utilisé pour représenter les mesures clés et les indicateurs de performance d'un seul coup d'œil.

Les jauges intègrent des seuils qui vous permettent de modifier l'apparence de la visualisation lorsque certaines valeurs sont atteintes ou dépassées. Lorsque vous regroupez un ensemble de données en fonction d'un paramètre spécifique, vous créez une jauge multiple, où chaque jauge représente un sous-ensemble des données. Cela permet d'effectuer des comparaisons simultanées entre différentes catégories ou groupes, offrant ainsi une vision plus large des performances.

Étape 1 : Saisir le nom et la description

Procédez comme suit :

  1. Dans un tableau de bord personnalisé, cliquez sur Ajouter un widget icône Ajouter un widget et faites glisser le widget Jauge depuis votre barre latérale.

  2. Remplacez Nouvelle jauge par le nom du widget.

  3. Entrez une description.

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

  4. Définir l'endroit où les valeurs de la légende sont affichées. Les valeurs valides sont : Side, Bottom, Auto, et Hide.

    Cliquez sur l'icône d'action Icône d'action. Sélectionnez ensuite Leggend Settings.

É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 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' icône d'action 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 la 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. Ajouter une fonction.

    Pour une requête dont le type de données est Logs, vous pouvez afficher une valeur agrégée à l'aide de l'une des fonctions suivantes :

    Option d'agrégation lors de la construction d'une requête lorsque le type de données est Logs
    Agrégation Description
    Nombre Le nombre total de journaux dans la plage de temps sélectionnée.
    Compte (éléments distincts) Le nombre de journaux uniques dans la période sélectionnée.
    Somme La somme de tous les journaux dans la plage de temps sélectionnée.
    Min. La plus petite valeur parmi les enregistrements dans l'intervalle de temps sélectionné.
    Max La valeur la plus élevée parmi les journaux dans la plage de temps sélectionnée.
    Moyenne La valeur moyenne de tous les journaux dans la plage de temps sélectionnée.
    Percentile XX Représente la valeur en dessous de laquelle XX% des grumes tombent. Par exemple, le percentile 95 est la valeur en dessous de laquelle se situent 95 % des billes.

    Pour une requête dont le type de données est Metrics, vous pouvez afficher une valeur calculée à l'aide de l'une des fonctions suivantes :

    Option Calculs lors de la construction d'une requête lorsque le type de données est Métriques
    Calcul Description
    Instantané La valeur à l'instant présent.
    Dernier La valeur la plus récente dans l'intervalle de temps sélectionné.
    Min. La plus petite valeur dans la plage de temps sélectionnée.
    Max La plus grande valeur dans la plage de temps sélectionnée.
    Moy La valeur moyenne de tous les points de données dans la plage de temps sélectionnée.
    Somme La somme totale de tous les points de données dans l'intervalle de temps sélectionné.
    Aucun Aucun calcul n'est effectué. Les données brutes sont utilisées.

  6. Ajoutez 1 ou plusieurs champs dans Grouper par pour générer plusieurs jauges.

Étape 3 : Configurer le widget

Procédez comme suit :

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

  2. Choisissez une option de gestion de la légende. Les valeurs valables sont : Group et Threshold.

    Le groupe organise la légende en fonction des différentes entités de données, telles que les serveurs ou les applications, en affichant chacune d'entre elles comme une entrée distincte.

    Le seuil catégorise les valeurs en fonction de limites prédéfinies telles que normal, avertissement, critique, ce qui permet de visualiser si une mesure se situe dans une fourchette acceptable ou si elle est passée en état d'avertissement.

  3. Dans la section Gestion visuelle, choisissez la manière dont vous souhaitez visualiser les données.

    L'arc intérieur affiche la valeur réelle de votre requête.

    L'arc extérieur affiche les seuils que vous avez définis.

    Activez l' arc intérieur, l' arc extérieur ou les deux pour afficher une valeur unique dans une plage spécifiée, ressemblant souvent à un compteur de vitesse ou à un cadran.

    Si l' arc intérieur et l' arc extérieur sont désactivés, le résultat numérique de votre requête apparaîtra sous la forme d'un widget STAT sans visualisation supplémentaire. Dans ce cas, vous pouvez déterminer si la couleur du seuil sera appliquée à la valeur ou à l'arrière-plan. Dans cette partie de la configuration, vous définissez l'option de couleur de seuil que vous souhaitez. Vous pouvez sélectionner Valeur pour définir la couleur seuil de la valeur, ou vous pouvez définir Arrière-plan pour définir l'arrière-plan avec la couleur seuil.

  4. Configurez la section Seuils.

    Un seuil est une valeur que vous définissez et qui, lorsqu'elle est atteinte ou dépassée, modifie l'apparence de la visualisation en fonction des résultats de la requête. Vous pouvez choisir comme valeurs des pourcentages ou des nombres absolus.

    Choisissez le type de seuil. Les options valables sont : absolute pour définir des nombres spécifiques comme valeur et percentage pour définir des valeurs relatives à la valeur minimale ou maximale.

    Vous pouvez modifier la couleur d'une valeur seuil.

    Vous pouvez définir les valeurs d'un seuil et ajouter des étiquettes qui le décrivent.

    Vous pouvez ajouter des seuils supplémentaires.

Étape 4 : 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] Partager un lien direct vers le widget. Cliquez sur l'icône d'action Icône d'action. Ensuite, sélectionnez Share Widget URL, et copiez la page URL.

    Toute personne ayant accès au tableau de bord peut ouvrir le lien partagé pour voir le widget dans son contexte.

    Les URL des widgets partagés reflètent toujours la dernière version enregistrée du tableau de bord. Si vous avez modifié le widget ou la mise en page, enregistrez votre tableau de bord avant de le partager.

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