Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Graphe de nœuds
Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. Travailler dans la version 9 de Grafana
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. Travailler dans la version 8 de Grafana
Les graphes de nœuds peuvent visualiser des graphes orientés ou des réseaux. Ils utilisent une disposition de force dirigée pour positionner efficacement les nœuds, afin de faciliter l'affichage de cartes d'infrastructure complexes, de hiérarchies ou de diagrammes d'exécution.
Exigences relatives aux données
Un graphe de nœuds nécessite une forme spécifique des données pour pouvoir afficher ses nœuds et ses arêtes. Ce graphique ne permet pas de visualiser toutes les sources de données ou requêtes. Si vous souhaitez l'utiliser en tant que développeur de sources de données, consultez la section sur l'API de données.
Un graphe de nœuds est composé de nœuds et d'arêtes.
-
Un nœud est affiché sous forme de cercle. Un nœud peut représenter une application, un service ou tout autre élément pertinent du point de vue de l'application.
-
Une arête est affichée sous la forme d'une ligne reliant deux nœuds. La connexion peut être une demande, une opération ou une autre relation entre les deux nœuds.
Les nœuds et les arêtes peuvent être associés à des métadonnées ou à des statistiques. La source de données définit les informations et les valeurs affichées, de sorte que les différentes sources de données peuvent afficher différents types de valeurs ou ne pas en afficher certaines.
Nœuds
Habituellement, les nœuds affichent deux valeurs statistiques à l'intérieur du nœud et deux identifiants juste en dessous du nœud, généralement le nom et le type. Les nœuds peuvent également afficher un autre ensemble de valeurs sous la forme d'un cercle de couleur autour du nœud, avec des sections de couleurs différentes représentant différentes valeurs dont le total doit être égal à 1. Par exemple, le pourcentage d'erreurs peut être représenté par la partie rouge du cercle.
Des détails supplémentaires peuvent être affichés dans un menu contextuel, qui s'affiche lorsque vous choisissez le nœud. Il peut également y avoir des liens supplémentaires dans le menu contextuel qui peuvent cibler d'autres parties de l'espace de travail Grafana ou n'importe quel lien externe.
Note
Le graphe de nœuds ne peut afficher que 1 500 nœuds. Si cette limite est franchie, un avertissement est visible dans le coin supérieur droit et certains nœuds seront masqués. Vous pouvez développer les parties cachées du graphique en cliquant sur les marqueurs Nœuds cachés dans le graphique.
Edges
Les arêtes peuvent également afficher des statistiques lorsque vous survolez les arêtes. Comme pour les nœuds, vous pouvez ouvrir un menu contextuel contenant des informations et des liens supplémentaires en choisissant le bord.
La première source de données prenant en charge cette visualisation est la source de AWS X-Ray données de sa fonctionnalité de carte de service. Pour plus d’informations, consultez Se connecter à une source AWS X-Ray de données.
Navigation dans le graphe de nœuds
Casserole
Vous pouvez vous déplacer dans le graphe de nœuds en choisissant l'extérieur d'un nœud ou d'une arête et en faisant glisser le pointeur.
Zoomer ou dézoomer
Vous pouvez zoomer à l'aide des boutons situés dans le coin supérieur gauche du graphe de nœuds, ou à l'aide de la molette de la souris ou d'une autre saisie de défilement avec la touche Ctrl (ouCmd).
Explorez les nœuds cachés
Le nombre de nœuds affichés à un moment donné est limité afin de maintenir des performances raisonnables. Les nœuds situés en dehors de cette limite sont cachés derrière des marqueurs sélectionnables qui indiquent un nombre approximatif de nœuds cachés connectés à cette arête. Vous pouvez choisir le marqueur pour développer le graphique autour de ce nœud.
Vue de la grille
Vous pouvez passer à la vue en grille pour avoir une meilleure vue d'ensemble des nœuds les plus intéressants du graphique. La vue en grille montre les nœuds dans une grille sans arêtes et peut être triée en fonction des statistiques affichées à l'intérieur du nœud ou des statistiques représentées par la bordure colorée des nœuds.
Pour trier les nœuds, choisissez les statistiques dans la légende. Le marqueur situé à côté du nom de la statistique (˄ou˅) indique la statistique actuellement utilisée pour le tri et la direction du tri.
Choisissez un nœud, puis sélectionnez l'option Afficher dans le graphique pour revenir à la mise en page graphique en mettant l'accent sur le nœud sélectionné, afin de l'afficher dans le contexte du graphique complet.
API de données
Cette visualisation nécessite une forme spécifique des données à renvoyer depuis la source de données afin de les afficher correctement.
Node Graph nécessite au minimum un bloc de données décrivant les arêtes du graphe. Par défaut, le graphe de nœuds calcule les nœuds et toutes les statistiques en fonction de cette trame de données. Facultativement, une deuxième trame de données décrivant les nœuds peut être envoyée au cas où il serait nécessaire d'afficher davantage de métadonnées spécifiques aux nœuds. Vous devez définir frame.meta.preferredVisualisationType = 'nodeGraph' les deux blocs de données ou les nommer nodes et edges respectivement le rendu du graphe de nœuds.
Données d'arêtes issues de la structure
Champs obligatoires :
| Nom de champ | Type | Description |
|---|---|---|
id |
chaîne |
Identifiant unique de l'arête. |
source |
chaîne |
ID du nœud source. |
cible |
chaîne |
Identifiant de la cible. |
Champs facultatifs :
| Nom de champ | Type | Description |
|---|---|---|
mainstat |
chaîne/numéro |
Première statistique affichée dans la superposition lorsque vous survolez le bord. Il peut s'agir d'une chaîne indiquant la valeur telle quelle ou d'un nombre. S'il s'agit d'un nombre, toute unité associée à ce champ est également affichée. |
stat secondaire |
chaîne/numéro |
Identique à MainStat, mais affiché juste en dessous. |
détail__* |
chaîne/numéro |
Tout champ préfixé par |
Données des nœuds issues de la structure
Champs obligatoires :
| Nom de champ | Type | Description |
|---|---|---|
id |
chaîne |
Identifiant unique du nœud. Cet identifiant est référencé par arête dans ses champs source et cible. |
Champs facultatifs :
| Nom de champ | Type | Description |
|---|---|---|
title |
chaîne |
Nom du nœud visible juste en dessous du nœud. |
subtitle |
chaîne |
Identifiant supplémentaire, nom, type ou autre identifiant indiqué sous le titre. |
mainstat |
chaîne/numéro |
Première statistique affichée à l'intérieur du nœud lui-même. Il peut s'agir d'une chaîne indiquant la valeur telle quelle ou d'un nombre. S'il s'agit d'un nombre, toute unité associée à ce champ est également affichée. |
stat secondaire |
chaîne/numéro |
Identique à MainStat, mais affiché en dessous à l'intérieur du nœud. |
arc__* |
nombre |
Tout champ préfixé par un |
détail__* |
chaîne/numéro |
Tout champ préfixé par |
color |
chaîne/numéro |
Peut être utilisé pour spécifier une seule couleur au lieu d'utiliser les |
icon |
chaîne |
Nom de l'icône à afficher dans le nœud à la place des statistiques par défaut. Seules les icônes intégrées à Grafana sont autorisées (voir les icônes disponibles ici |
Rayon du nœud |
nombre |
Valeur du rayon en pixels. Utilisé pour gérer la taille des nœuds. |
surligné |
Booléen |
Définit si le nœud doit être surligné. Utilisez-le, par exemple, pour représenter un chemin spécifique dans le graphe en surlignant plusieurs nœuds et arêtes. La valeur par défaut est |
