Se connecter à une source GitLab de données - Amazon Managed Grafana
Limitations connuesAjouter la source de donnéesInterrogez la source GitLab de donnéesModèles et variablesUtiliser les transformations de Grafana pour répondre aux questions courantes

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.

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.

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é.

  2. Dans le menu latéral, sous Configuration (icône en forme de roue dentée), choisissez Sources de données.

  3. 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.

  4. Sélectionnez dans GitLabla liste des sources de données.

  5. Entrez les informations suivantes :

    • Dans Nom, entrez le nom de cette source GitLab de données.

    • Pour URL, entrez l'URL racine de votre GitLab instance, par exemplehttps://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.

  2. (Facultatif) Filtrez selon les projets que vous possédez.

  3. 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.

  2. Utilisez le champ de saisie pour ajouter l'ID du projet.

  3. (Facultatif) Pour filtrer par branch/tag use the input field to add a branch/tag référence.

Filtrer et afficher les problèmes

  1. Dans le menu déroulant, sélectionnez Problèmes.

  2. Utilisez le champ de saisie pour ajouter l'ID du projet.

  3. (Facultatif) Pour filtrer par titre/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.

  2. Utilisez le champ de saisie pour ajouter l'ID du projet.

  3. (Facultatif) Pour filtrer par environnement/statut, utilisez les champs de saisie. L'attribut status peut prendre l'une des valeurs suivantes : createdrunning,success,failed, oucanceled.

Afficher les étiquettes

  1. Dans le menu déroulant, choisissez Libellés.

  2. Utilisez le champ de saisie pour ajouter l'ID du projet.

Modèles et variables

Pour ajouter une nouvelle variable de GitLab requête, consultezAjouter une variable de requête. 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 namedproject.

  2. Sélectionnez votre source GitLab de données et actualisez On Dashboard Load.

  3. Sélectionnez le type de ressource Projets, Oui pour Owned, nom pour le champ d'affichage et ID pour le champ de valeur.

  4. Choisissez Mettre à jour pour ajouter la variable au tableau de bord.

  5. 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 commits/issues/deployments par jour dans le cadre de mon projet ?

  1. Ajoutez une requête. Sélectionnez Commits pour le type de ressource et ajoutez l'ID du projet.

  2. Ajouter un nouveau groupe par transformation : pour Grouper par, sélectionnez created_at_date puis calculate (Count) =id

  3. Choisissez la visualisation graphique.

Quel est le délai moyen pour résoudre les problèmes de mon projet ?

  1. Ajoutez une requête. Sélectionnez Problèmes pour le type de ressource et ajoutez l'ID du projet.

  2. 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.

  3. 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.

  4. Choisissez la visualisation des statistiques.

    • Afficher = Calculer

    • Calcul = moyenne

    • Champs = resolution_time