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.

Connectez-vous à une source de données Graphite

Grafana dispose d'un éditeur de requêtes Graphite avancé qui vous permet de naviguer rapidement dans l'espace métrique, d'ajouter des fonctions, de modifier les paramètres des fonctions et bien plus encore. L'éditeur peut gérer tous les types de requêtes graphite. Il peut même gérer des requêtes imbriquées complexes grâce à l'utilisation de références de requête.

Réglages en graphite

Pour accéder aux paramètres Graphite, faites une pause sur l'icône de configuration (engrenage), puis choisissez Sources de données, puis choisissez la source de données Graphite.

Le mode d'accès contrôle la manière dont les demandes adressées à la source de données seront traitées. Le serveur doit être le moyen préféré si rien d'autre n'est indiqué.

Mode d'accès au serveur (par défaut)

Toutes les demandes sont envoyées depuis le navigateur à Amazon Managed Grafana, qui les transmet à la source de données, contournant ainsi les éventuelles exigences de partage des ressources entre origines (CORS). Si vous sélectionnez ce mode d'accès, l'URL doit être accessible depuis Amazon Managed Grafana.

Mode d'accès au navigateur

Amazon Managed Grafana ne prend pas en charge l'accès direct par navigateur à la source de données Graphite.

Éditeur de requêtes Graphite

Grafana inclut un éditeur de requêtes spécifique à Graphite pour vous aider à créer vos requêtes.

Pour voir le texte brut de la requête envoyée à Graphite, choisissez l'icône Activer le mode d'édition de texte (crayon).

Choix des métriques à interroger

Choisissez Sélectionner une métrique pour naviguer dans l'espace métrique. Après avoir démarré, vous pouvez continuer à utiliser le pointeur ou les flèches du clavier. Vous pouvez sélectionner un caractère générique et continuer.

Fonctions

Pour ajouter une fonction, cliquez sur l'icône plus à côté de Fonction. Vous pouvez rechercher la fonction ou la sélectionner dans le menu. Une fois qu'une fonction est sélectionnée, elle est ajoutée et vous vous concentrez sur la zone de texte du premier paramètre. Pour modifier ou modifier un paramètre, sélectionnez-le et il se transformera en zone de texte. - Pour supprimer une fonction, choisissez le nom de la fonction suivi de l'icône X.

Certaines fonctions, telles quealiasByNode, prennent en charge un deuxième argument facultatif. Pour ajouter un argument, faites une pause sur le premier argument, puis choisissez le + symbole qui apparaît. Pour supprimer le deuxième paramètre facultatif, sélectionnez-le et laissez-le vide. L'éditeur va le supprimer.

Trier les étiquettes

Si vous souhaitez une commande cohérente, utilisezsortByName. Cela peut être gênant lorsque vous avez les mêmes étiquettes sur plusieurs graphiques et qu'elles sont toutes deux triées différemment et utilisent des couleurs différentes. Pour résoudre ce problème, utilisezsortByName().

Requêtes imbriquées

Vous pouvez référencer les requêtes par la lettre de ligne sur laquelle elles se trouvent (comme dans Microsoft Excel). Si vous ajoutez une deuxième requête à un graphique, vous pouvez référencer la première requête en saisissant #A. Cela constitue un moyen pratique de créer des requêtes composées.

Éviter de nombreuses requêtes en utilisant des caractères génériques

Il peut arriver que vous souhaitiez voir plusieurs séries chronologiques tracées sur le même graphique. Par exemple, vous souhaiterez peut-être voir comment le processeur est utilisé sur une machine. Vous pouvez initialement créer le graphique en ajoutant une requête pour chaque série chronologique cpu.percent.user.gcpu.percent.system.g, telle que,, etc. Cela entraîne n requêtes adressées à la source de données, ce qui est inefficace.

Pour être plus efficace, vous pouvez utiliser des caractères génériques dans votre recherche, renvoyant toutes les séries chronologiques en une seule requête. Par exemple, cpu.percent.*.g.

Modification du nom de la métrique dans les tableaux ou les graphiques

Utilisez alias des fonctions pour modifier les noms des métriques sur les tableaux ou les graphiques Grafana ; par exemple, aliasByNode() ou. aliasSub()

Consolidation des points

Toutes les métriques Graphite sont consolidées afin que Graphite ne renvoie pas plus de points de données qu'il n'y a de pixels dans le graphique. Par défaut, cette consolidation est effectuée à l'aide de avg la fonction. Vous pouvez contrôler la manière dont Graphite consolide les métriques en ajoutant la fonction Graphite ConsolidateBy.

Combinaison de séries chronologiques

Pour combiner des séries chronologiques, choisissez Combiner dans la liste des fonctions.

Exploration des données et balises

Dans Graphite, tout est une étiquette.

Lors de l'exploration des données, les balises précédemment sélectionnées sont utilisées pour filtrer le jeu de résultats restant. Pour sélectionner des données, vous utilisez la seriesByTag fonction qui utilise des expressions de balises (=,, !==~,!=~) pour filtrer les séries chronologiques.

Le générateur de requêtes Grafana le fait automatiquement pour vous lorsque vous sélectionnez un tag.

Variables du modèle

Au lieu de coder en dur des éléments tels que le nom du serveur, de l'application et du capteur dans vos requêtes métriques, vous pouvez utiliser des variables à leur place. Les variables sont affichées sous forme de boîtes de sélection déroulantes en haut du tableau de bord. Vous pouvez utiliser ces listes déroulantes pour modifier les données affichées dans votre tableau de bord.

Pour plus d'informations sur les modèles et les variables de modèles, consultezModèles et variables.

Pour créer une variable à l'aide des valeurs des balises, utilisez les fonctions tags Grafana et. tag_values

Pour plus de détails, consultez la documentation Graphite sur l'API de saisie semi-automatique pour les balises.

Variable de requête

La requête que vous spécifiez dans le champ de requête doit être un type de requête de recherche métrique. Par exemple, une requête telle que prod.servers.* remplira la variable avec toutes les valeurs possibles qui existent dans la position générique.

Vous pouvez également créer des variables imbriquées qui utilisent d'autres variables dans leur définition. apps.$app.servers.*Utilise par exemple la variable $app dans sa définition de requête.

Utilisation __searchFilter pour filtrer les résultats des variables de requête

L'utilisation __searchFilter du champ de requête filtrera le résultat de la requête en fonction de ce que vous entrez dans la zone de sélection déroulante. Lorsque vous n'entrez rien, les valeurs par défaut __searchFilter sont * et « » lorsqu'elles sont utilisées dans le cadre d'une expression régulière.

L'exemple suivant montre comment l'utiliser dans __searchFilter le champ de requête pour activer la recherche server pendant que l'utilisateur saisit du texte dans la zone de sélection déroulante.

Requête

apps.$app.servers.$__searchFilter

TagValues

tag_values(server, server=~${__searchFilter:regex})

Utilisation variable

Vous pouvez utiliser une variable dans le chemin d'un nœud métrique ou en tant que paramètre d'une fonction.

Il existe deux syntaxes :

Pourquoi de deux manières ? La première syntaxe est plus facile à lire et à écrire mais ne permet pas d'utiliser une variable au milieu d'un mot. Utilisez la seconde syntaxe dans des expressions telles quemy.server${serverNumber}.count.

Utilisation de variables dans les requêtes de balises

Les variables à valeurs multiples dans les requêtes de balises utilisent la syntaxe de formatage avancée introduite dans Grafana 5.0 pour les variables :. {var:regex} Les requêtes sans balises utiliseront le format global par défaut pour les variables à valeurs multiples.

L'exemple de code suivant montre une expression de balise au format regex utilisant l'opérateur Equal Tilde,. =~

server=~${servers:regex}

Pour plus d’informations, consultez Options avancées de format variable.

Annotations

Les annotations vous permettent de superposer des informations détaillées sur les événements au-dessus des graphiques. Vous pouvez ajouter des requêtes d'annotation via le menu Tableau de bord/Vue des annotations. Pour plus d’informations, consultez Annotations.

Graphite propose deux méthodes pour interroger les annotations :