Explorateur visuel

IBM® Cloud Logs Visual Explorer est un outil puissant qui combine un écran multifonctionnel avec des widgets de tableau de bord personnalisables. Visual Explorer offre un moyen rapide d'ajouter des graphiques basés sur des requêtes sans avoir à créer des tableaux de bord personnalisés. Vous pouvez exécuter plusieurs requêtes à partir de différentes sources de données afin qu'elles s'affichent côte à côte sur la même page, ce qui facilite la mise en corrélation des données et offre une vue d'ensemble plus complète de votre système.

Il s'agit d'une fonction bêta susceptible d'être modifiée et disponible à des fins d'évaluation et de test.

Au lieu de passer manuellement au crible les journaux bruts ou les données de mesure, vous pouvez rapidement localiser la source des problèmes à l'aide de modèles de journaux et d'indicateurs visuels. Les visualisations ad hoc peuvent être créées à l'aide d'un générateur de requêtes simplifié ou de langages de requêtes tels que DataPrime, Lucene ou PromQL.

Génération de requêtes

En utilisant l'explorateur visuel, vous pouvez construire des requêtes pour vos widgets sans avoir à connaître la syntaxe exacte de DataPrime, Lucene ou PromQL pour la requête.

Les fonctions d'élaboration des requêtes comprennent

  • La possibilité de sélectionner des journaux ou des mesures comme sources de données.

  • Créer facilement des requêtes DataPrime en utilisant la fonction Convert to DataPrime.

  • L'ajout de filtres à vos requêtes permet de réduire les résultats en fonction d'attributs ou de catégories spécifiques, ce qui facilite la recherche de données pertinentes.

  • Ajoutez des fonctions pour améliorer vos requêtes. Par exemple :

    • Regrouper les résultats d'une requête en fonction d'un libellé pour obtenir une vue plus granulaire.

    • Agrégation d'ensembles de valeurs pour obtenir une valeur unique. Les fonctions comprennent SUM(), AVG(), MIN(), MAX(), COUNT(), et bien d'autres encore.

Il est possible de créer jusqu'à 4 requêtes avec des attributs spécifiques sur une seule page de Visual Explorer. Vous pouvez alors ajouter de nouveaux graphiques ou dupliquer un graphique existant avec tous ses paramètres et configurations.

Utilisation de l'explorateur visuel

Accédez à l'Explorateur visuel en suivant les étapes suivantes :

  1. Connectez-vous à votre compte IBM Cloud.

  2. Accédez à votre instance IBM Cloud Logs

  3. Cliquez sur l'icône Logs Icône Logs > Visual Explorer.

  4. Dans Requête, configurez votre requête.

    • Dans Nom de la requête, donnez un nom significatif à votre requête.

    • Choisissez une source de données (Logs, Metrics, ou DataPrime) pour la requête.

      Si vous créez une requête Logs, vous pouvez la convertir au langage de syntaxe « DataPrime » en cliquant sur « Convertir en DataPrime ».

  5. Lorsque vous créez une requête sur les métriques, choisissez la métrique à interroger dans le menu des métriques disponibles.

Vous pouvez créer jusqu'à 4 graphiques de requête sur une seule page de Visual Explorer. Pour créer une autre requête, cliquez sur +. Pour dupliquer une requête existante, cliquez sur l'icône Dupliquer la requête.

Un diagramme de requête peut être supprimé à partir de la page de l'Explorateur visuel. Cette opération est définitive et ne peut pas être annulée.

Changement de visualisation

Vous pouvez facilement changer de visualisation graphique sans avoir à recréer les widgets. En changeant de type de graphique, vous pouvez explorer les données de différentes manières avec la même requête.

Utilisez le menu déroulant pour passer d'un affichage à l'autre.

Enregistrement sous forme de tableau de bord

Bien que les graphiques de Visual Explorer soient temporaires, vous pouvez les enregistrer en tant que tableaux de bord personnalisés pour les partager avec votre équipe.

Pour enregistrer le graphique en tant que tableau de bord :

  1. Cliquez sur « Enregistrer sous » dans le tableau de bord.

  2. Donnez un nom significatif au tableau de bord.

  3. Cliquez sur Sauvegarder.

Enregistre les requêtes

Enregistre le pipeline de données

Pour les requêtes de journaux, vous pouvez sélectionner Informations de priorité ou Tous les journaux pour le pipeline de données.

Filtres d'enregistrement

Vous pouvez ajouter un filtre en sélectionnant une étiquette et une valeur associée.

Les opérateurs = et != incluent ou excluent une ou plusieurs valeurs.

Ajoutez d'autres filtres en cliquant sur +.

Fonctions d'enregistrement

Les fonctions suivantes sont disponibles pour agréger les données du journal :

Fonctions du journal
Fonction Description
Count Le nombre total de points de données dans l'intervalle de temps sélectionné.
Count Distinct Le nombre de points de données uniques dans la plage de temps sélectionnée.
Sum La somme de tous les points de données dans l'intervalle de temps sélectionné.
Min La plus petite valeur parmi les points de données dans la plage de temps sélectionnée.
Max La plus grande valeur parmi les points de données dans l'intervalle de temps sélectionné.
Average La valeur moyenne de tous les points de données dans la plage de temps sélectionnée.
Percentile XX Percentile xx représente la valeur en dessous de laquelle se situent XX% des points de données. Par exemple, Percentile 95 est la valeur en dessous de laquelle se situent 95 % des points de données.

Vous pouvez également utiliser Group by pour regrouper les résultats d'une requête en fonction d'un ou de plusieurs champs.

DataPrime interrogations

Vous pouvez également créer une requête DataPrime pour votre widget. La vue par défaut comprend un widget de graphique linéaire basé sur les journaux avec une requête DataPrime (source logs | groupby $m.timestamp / 1m as timestamp agg count() as count). Cette requête récupère les journaux, les regroupe par intervalles d'une minute en fonction de leur horodatage, puis compte le nombre d'entrées de journaux apparaissant dans chacun de ces intervalles d'une minute.

Requêtes sur les métriques

Lorsque vous utilisez des métriques comme source de données, vous pouvez utiliser l'un des deux modes suivants : Constructeur et Requête. En mode Requête, spécifiez une requête PromQL. En mode Builder, vous construisez une requête en sélectionnant des options sans avoir à comprendre la syntaxe de PromQL.

Filtres de métrologie

Vous pouvez ajouter un filtre en sélectionnant une étiquette et une valeur associée.

Les opérateurs = et != incluent ou excluent une ou plusieurs valeurs.

Ajoutez d'autres filtres en cliquant sur +.

Fonctions de métrologie

La sélection de métriques et d'étiquettes permet de créer une requête PromQL valide, mais vous pouvez créer des requêtes plus complexes en utilisant des fonctions.

Agrégation

Les fonctions d'agrégation calculent un ensemble de valeurs et renvoient une seule valeur. Après avoir choisi la fonction, sélectionnez l'étiquette à agréger dans le menu ou saisissez l'étiquette.

Fonctions d'agrégation
Fonction Description
average La valeur moyenne de tous les points de données dans la plage de temps sélectionnée.
count Le nombre total de points de données dans l'intervalle de temps sélectionné.
min La plus petite valeur parmi les points de données dans la plage de temps sélectionnée.
max La plus grande valeur parmi les points de données dans l'intervalle de temps sélectionné.
sum La somme de tous les points de données dans l'intervalle de temps sélectionné.
quantile La fonction quantile(phi, q) by (group_labels) est un agrégat qui calcule le quantile phi pour chaque groupe d'étiquettes de la série temporelle renvoyée par q. La valeur de phi doit être comprise dans l'intervalle [0...1]. Le quantile est calculé séparément pour chaque ensemble de points ayant le même horodatage. Cette fonction est prise en charge par PromQL.
histogram_quantile La fonction histogram_quantile est une fonction de transformation qui calcule le phi-percentile sur la base des groupes d'histogrammes fournis. La valeur de phi doit être comprise entre [0...1]. Par exemple, histogram_quantile(0.5, sum(rate(http_request_duration_seconds_bucket[5m])) by (le)) renvoie la durée médiane de toutes les demandes au cours des 5 dernières minutes.

Nombre

Les fonctions de comptage effectuent des calculs sur un ensemble de valeurs et renvoient une seule valeur.

Fonctions de comptage
Fonction Description
count Le nombre total de points de données dans l'intervalle de temps sélectionné.
absent Renvoie 1 si la série temporelle n'a pas de points. Sinon, absent renvoie un résultat vide.
absent over time Renvoie 1 si l'intervalle de temps fourni ne contient pas d'échantillons bruts.
present over time Renvoie 1 s'il existe au moins un échantillon brut dans la plage de temps fournie.
changes Nombre de fois où la valeur de la série temporelle a changé dans l'intervalle de temps fourni.
resets Le nombre de réinitialisations du compteur dans la plage de temps fournie.

Cumul

Une fonction rollup fait référence aux fonctions qui agrègent les données d'une série temporelle sur un intervalle de temps spécifié. Ils sont utilisés pour résumer et analyser les données métriques.

Fonctions du rollup
Fonction Description
average over time Calcule la moyenne des valeurs d'une série temporelle sur une période donnée.
max over time Détermine la valeur maximale des données d'une série temporelle sur une période donnée.
min over time Détermine la valeur minimale des données d'une série temporelle sur une plage de temps.
max over time Détermine la valeur maximale des données d'une série chronologique sur une période donnée.
sum over time Calcule la somme des valeurs d'une série temporelle sur une période donnée.
count over time Compte le nombre d'éléments non-NaN dans la série temporelle sur une période donnée.
deviation over time Détermine la valeur de l'écart des données de séries chronologiques sur une période donnée.
variance over time Détermine la valeur de la variance des données de séries chronologiques sur un intervalle de temps donné.
last over time Détermine la dernière valeur des données d'une série chronologique sur une période donnée.
rate per second Détermine la valeur de la fréquence par seconde des données de séries chronologiques sur une période donnée.
quantile over time Calcule le quantile spécifié des données d'une série temporelle sur une plage de temps.

Après avoir choisi la fonction, sélectionnez la plage à interroger sous forme de nombre ou de ${__range}. La variable représente la durée de la plage horaire du tableau de bord. Il s'agit d'une chaîne d'intervalles prise en charge par PromQL. Par exemple, si vous sélectionnez une période allant de 13.00 à 14.30, la variable ${__range} est affichée sous la forme 90m. Pour plus d'informations, voir PromQL query variables.

Rang

Les fonctions de classement permettent de trier, classer et filtrer les données dans vos requêtes. Vous pouvez utiliser les fonctions de classement pour affiner vos résultats en fonction de paramètres et de valeurs spécifiques.

Après avoir sélectionné une fonction de classement, configurez-la en spécifiant la métrique et les paramètres (par exemple, indiquez le nombre de résultats K que vous souhaitez que la requête récupère pour TOPK).

Ranger les fonctions
Fonction Description
TOPK Récupère les résultats K les plus élevés d'un ensemble de données sur la base d'une métrique spécifiée. Utilisez TOPK pour afficher les points de données les plus importants.
SORT Ordonne les données par ordre croissant en fonction de la mesure sélectionnée. Utilisez le site SORT pour organiser les données de la plus petite à la plus grande valeur.
SORT Descending Ordonne les données par ordre décroissant en fonction de la métrique sélectionnée. Utilisez SORT Descending pour donner la priorité aux valeurs les plus importantes au début de l'ensemble de résultats.

Exemple de cas d'utilisation

Cet exemple combine deux graphiques pour corréler les journaux avec les niveaux de gravité Error et Critical avec l'utilisation de la mémoire de l'hôte qui exécute les services.

Tout d'abord, ajoutez la requête de logs :

  1. Sélectionnez Logs comme source de données.

  2. Ajouter la fonction Group par product_id.

  3. Ajouter un filtre pour Severity=Error, Critical.

Ajoutez ensuite la requête de métrologie :

  1. Cliquez sur + pour ajouter une requête.

  2. Sélectionnez Metrics comme source de données.

  3. Sélectionnez les paramètres mem_used.

  4. Ajouter la fonction sum par host.