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 Wavefront (VMware Tanzu Observability by Wavefront)
La source de données Wavefront (VMware Tanzu Observability by Wavefront) permet aux utilisateurs d'Amazon Managed Grafana d'interroger et de visualiser les données qu'ils collectent directement depuis Wavefront et de les visualiser facilement aux côtés de toute autre source de données métriques, journaux, traceurs ou autres. Cette vue flexible à volet unique facilite le suivi de l'état du système et les problèmes de débogage.
**Note**
Cette source de données est réservée à Grafana Enterprise. Pour de plus amples informations, veuillez consulter [Gérer l'accès aux plug-ins d'entreprise](upgrade-to-enterprise-plugins.md).
En outre, dans les espaces de travail qui prennent en charge la version 9 ou une version plus récente, cette source de données peut nécessiter l'installation du plug-in approprié. Pour de plus amples informations, veuillez consulter [Étendez votre espace de travail avec des plugins](grafana-plugins.md).
## Qu'est-ce que Wavefront ?
[Wavefront](https://www.wavefront.com) est un outil de surveillance et d'analyse du cloud développé par VMware. Wavefront est un service hébergé dans le cloud où vous envoyez vos données chronologiques (métriques), à partir de CollectD, StatsD, JMX, Ruby's logger ou d'autres outils. AWS Avec Wavefront, les utilisateurs peuvent effectuer des opérations mathématiques sur ces séries, afficher des graphiques pour détecter les anomalies KPIs, suivre et créer des alertes.
## Optimisez votre infrastructure technologique avec Wavefront et Grafana
Bien qu'à première vue, Grafana et Wavefront semblent similaires, de nombreuses entreprises utilisent Wavefront et Grafana comme éléments essentiels de leurs flux de travail d'observabilité.
**Visualisez sans déplacer les sources de données :** l'architecture unique de Grafana interroge les données directement là où elles se trouvent plutôt que de les déplacer et de payer pour un stockage et une ingestion redondants.
**Composez des panneaux à partir de sources variées** Avec des tableaux de bord prédéfinis et personnalisés, regroupez des données provenant de nombreuses sources de données différentes dans un seul panneau de verre.
**Transformation et calcul au niveau de l'utilisateur :** les utilisateurs peuvent transformer les données et exécuter divers calculs sur les données qu'ils voient, ce qui nécessite moins de préparation des données.
**Combinez, calculez et visualisez dans des panneaux :** créez des panneaux de sources de données mixtes qui affichent des données connexes provenant de Waveferont et d'autres sources, telles que Prometheus et InfluxDB.
## Documentation
### Caractéristiques
+ Visualisations de séries chronologiques
+ Visualisations de tableaux
+ Visualisations de cartes thermiques
+ Visualisations à statistiques uniques
+ Éditeur de requêtes guidées
+ Éditeur de requêtes SQL brut
+ Annotations pour les données d'événements
+ Variables du modèle
+ Filtres ad hoc
+ Alerte
### Configuration
La configuration de la source de données Wavefront est relativement simple. Seuls deux champs sont requis pour terminer la configuration : `API URL` et`Token`.
+ `API URL`sera l'URL que vous utiliserez pour accéder à votre environnement de front d'onde. Exemple: `https://myenvironment.wavefront.com`.
+ `Token`doit être généré à partir d'un compte utilisateur ou d'un compte de service.
1. **Pour créer un jeton basé sur un compte utilisateur, connectez-vous à votre environnement Wavefront, choisissez le rouage dans le coin supérieur droit de la page, choisissez votre nom d'utilisateur (par exemple`me@grafana.com`), sélectionnez l'onglet **Accès aux API** en haut de la page utilisateur, puis copiez une clé existante ou choisissez Générer.**
1. Pour créer un jeton basé sur un compte de service, connectez-vous à votre environnement Wavefront, choisissez le rouage dans le coin supérieur droit de la page, puis choisissez Gestion du compte. Dans le volet de navigation de gauche**, sélectionnez Comptes, groupes et rôles**, choisissez l'onglet **Comptes de service** en haut, puis choisissez **Créer un nouveau compte**. Entrez un nom pour le compte de service. Cela peut être tout ce que tu veux. Copiez le jeton fourni dans la section **Jetons**.
1. La dernière étape consiste à vérifier que la case **Comptes, groupes et rôles** est cochée sous **Autorisations**.
Une fois que vous avez le jeton, ajoutez-le au champ de `Token` configuration et vous devriez être prêt \$1
La page de configuration finalisée doit ressembler à ceci :
### Usage
#### Utilisation de l’éditeur de requêtes
L'éditeur de requêtes Wavefront dispose de deux modes : **Query Builder** et **Raw Query**. Pour passer de l'une à l'autre, utilisez le sélecteur en haut à droite du formulaire de requête :
En mode **Générateur de requêtes**, quatre choix s'offrent à vous :
1. Quelle métrique souhaitez-vous interroger ?
1. Quelle agrégation souhaitez-vous effectuer sur cette métrique ?
1. Comment souhaitez-vous filtrer les résultats de cette requête métrique ?
1. Voulez-vous appliquer des fonctions supplémentaires au résultat ?
Le sélecteur de mesures est une hiérarchie de catégories. Sélectionnez une catégorie, puis choisissez à nouveau pour explorer les sous-catégories. Répétez ce processus jusqu'à ce que vous ayez atteint la métrique souhaitée.
Après avoir sélectionné une métrique, les filtres et valeurs de filtre disponibles seront automatiquement renseignés pour vous.
En mode **Requête brute**, vous verrez un seul champ intitulé **Requête**. Cela vous permet d'exécuter n'importe quelle requête [WQL](#wavefront-references) de votre choix.
#### Utilisation de filtres
Le plugin Wavefront interrogera dynamiquement les filtres appropriés pour chaque métrique.
Pour ajouter un filtre, cliquez sur le **signe \$1** à côté de l'étiquette **Filtres** dans l'éditeur de requêtes Wavefront, sélectionnez le champ sur lequel vous souhaitez filtrer, puis sélectionnez une valeur à filtrer.
#### Utilisation de fonctions
Les fonctions fournissent un moyen supplémentaire d'agréger, de manipuler et d'effectuer des calculs sur les données de réponse métrique. Pour afficher les fonctions disponibles, choisissez la liste déroulante à côté de l'étiquette de fonction dans le **générateur de requêtes**. En fonction de la fonction que vous sélectionnez, vous pourrez effectuer d'autres actions, telles que définir un groupe par champ ou appliquer des seuils. Les utilisateurs peuvent enchaîner plusieurs fonctions pour effectuer des calculs avancés ou des manipulations de données.
#### Ajouter une variable de modèle de requête
1. Pour créer une nouvelle variable de modèle Wavefront pour un tableau de bord, choisissez le rouage des paramètres dans le coin supérieur droit du tableau de bord.
1. Dans le panneau de gauche, choisissez **Variables**.
1. En haut à droite de la page Variables, choisissez **Nouveau**.
1. Entrez un **nom** et une **étiquette** pour la variable de modèle que vous souhaitez créer. Le **nom** est la valeur que vous utiliserez dans les requêtes pour référencer la variable de modèle. **Label** est un nom convivial à afficher pour la variable de modèle dans le panneau de sélection du tableau de bord.
1. Sélectionnez le type **Requête** pour le champ de type (il doit être sélectionné par défaut).
1. Sous le titre **Options de requête**, sélectionnez **Wavefront** dans la liste déroulante **des sources de données**.
1. Voir [Structure de requête variable du modèle](#template-variable-query-structure) pour plus de détails sur ce qui doit être saisi dans le champ **Requête**.
1. Si vous souhaitez filtrer l'une des valeurs renvoyées par votre requête, entrez une expression régulière dans le champ de saisie **Regex**.
1. Appliquez toutes les préférences de tri que vous pourriez avoir en choisissant un type de tri dans la liste déroulante **Trier**.
1. Après avoir vérifié la configuration, choisissez **Ajouter** pour ajouter la variable de modèle, puis sélectionnez **Enregistrer le tableau de bord** dans le panneau de navigation de gauche pour enregistrer vos modifications.
#### Structure de requête variable du modèle
listes de mesures : métriques : ts (...)
listes de sources : sources : ts (...)
listes de balises source : SourceTags : ts (...)
listes de balises source correspondantes matchingSourceTags : ts (...)
listes de noms de balises : TagNames : ts (...)
listes de valeurs de balises : tagValues () : ts (...)
**Remarques**
+ Le s à la fin de chaque type de requête est facultatif.
+ Support pour toutes les minuscules. Vous pouvez utiliser des tagnames ou des tagNames, mais pas des TAGNAMES.
+ L'utilisation d'espaces autour du : est facultative
**WARNING**
`Multi-value`et ne `Include All option` sont actuellement pas pris en charge par le plugin Wavefront.
#### Utilisation de variables de modèle
Après avoir effectué les étapes d'[ajout d'une nouvelle variable de modèle](#wavefront-adding-a-query-template-variable-1), vous êtes maintenant prêt à utiliser la variable de modèle dans les panneaux de votre tableau de bord pour créer des visualisations dynamiques.
1. Ajoutez un nouveau panneau de tableau de bord à l'aide de l'icône Panel\$1 dans le coin supérieur droit de votre tableau de bord.
1. Sélectionnez l'agrégat que vous souhaitez utiliser pour votre requête.
1. Cliquez sur l'icône \$1 à côté de l'étiquette **Filtres** et sélectionnez le type de clé correspondant à votre variable de modèle. `host=`pour un filtre hôte, par exemple.
1. Entrez le nom de la variable de modèle que vous avez créée dans le champ de saisie **Valeur** du filtre.
1. Enregistrez le tableau de bord.
Vous devriez maintenant être en mesure de parcourir les différentes valeurs de votre variable de modèle et de mettre à jour votre panneau de manière dynamique \$1
#### Utilisation de filtres ad hoc
Pour utiliser des filtres ad hoc, nous devons créer deux variables de modèle. La première est une variable d'assistance qui sera utilisée pour sélectionner une métrique afin que des filtres supplémentaires puissent être remplis pour le nom de cette métrique. L'autre sera la variable de filtre ad hoc réelle.
**Important**
La variable d'assistance requise doit être nommée`metriclink`. Il peut s'agir d'une variable personnalisée avec la liste des mesures que vous souhaitez utiliser ou d'une variable basée sur une requête utilisant la [structure de requête de variables du modèle](#template-variable-query-structure). Si vous souhaitez remplir les champs de filtre ad hoc uniquement avec les valeurs d'une seule métrique, vous pouvez masquer la variable de `metriclink` modèle.
Après avoir créé la `metriclink` variable, vous pouvez désormais ajouter le filtre ad hoc en suivant les mêmes étapes que celles décrites dans la section [Ajout d'une variable de modèle de requête](#wavefront-adding-a-query-template-variable-1). La différence est que vous allez sélectionner des **filtres ad hoc** comme **type** et qu'aucune entrée n'est requise pour une requête.
#### Ajouter des annotations
1. Pour créer une nouvelle annotation Wavefront pour un tableau de bord, choisissez le rouage des paramètres dans le coin supérieur droit du tableau de bord.
1. Dans le panneau de gauche, choisissez **Annotations.**
1. En haut à droite de la page Annotations, choisissez **Nouveau**.
1. Entrez le nom de l'annotation (celui-ci sera utilisé comme nom du bouton sur le tableau de bord).
1. Sélectionnez la **source de données** de Wavefront.
1. Par défaut, les annotations sont limitées à 100 événements d'alerte qui seront renvoyés. Pour changer cela, définissez le champ **Limite** sur la valeur que vous souhaitez.
1. Choisissez **Ajouter**.
#### Utilisation d'annotations
Lorsque les annotations sont activées, vous devriez désormais voir les événements d'alerte et les problèmes liés à une période donnée.
Si vous faites une pause au bas d'une section annotée d'une visualisation, une fenêtre contextuelle s'affiche. Elle indique le nom de l'alerte et fournit un lien direct vers l'alerte dans Wavefront.
#### Utilisation du champ Nom d'affichage
Cette source de données utilise le champ Nom d'affichage dans l'onglet Champ du panneau Options pour raccourcir ou modifier une clé de légende en fonction de son nom, de ses étiquettes ou de ses valeurs. D'autres sources de données utilisent des `alias` fonctionnalités personnalisées pour modifier les clés de légende, mais la fonction Display Name permet de le faire de manière plus cohérente.
### Références
+ [WQL (langage de requête Wavefront)](https://docs.wavefront.com/query_language_reference.html)