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. | Nom | Description | | --- | --- | | Name | Le nom de la source de données. C'est ainsi que vous voyez la source de données dans les panneaux et les requêtes. | | Default | La source de données par défaut signifie qu'elle sera présélectionnée pour les nouveaux panneaux. | | URL | Le protocole HTTP, l'adresse IP et le port de votre installation graphite-web ou graphite-api. | | Access | Serveur (par défaut) = L'URL doit être accessible depuis le Grafana backend/server. | | Auth | | | Basic Auth | Activez l'authentification de base auprès de la source de données. | | User | Nom d'utilisateur pour l'authentification de base. | | Password | Mot de passe pour l'authentification de base. | | Custom HTTP Headers | Choisissez Ajouter un en-tête pour ajouter un en-tête HTTP personnalisé. | | Header | Entrez le nom de l'en-tête personnalisé. | | Value | Entrez la valeur d'en-tête personnalisée. | | Graphite details | | | Version | Sélectionnez votre version de Graphite. | | Type | Sélectionnez votre type de 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 Cross-Origin ressources (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 Graphite-specific requêtes 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 que`aliasByNode`, 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, utilisez`sortByName`. 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, utilisez`sortByName()`. ### 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.g``cpu.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. **Note** Cela signifie que les valeurs récapitulatives des légendes (max, min, total) ne peuvent pas toutes être correctes en même temps. Ils sont calculés côté client par Grafana. Et selon votre fonction de consolidation, seules une ou deux peuvent être correctes à la fois. ## 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. **Note** **Conseil :** La recherche d'expressions régulières peut être lente sur les balises à cardinalité élevée. Essayez donc d'utiliser d'autres balises pour réduire d'abord la portée. Commencer par un nom ou un espace de noms particulier permet de réduire les résultats. ## 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, consultez[Modèles et variables](templates-and-variables.md). Pour créer une variable à l'aide des valeurs des balises, utilisez les fonctions `tags` Grafana et. `tag_values` | Query | Description | | --- | --- | | tags() | Renvoie tous les tags. | | tags(server=\~backend\\\*) | Renvoie uniquement les balises qui apparaissent en série correspondant à l'expression du filtre. | | tag\_values(server) | Renvoie les valeurs de balise pour la balise spécifiée. | | tag\_values(server, server=\~backend\\\*) | Renvoie les valeurs de balise filtrées qui apparaissent pour la balise spécifiée dans les séries correspondant à ces expressions. | | tag\_values(server, server=\~backend\\\*, app=\~${apps:regex}) | Plusieurs expressions de filtre et expressions peuvent contenir d'autres variables. | Pour plus de détails, consultez la [documentation Graphite sur l'API de saisie semi-automatique pour les balises](https://graphite.readthedocs.io/en/latest/tags.html#auto-complete-support). ### 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. Query ``` 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 : + `$`Exemple : apps.frontend. $server.requests.count + `${varname}`Exemple : apps.frontend. $ {server} .requests.count 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 que`my.server${serverNumber}.count`. ### Utilisation de variables dans les requêtes de balises Multi-value les variables dans les requêtes de balises utilisent la syntaxe de formatage avancée introduite dans Grafana 5.0 pour les variables :. `{var:regex}` Non-tagles requêtes 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 de plus amples informations, veuillez consulter [Options avancées de format variable](templates-and-variables.md#advanced-variable-format-options). ## 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 de plus amples informations, veuillez consulter [Annotations](dashboard-annotations.md). Graphite propose deux méthodes pour interroger les annotations : + Une requête métrique normale. Pour cela, vous utilisez la zone de texte de **requête Graphite**. + Une requête d'événements Graphite. Pour cela, vous utilisez la zone de `Graphite event tags` texte et spécifiez une balise ou un caractère générique (le laisser vide devrait également fonctionner).