Création d'un widget de graphique à courbes IBM Cloud Logs

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

Le graphique linéaire affiche les valeurs sous la forme d'une série de points de données.

É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 Graphique à courbes depuis votre barre latérale.

  2. Remplacez Nouveau graphique linéaire 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 Paramètres de légende.

É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.

    Lors de la création d'un diagramme à barres avec des métriques comme type de données, les catégories spécifiées dans la requête PromQL apparaissent automatiquement dans le champ Grouper par. Vous pouvez réorganiser les catégories dans le champ Grouper par en les faisant glisser et en les déposant. Faites glisser et déposez les catégories du champ Catégorie dans le champ Empilement, pour les empiler par catégorie particulière.

  4. [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.

  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.

É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 d' infobulle. Les valeurs valables sont : Show all series et Single View.

    Choisissez d'afficher toutes les séries temporelles lorsque vous les survolez ou de n'afficher que la série temporelle sur laquelle vous survolez.

  3. Dans la section Gestion visuelle, choisissez la manière dont vous souhaitez visualiser les données. Les options sont absolues et relatives.

    Absolute affiche des nombres spécifiques comme valeur alors que Relative affiche des valeurs relatives à la valeur minimale ou maximale.

  4. Dans la section Time Bucket, choisissez la manière dont vous souhaitez regrouper les points de données. Vous pouvez décider de regrouper les données automatiquement ou de choisir manuellement l'intervalle de temps exact.

    Vous pouvez saisir une valeur qui doit être affichée en tant que points de données à l'intérieur de chaque intervalle de temps.

  5. Dans la section Series Management, configurez l'option Scale.

    Une échelle fait référence à la manière dont les valeurs sont affichées sur l'axe des x et l'axe des y.

    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.

    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 :

  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 le fichier 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.