Création d'un widget de barre horizontale IBM Cloud Logs

Vous pouvez créer un diagramme à barres horizontales qui peut être inclus dans les tableaux de bord personnalisés de IBM® Cloud Logs.

Utilisez un widget de diagramme à barres horizontales pour trier vos données par valeur, dans l'ordre décroissant par défaut. Dans les diagrammes à barres verticales, les données sont généralement triées par ordre alphabétique du nom de la colonne.

Le widget graphique à barres horizontales intègre des seuils, qui vous permettent de modifier la visualisation lorsque certaines valeurs sont atteintes ou exécutées. Lorsque l'on regroupe un ensemble de données en fonction de paramètres spécifiques, on crée une barre multihorizontale, où chaque barre horizontale représente un sous-ensemble des données. Cela permet d'effectuer des comparaisons simultanées entre différentes catégories ou groupes et d'obtenir ainsi une vision plus large.

Étape 1 : Saisir le nom et la description

Procédez comme suit :

Dans un tableau de bord personnalisé, cliquez sur Ajouter un widget et faites glisser le widget Graphique à barres horizontales depuis votre barre latérale.
Remplacez Nouveau graphique à barres horizontales par le nom du widget.
Entrez une description.

Cliquez sur l'icône d'action . Sélectionnez ensuite Ajouter une description.
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 . Sélectionnez ensuite Paramètres de légende.

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

Procédez comme suit :

Cliquez sur l'icône d'action . Sélectionnez ensuite le mode Édition.
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.
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.
[Facultatif] Ajouter un ou plusieurs filtres spécifiques au widget pour réduire les données affichées.

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.

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.

Dans les graphiques à barres, la modification du type d'agrégation modifie le type de données que vous voyez.

Pour une requête dont le type de données est Metrics, choisissez une fonction.

Étape 3 : Configurer le widget

Procédez comme suit :

Cliquez sur l'icône d'action . Sélectionnez ensuite le mode Édition.
Choisissez une option de paramétrage du diagramme à barres pour la vue de l'axe des Y par pour configurer l'affichage de la valeur ou de la catégorie. Les options valables sont : Value et Category.
Choisissez une option de gestion de la légende. Les valeurs valides pour Logs sont : Group, Stack, et Aggregation . Les valeurs valables pour les métriques sont : Group et Stack

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.

L' empilement montre comment plusieurs entrées de données sont regroupées et superposées sur la même barre horizontale. Les ensembles de données de la même pile sont regroupés dans un seul diagramme à barres horizontal divisé en segments. Vous obtenez ainsi une deuxième couche de données sur le graphique.

L' agrégation affiche la valeur en combinant plusieurs valeurs de données en une seule valeur résumée avant de les afficher dans le graphique ou la légende.

Schéma de couleurs de la légende: Sélectionnez si vous voulez que les couleurs de votre légende soient par groupe, par pile ou par agrégation. Par défaut, le diagramme à barres horizontales est agrégé, ce qui signifie qu'une seule couleur sera affichée pour toutes les barres.

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

Le graphique "max bar by" affiche le nombre maximum de barres individuelles dans une seule vue graphique en fonction de votre requête.

Le nombre maximum de tranches par barre affiche le nombre maximum de segments dans une seule barre.

Activez la barre maximale par graphique, les tranches maximales par barre ou les deux pour afficher une seule valeur dans un intervalle spécifié.
Configurez la section Scale.

Une échelle se réfère à la manière dont les valeurs sont affichées le long des axes x et y. Vous pouvez choisir entre des valeurs linéaires ou logarithmiques.

Choisissez le type d'échelle. Les options valables sont : linear qui définit la façon dont les valeurs augmentent proportionnellement et logarithmic où la valeur est définie par des logarithmes au lieu d'intervalles linéaires égaux.

Vous pouvez modifier la couleur d'une valeur seuil.

Par défaut, le réglage est linéaire. Toutefois, si les écarts entre les différentes valeurs sont importants, il peut être utile d'afficher l'échelle logarithmique. Par exemple, si la majorité de vos valeurs sont inférieures à 1k et qu'une valeur est 10k, l'utilisation de l'échelle logarithmique vous permettra d'obtenir un diagramme à barres plus facile à lire que l'échelle linéaire.

Étape 4 : Enregistrer le widget

Procédez comme suit :

[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.
Cliquez sur Enregistrer pour sauvegarder votre widget.
[Facultatif] Partager un lien direct vers le widget. Cliquez sur l'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.
[Facultatif] Ajouter une action personnalisée. Pour plus d'informations, voir Utilisation d'actions pour intégrer des services tiers.