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.
# Se connecter à une source GitLab de données
La source de GitLab données vous permet de suivre des GitLab statistiques détaillées, telles que les principaux contributeurs, les validations par jour ou les déploiements par jour. Vous pouvez également utiliser des variables de modèle, telles que des projets, pour configurer des filtres pour vos tableaux de bord. Vous pouvez combiner les données de l' GitLab API avec des données provenant d'autres sources.
**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).
## Limitations connues
Les alertes ne sont pas encore prises en charge sur ce plugin car les transformations ne sont pas prises en charge dans les requêtes d'alerte et les transformations sont le seul moyen d'obtenir des métriques agrégées significatives à partir des données brutes de GitLab l'API.
## Ajouter la source de données
1. Ouvrez la console Grafana dans l'espace de travail Amazon Managed Grafana et assurez-vous que vous êtes connecté.
1. Dans le menu latéral, sous **Configuration** (icône en forme de roue dentée), choisissez **Sources de données**.
1. Choisissez **Add data source**.
**Note**
Si le lien **Sources de données** n'apparaît pas dans le menu latéral, cela signifie que votre utilisateur actuel n'a pas le `Admin` rôle.
1. Sélectionnez dans **GitLab**la liste des sources de données.
1. Entrez les informations suivantes :
+ Dans **Nom**, entrez le nom de cette source GitLab de données.
+ Dans le champ **URL**, entrez l'URL racine de votre GitLab instance, par exemple**https://gitlab.com/api/v4**.
+ Pour le **jeton d'accès**, entrez votre jeton d'accès GitLab personnel.
## Interrogez la source GitLab de données
Dans l'éditeur de GitLab requêtes, vous pouvez sélectionner différents types de ressources, tels que des validations, des problèmes ou des versions.
**Filtrer et afficher les projets**
1. Dans le menu déroulant, sélectionnez **Projets**.
1. (Facultatif) Filtrez en fonction des projets que vous possédez.
1. Utilisez le menu déroulant et sélectionnez **Oui** ou **Non** pour filtrer les résultats.
**Note**
L'extraction de tous les projets **Owned = No** peut prendre beaucoup de temps.
**Filtrer et afficher les validations**
1. Dans le menu déroulant, choisissez **Commits**.
1. Utilisez le champ de saisie pour ajouter l'ID du projet.
1. (Facultatif) Pour filtrer par, branch/tag utilisez le champ de saisie pour ajouter une branch/tag référence.
**Filtrer et afficher les problèmes**
1. Dans le menu déroulant, sélectionnez **Problèmes**.
1. Utilisez le champ de saisie pour ajouter l'ID du projet.
1. (Facultatif) Pour filtrer par title/description, utilisez le champ de saisie pour rechercher les numéros en fonction de leur **titre** et de leur **description**.
**Afficher les communiqués**
1. Dans le menu déroulant, sélectionnez **Déploiements**.
1. Utilisez le champ de saisie pour ajouter l'ID du projet.
1. (Facultatif) Pour filtrer par environment/status, utilisez les champs de saisie. L'attribut **status** peut prendre l'une des valeurs suivantes : `created``running`,`success`,`failed`, ou`canceled`.
**Afficher les étiquettes**
1. Dans le menu déroulant, choisissez **Libellés**.
1. Utilisez le champ de saisie pour ajouter l'ID du projet.
## Modèles et variables
Pour ajouter une nouvelle variable de GitLab requête, consultez[Ajouter une variable de requête](variables-types.md#add-a-query-variable). Utilisez votre source de GitLab données comme source de données. Choisissez un type de ressource : **versions**, **projets** ou **étiquettes**.
Pour obtenir une liste dynamique de projets, d'étiquettes, etc. parmi lesquels choisir, créez une variable de type Requête. Les variables de type GitLab requête utilisent l'éditeur de requêtes pour interroger et renvoyer des projets, des étiquettes, etc. L'exemple suivant crée une variable de projet pour paramétrer vos requêtes.
**Créez une variable de projet pour paramétrer vos requêtes**
1. Ajoutez une variable de type **Query** named**project**.
1. Sélectionnez votre source GitLab de données et actualisez On **Dashboard Load**.
1. Sélectionnez le type de ressource **Projets**, **Oui** pour **Owned**, **nom** pour **le champ d'affichage** et **ID** pour **le champ de valeur**.
1. Choisissez **Mettre à jour** pour ajouter la variable au tableau de bord.
1. Ajoutez un nouveau panneau au tableau de bord et **$project** utilisez-le comme identifiant de projet.
Maintenant, lorsque vous choisissez dans la liste déroulante, vous obtenez les résultats qui appartiennent à ce projet.
## Utiliser les transformations de Grafana pour répondre aux questions courantes
Maintenant que vous pouvez effectuer des GitLab requêtes de base pour trouver des validations, des problèmes, etc., vous pouvez utiliser Transformations pour visualiser, agréger, regrouper et joindre des ensembles de données, ainsi que de nombreux autres types de transformations pour transformer des résultats simples en réponses à des questions complexes. Vous trouverez ci-dessous quelques questions courantes et la manière d'utiliser les transformations pour y répondre.
**Combien de commits/issues /déploiements par jour dans mon projet ?**
1. Ajoutez une requête. Sélectionnez **Commits** pour le type de ressource et ajoutez l'ID du projet.
1. **Ajouter un nouveau **groupe par** transformation : pour Grouper **par**, sélectionnez **created\_at\_date** puis calculate (Count) =id**
1. Choisissez la visualisation **graphique**.
**Quel est le délai moyen pour résoudre les problèmes liés à mon projet ?**
1. Ajoutez une requête. Sélectionnez **Problèmes** pour le type de ressource et ajoutez l'ID du projet.
1. ****Ajoutez un nouveau **champ d'ajout à partir de la transformation du calcul** : pour **Mode**, sélectionnez **Binary Operation, pour **Operation****, sélectionnez **closed\_at = created\_at et pour Alias, sélectionnez resolution\_time**.****
1. ****Ajoutez un nouveau **champ d'ajout à partir de la transformation du calcul** : pour **Mode**, sélectionnez **Binary Operation, pour **Operation****, sélectionnez **resolution\_time/86400000** et pour Alias, sélectionnez resolution\_time.****
Pour **Remplacer tous les champs**, choisissez **Vrai**.
1. Choisissez la visualisation des **statistiques**.
+ Afficher = Calculer
+ Calcul = moyenne
+ Champs = **resolution\_time**