9 Graph

Vue d'ensemble

Le widget de graphique offre une manière moderne et polyvalente de visualiser les données collectées par Zabbix à l'aide d'une technique de dessin d'images vectorielles. Ce widget de graphique est pris en charge depuis Zabbix 4.0. Notez que le widget de graphique pris en charge avant Zabbix 4.0 peut toujours être utilisé comme Graphique (classique). Consultez également la section Ajout de widgets de la page Tableaux de bord pour plus de détails.

Configuration

Pour configurer, sélectionnez Graph comme type :

Jeu de données

L'onglet Jeu de données permet de sélectionner des données pour le graphique en ajoutant des jeux de données. Deux types de jeux de données peuvent être ajoutés:

  • Modèles d'éléments - les données des éléments correspondants sont affichées. Le graphique est tracé en utilisant différentes nuances d'une seule couleur pour chaque élément.
  • Liste d'éléments - les données des éléments sélectionnés sont affichées. Le graphique est tracé en utilisant différentes couleurs pour chaque élément.

Par défaut, un jeu de données Modèles d'éléments est ajouté.
Jeu de données Pour un jeu de données Modèles d'éléments:
Sélectionnez ou saisissez des modèles d'hôte et d'élément; les données des éléments correspondant à ces modèles seront affichées sur le graphique; jusqu'à 50 éléments peuvent être affichés.
Des modèles avec caractères génériques peuvent être utilisés pour la sélection (par exemple, * renverra les résultats correspondant à zéro ou plusieurs caractères).
Pour spécifier un modèle avec caractère générique, saisissez la chaîne manuellement et appuyez sur Entrée.
Le symbole générique est toujours interprété, il n'est donc pas possible d'ajouter, par exemple, un élément nommé item* individuellement s'il existe d'autres éléments correspondants (par exemple, item2, item3).
La spécification de modèles d'hôte et d'élément est obligatoire pour les jeux de données "Modèles d'éléments".
Voir aussi: Détails de configuration du jeu de données.

Pour un jeu de données Liste d'éléments:
Sélectionnez des éléments pour le graphique en cliquant sur le bouton Ajouter un élément.
Depuis Zabbix 7.0.1, vous pouvez également sélectionner des widgets compatibles comme source de données pour les éléments en cliquant sur le bouton Ajouter un widget.
La spécification d'éléments ou de widgets est obligatoire pour les jeux de données "Liste d'éléments".
Voir aussi: Détails de configuration du jeu de données.

Notez que seuls les types d'éléments numériques sont autorisés.

Lors de la configuration du widget sur un tableau de bord de modèle, le paramètre permettant de spécifier des modèles d'hôte n'est pas disponible, et le paramètre permettant de spécifier une liste d'éléments permet de sélectionner uniquement les éléments configurés sur le modèle.
Tracer Choisissez le type de tracé de la métrique.
Types de tracé possibles: Line (défini par défaut), Points, Staircase et Bar.
Notez que s'il n'y a qu'un seul point de données dans le graphique en ligne/escalier, il est tracé comme un point quel que soit le type de tracé. La taille du point est calculée à partir de la largeur de ligne, mais elle ne peut pas être inférieure à 3 pixels, même si la largeur de ligne est plus petite.
Empilé Cochez la case pour afficher les données sous forme empilée (zones remplies affichées).
Cette option est désactivée lorsque le type de tracé Points est sélectionné.
Largeur Définissez la largeur de ligne.
Cette option est disponible lorsque le type de tracé Line ou Staircase est sélectionné.
Taille du point Définissez la taille du point.
Cette option est disponible lorsque le type de tracé Points est sélectionné.
Transparence Définissez le niveau de transparence.
Remplissage Définissez le niveau de remplissage.
Cette option est disponible lorsque le type de tracé Line ou Staircase est sélectionné.
Données manquantes Sélectionnez l'option d'affichage des données manquantes:
Aucune - l'écart est laissé vide;
Connectées - deux valeurs de bord sont reliées;
Traiter comme 0 - les données manquantes sont affichées comme des valeurs 0;
Dernière connue - les données manquantes sont affichées avec la même valeur que la dernière valeur connue; non applicable pour les types de tracé Points et Bar.
Axe Y Sélectionnez le côté du graphique où l'axe Y sera affiché.
Décalage temporel Spécifiez un décalage temporel si nécessaire.
Vous pouvez utiliser des suffixes de temps dans ce champ. Les valeurs négatives sont autorisées.
Fonction d'agrégation Spécifiez la fonction d'agrégation à utiliser pour chaque élément ou pour un jeu de données entier dans l'intervalle d'agrégation sélectionné:
min - afficher la plus petite valeur;
max - afficher la plus grande valeur;
avg - afficher la valeur moyenne;
sum - afficher la somme des valeurs;
count - afficher le nombre de valeurs;
first - afficher la première valeur;
last - afficher la dernière valeur.
Si non utilisé est sélectionné, toutes les valeurs sont affichées (aucune agrégation).

Seules les données numériques peuvent être affichées pour min, max, avg et sum. Pour count, les données non numériques seront converties en numériques.
Voir aussi: Agrégation dans les graphiques.
Intervalle d'agrégation Spécifiez l'intervalle pour agréger les valeurs.
Vous pouvez utiliser des suffixes de temps dans ce champ. Une valeur numérique sans suffixe sera considérée comme des secondes.

Notez que si le widget est configuré pour afficher des données historiques basées sur des tendances (Sélection des données d'historique est défini sur Tendances ou Auto), il est recommandé d'utiliser un intervalle d'agrégation multiple de 1 heure (par exemple, 3600, 60m, 1h, 3h, etc.). Les tendances stockent des valeurs agrégées par heure, donc l'utilisation d'un intervalle d'agrégation qui n'est pas un multiple de 1 heure (par exemple, 100s, 7min, 15min, 90min, etc.) peut conduire à des résultats difficiles à interpréter.
Agréger Spécifiez s'il faut agréger:
Chaque élément - chaque élément du jeu de données sera agrégé et affiché séparément;
Jeu de données - tous les éléments du jeu de données seront agrégés et affichés comme une seule valeur.
Approximation Spécifiez quelle valeur afficher lorsqu'il existe plus d'une valeur par pixel vertical du graphique:
all - afficher les plus petite, plus grande et moyenne valeurs;
min - afficher la plus petite valeur;
max - afficher la plus grande valeur;
avg - afficher la valeur moyenne.

Ce paramètre est utile lors de l'affichage d'un graphique sur une longue période avec un intervalle de mise à jour fréquent (par exemple, une année de valeurs collectées toutes les 10 minutes).
Libellé du jeu de données Spécifiez le libellé du jeu de données affiché dans la configuration Jeu de données du graphique et dans la Légende du graphique (pour les jeux de données agrégés).
Tous les jeux de données sont numérotés, y compris ceux avec un Libellé du jeu de données spécifié. Si aucun libellé n'est spécifié, le jeu de données sera libellé automatiquement selon son numéro (par exemple, "Jeu de données #2", "Jeu de données #3", etc.). La numérotation des jeux de données est recalculée après le réordonnancement/le glisser-déposer des jeux de données.
Les libellés de jeu de données trop longs seront raccourcis pour tenir dans l'espace d'affichage (par exemple, "Number of proc...").
Détails de configuration du jeu de données

Les jeux de données existants sont affichés dans une liste. Vous pouvez :

  • Cliquer sur l'icône de déplacement et faire glisser un jeu de données vers un nouvel emplacement dans la liste.
  • Cliquer sur l'icône d'extension pour développer les détails du jeu de données. Une fois développé, cette icône devient une icône de réduction .
  • Cliquer sur l'icône de couleur pour modifier la couleur, soit à l'aide du sélecteur de couleurs, soit manuellement. Pour le jeu de données Item patterns, la couleur est utilisée pour calculer différentes nuances de couleur pour chaque élément. Pour le jeu de données Item list, la couleur est utilisée pour l'élément spécifié.
  • Cliquer sur le bouton Add new data set pour ajouter un jeu de données vide permettant de sélectionner des modèles d'hôte et d'élément. Si vous cliquez sur l'icône pointant vers le bas à côté du bouton Add new data set, un menu déroulant apparaît, vous permettant d'ajouter un nouveau jeu de données Item patterns ou Item list, ou de Clone le jeu de données actuellement ouvert. Si tous les jeux de données sont réduits, l'option Clone n'est pas disponible.

Le jeu de données Item patterns contient les champs Host patterns et Item patterns, qui reconnaissent tous deux les noms complets ou les motifs contenant un symbole générique (*). Cette fonctionnalité vous permet de sélectionner tous les noms d'hôte et les noms d'élément contenant le motif sélectionné. Lors de la saisie du nom de l'élément ou du motif d'élément dans le champ Item patterns, seuls les éléments appartenant au(x) nom(s) d'hôte sélectionné(s) sont affichés dans la liste déroulante.

Par exemple, après avoir saisi le motif z* dans le champ Host patterns, la liste déroulante affiche tous les noms d'hôte contenant ce motif : z*, Zabbix server, Zabbix proxy. Après avoir appuyé sur Enter, ce motif est accepté et affiché sous la forme z*. De même, après avoir saisi le motif a* dans le champ Item patterns, la liste déroulante affiche tous les noms d'élément contenant ce motif : a*, Available memory, Available memory in %.

Après avoir appuyé sur Enter, le motif est accepté et affiché sous la forme a*. Le graphique affiche alors tous les éléments appartenant au(x) nom(s) d'hôte sélectionné(s).

Le jeu de données Item list contient le bouton Add item qui vous permet d’ajouter des éléments à afficher sur le graphique. Depuis Zabbix 7.0.1, vous pouvez également ajouter des widgets compatibles comme source de données pour les éléments en cliquant sur le bouton Add widget.

Par exemple, cliquer sur le bouton Add item ouvre une fenêtre contextuelle contenant un paramètre Host. Une fois un hôte sélectionné, tous ses éléments disponibles à la sélection sont affichés dans une liste. Après avoir sélectionné un ou plusieurs éléments, ils seront affichés dans la liste des éléments du jeu de données et dans le graphique.

Agrégation dans les graphiques

L'agrégation permet d'afficher une valeur agrégée (minimum, maximum, moyenne, etc.) sur un intervalle de temps spécifié (5 minutes, une heure, un jour, etc.) au lieu de toutes les valeurs individuelles. Au sein d'un ensemble de données, l'agrégation peut être appliquée soit à chaque élément séparément, soit à l'ensemble de l'ensemble de données.

Voici quelques cas d'utilisation possibles de la fonction d'agrégation :

  • Le nombre moyen de requêtes vers un serveur Nginx par jour.
  • L'espace disque le plus faible parmi les clusters par semaine.

Dans l'exemple suivant, la fonction d'agrégation "max" est appliquée à l'élément avec un intervalle d'agrégation de cinq minutes :

L'exemple montre la charge CPU maximale sur cinq minutes (agrégée à partir de valeurs moyennes sur une minute), comparée à la charge CPU moyenne sur cinq minutes.

Lorsque Afficher la fonction d'agrégation est sélectionné pour la légende, les éléments sont affichés entre parenthèses, précédés de la fonction d'agrégation dans la légende et l'infobulle. Si Libellé de l'ensemble de données est spécifié pour un graphique, le libellé est affiché entre parenthèses, précédé de la fonction d'agrégation.

Affichage des options

L'onglet Affichage des options permet de définir la sélection des données d'historique :
Sélection des données d'historique Définissez la source des données du graphique :
Auto - les données sont récupérées selon l'algorithme classique du graphique (par défaut) ;
History - données issues de l'historique ;
Trends - données issues des tendances.
Déclencheurs simples Cochez la case pour afficher les seuils de déclenchement des déclencheurs simples. Les seuils seront tracés sous forme de lignes pointillées en utilisant la couleur de sévérité du déclencheur.
Un déclencheur simple est un déclencheur avec une seule fonction (uniquement last, max, min, avg) pour un élément dans l'expression.
Un maximum de trois déclencheurs peut être tracé. Notez que le déclencheur doit se trouver dans la plage affichée pour être visible.
Temps de travail Cochez la case pour afficher le temps de travail sur le graphique. Le temps de travail (jours ouvrés) est affiché dans les graphiques sur fond blanc, tandis que le temps non travaillé est affiché en gris (avec le thème d'interface par défaut Original blue).
Ligne de percentile (gauche) Cochez la case et saisissez la valeur du percentile pour afficher le percentile spécifié sous forme de ligne sur l'axe Y gauche du graphique.
Par exemple, si un percentile de 95 % est défini, la ligne de percentile se situera au niveau où 95 % des valeurs sont en dessous.
Ligne de percentile (droite) Cochez la case et saisissez la valeur du percentile pour afficher le percentile spécifié sous forme de ligne sur l'axe Y droit du graphique.
Par exemple, si un percentile de 95 % est défini, la ligne de percentile se situera au niveau où 95 % des valeurs sont en dessous.

Période de temps

L'onglet Période de temps permet de définir une période pour laquelle afficher les données dans le graphique :
Période de temps Sélectionnez la source de données pour la période de temps :
Tableau de bord - définit le sélecteur Période de temps comme source de données ;
Widget - définit un widget compatible spécifié dans le paramètre Widget comme source de données ;
Personnalisé - définit la période de temps spécifiée dans les paramètres De et À comme source de données ; si cette option est définie, une icône d'horloge s'affichera dans le coin supérieur droit du widget, indiquant l'heure définie au survol de la souris.
Widget Saisissez ou sélectionnez un widget compatible comme source de données pour la période de temps.
Ce paramètre est disponible si Période de temps est défini sur "Widget".
De Saisissez ou sélectionnez le début de la période de temps.
La syntaxe de temps relatif (now, now/d, now/w-1w, etc.) est prise en charge.
Ce paramètre est disponible si Période de temps est défini sur "Personnalisé".
À Saisissez ou sélectionnez la fin de la période de temps.
La syntaxe de temps relatif (now, now/d, now/w-1w, etc.) est prise en charge.
Ce paramètre est disponible si Période de temps est défini sur "Personnalisé".

Axes

L'onglet Axes permet de personnaliser l'affichage des axes :
Left Y Cochez cette case pour rendre l'axe Y gauche visible.
La case à cocher peut être désactivée si elle n'est pas sélectionnée dans l'onglet Data set ou Overrides.
Right Y Cochez cette case pour rendre l'axe Y droit visible.
La case à cocher peut être désactivée si elle n'est pas sélectionnée dans l'onglet Data set ou Overrides.
X-Axis Décochez cette case pour masquer l'axe X (coché par défaut).
Min Définissez la valeur minimale de l'axe correspondant.
La valeur minimale de la plage visible de l'axe Y est spécifiée.
Max Définissez la valeur maximale de l'axe correspondant.
La valeur maximale de la plage visible de l'axe Y est spécifiée.
Units Choisissez l'unité des valeurs de l'axe du graphique dans la liste déroulante.
Si l'option Auto est choisie, les valeurs de l'axe sont affichées à l'aide des unités du premier élément de l'axe correspondant.
L'option Static permet d'attribuer un nom personnalisé à l'axe correspondant. Si l'option Static est choisie et que le champ de saisie value est laissé vide, le nom de l'axe correspondant ne sera composé que d'une valeur numérique.

Légende

L’onglet Légende permet de personnaliser la légende du graphique :
Afficher la légende Décochez cette case pour masquer la légende sur le graphique (cochée par défaut).
Afficher min/moy/max Cochez cette case pour afficher les valeurs minimale, moyenne et maximale de l’élément dans la légende.
Afficher la fonction d’agrégation Cochez cette case pour afficher la fonction d’agrégation dans la légende.
Lignes Sélectionnez le mode d’affichage des lignes de la légende :
Fixe - le nombre de lignes affichées est déterminé par la valeur du paramètre Nombre de lignes ;
Variable - le nombre de lignes affichées est déterminé par la quantité d’éléments configurés sans dépasser la valeur du paramètre Nombre maximal de lignes.
Nombre de lignes/
Nombre maximal de lignes		 Si Lignes est défini sur « Fixe », définissez le nombre de lignes de légende à afficher (1-10).
Si Lignes est défini sur « Variable », définissez le nombre maximal de lignes de légende à afficher (1-10).
Nombre de colonnes Définissez le nombre de colonnes de légende à afficher (1-4).
Ce paramètre est disponible si Afficher min/moy/max n’est pas coché.

Problèmes

L'onglet Problèmes permet de personnaliser l'affichage des problèmes :
Afficher les problèmes Cochez cette case pour activer l'affichage des problèmes sur le graphique (non cochée, c'est-à-dire désactivée par défaut).
Éléments sélectionnés uniquement Cochez cette case pour n'inclure que les problèmes des éléments sélectionnés à afficher sur le graphique.
Hôtes des problèmes Sélectionnez les hôtes des problèmes à afficher sur le graphique.

Des motifs génériques peuvent être utilisés (par exemple, * renverra les résultats correspondant à zéro ou plusieurs caractères).
Pour spécifier un motif générique, saisissez simplement la chaîne manuellement et appuyez sur Entrée.
Pendant la saisie, observez comment tous les hôtes correspondants s'affichent dans la liste déroulante.

Ce paramètre n'est pas disponible lors de la configuration du widget sur un tableau de bord de modèle.
Gravité Cochez les niveaux de gravité des problèmes pour filtrer les problèmes à afficher sur le graphique.
Si aucune gravité n'est cochée, tous les problèmes seront affichés.
Problème Spécifiez le nom du problème à afficher sur le graphique.
Balises de problème Spécifiez des balises de problème pour limiter le nombre de problèmes affichés dans le widget.
Il est possible d'inclure ainsi que d'exclure des balises et des valeurs de balises spécifiques. Plusieurs conditions peuvent être définies. La correspondance du nom de balise est toujours sensible à la casse.

Plusieurs opérateurs sont disponibles pour chaque condition :
Existe - inclure les noms de balises spécifiés ;
Égal à - inclure les noms et valeurs de balises spécifiés (sensible à la casse) ;
Contient - inclure les noms de balises spécifiés dont les valeurs de balise contiennent la chaîne saisie (correspondance de sous-chaîne, insensible à la casse) ;
N'existe pas - exclure les noms de balises spécifiés ;
N'est pas égal à - exclure les noms et valeurs de balises spécifiés (sensible à la casse) ;
Ne contient pas - exclure les noms de balises spécifiés dont les valeurs de balise contiennent la chaîne saisie (correspondance de sous-chaîne, insensible à la casse).

Il existe deux types de calcul pour les conditions :
Et/Ou - toutes les conditions doivent être remplies, les conditions ayant le même nom de balise seront regroupées par la condition Ou ;
Ou - une seule condition remplie suffit.

Remplacements

L'onglet Remplacements permet d'ajouter des remplacements personnalisés pour des jeux de données :

Les remplacements sont utiles lorsque plusieurs éléments sont sélectionnés pour un jeu de données à l'aide du caractère générique * et que vous souhaitez modifier la manière dont les éléments sont affichés par défaut (par exemple, la couleur de base par défaut ou toute autre propriété).

Les remplacements existants, le cas échéant, sont affichés dans une liste. Pour ajouter un nouveau remplacement :

  • Cliquez sur le bouton
  • Sélectionnez les hôtes et les éléments pour le remplacement. Vous pouvez également saisir des modèles d'hôte et d'élément. Des modèles avec caractères génériques peuvent être utilisés (par exemple, * renverra les résultats correspondant à zéro ou plusieurs caractères). Pour spécifier un modèle avec caractère générique, saisissez simplement la chaîne manuellement et appuyez sur Entrée. Pendant la saisie, notez que tous les hôtes correspondants sont affichés dans la liste déroulante. Le symbole générique est toujours interprété, il n'est donc pas possible d'ajouter individuellement, par exemple, un élément nommé "item*" s'il existe d'autres éléments correspondants (par ex. item2, item3). Les paramètres de modèle d'hôte et de modèle d'élément sont obligatoires. Le paramètre permettant de spécifier des modèles d'hôte n'est pas disponible lors de la configuration du widget sur un tableau de bord de modèle. Le paramètre permettant de spécifier une liste d'éléments permet de sélectionner uniquement les éléments configurés sur le modèle lors de la configuration du widget sur un tableau de bord de modèle.
  • Cliquez sur , pour sélectionner les paramètres de remplacement. Au moins un paramètre de remplacement doit être sélectionné. Pour les descriptions des paramètres, voir l'onglet Jeu de données ci-dessus.

Les informations affichées par le widget de graphique peuvent être téléchargées sous forme d'image .png à l'aide du menu du widget :

Une capture d'écran du widget sera enregistrée dans le dossier Téléchargements.