Se connecter à une source de données Jira - Amazon Managed Grafana

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 de données Jira

Obtenez une vue d'ensemble de votre processus de développement en combinant les données relatives aux problèmes de Jira avec les données de performance des applications provenant d'autres sources.

Note

Cette source de données est réservée à Grafana Enterprise. Pour plus d’informations, consultez 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 plus d’informations, consultez Étendez votre espace de travail avec des plugins.

  • Créez des annotations en fonction de la création ou de la résolution des problèmes, pour voir la relation entre les problèmes et les indicateurs.

  • Suivez les statistiques détaillées de Jira, telles que le délai moyen de résolution et le traitement des problèmes.

Pour utiliser la source de données Jira, vous devez disposer d'un compte Atlassian ayant accès à un projet Jira.

Limitations connues

Les types de champs personnalisés issus des extensions Jira peuvent ne pas être pris en charge.

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 représentant une roue dentée), sélectionnez 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 Jira dans la liste des sources de données.

  5. Entrez les informations suivantes :

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

    • Pour URL, entrez l'URL racine de votre instance Atlassian, telle que. https://bletchleypark.atlassian.net

    • Pour Utilisateur, entrez une adresse e-mail pour le compte utilisateur/service.

    • Pour le jeton d'API, entrez un jeton d'API généré pour l'utilisateur.

Interrogez la source de données Jira

Dans l'éditeur de requêtes Jira, vous pouvez sélectionner des champs et des problèmes de requête.

La source de données Jira interroge Jira pour des problèmes, qui peuvent être liés à des bogues, à des témoignages d'utilisateurs, à des tickets d'assistance ou à d'autres tâches dans Jira.

Filtrer et afficher les problèmes
  1. Choisissez Champs, choisissez le menu déroulant et utilisez la saisie anticipée pour sélectionner l'un des champs de votre instance Jira, y compris les champs personnalisés. Quelques champs à essayer :

    • Résumé : nom du problème

    • Nom épique — L'épis à laquelle appartient un numéro

    • Estimation des points de scénario : nombre de points d'histoire estimés par l'équipe pour un problème

  2. Filtrez ou triez les problèmes. Pour ce faire, entrez une expression JQL valide pour filtrer ou trier les problèmes en fonction de l'un de leurs champs tels que Project, Assignee ou Sprint avec le langage de requête Atlassian JQL.

À partir de là, vous pouvez afficher vos données dans un tableau ou utiliser les transformations de Grafana pour manipuler les données d'émission, exécuter des calculs ou transformer les données en un graphique de série chronologique. Pour plus d’informations, consultez Appliquer une transformation.

Requête de séries chronologiques

Pour afficher les données de séries chronologiques, choisissez un champ Date ainsi qu'un champ numérique, puis passez à la visualisation graphique. Par exemple : date de début du sprint, estimation du Story Point.

L'exemple précédent, en lui-même, n'est pas très utile. Le champ numérique peut être (et sera très probablement) calculé à partir des transformations. L'utilisation de l'option Grouper par transformation permettrait de regrouper par date de début du sprint et de résumer l'estimation des points du récit, ce qui permettrait de visualiser les points de récit au fil du temps par sprint. Pour plus d'informations sur les transformations, consultez Appliquer une transformation.

Modèles et variables

Pour ajouter une nouvelle variable de requête Jira, consultezAjouter une variable de requête. Utilisez votre source de données Jira comme source de données.

Vous pouvez définir des variables sur vos tableaux de bord et les référencer dans des expressions JQL. Par exemple, vous pouvez créer un tableau de bord de statut de projet et choisir entre des projets, ou un tableau de bord de statut épique et choisir différentes épopées, ou un tableau de bord d'état des tâches et choisir différents responsables.

Pour obtenir une liste dynamique de projets, d'épopées, de responsables, etc. parmi lesquels choisir, créez une variable de type Requête. Les variables de type requête utilisent JQL pour interroger les problèmes et renvoyer des projets, des épopées, des destinataires ou tout ce qui concerne les problèmes. Voici un exemple :

Créez une variable assignée pour obtenir le statut des problèmes par personne assignée
  1. Ajoutez une variable de type Query namedassignee.

  2. Sélectionnez le champ : Destinataire.

  3. ) Facultatif) Ajoutez un filtre JQL project = « votre projet ».

  4. Choisissez Exécuter pour afficher la liste des personnes assignées.

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

  6. Ajoutez un nouveau panneau au tableau de bord et modifiez le JQL pour filtrer en utilisant votre nouvelle variable assignee = $assignee.

    Désormais, lorsque vous choisissez dans la liste déroulante, vous ne voyez que les problèmes assignés à cet utilisateur.

Les variables à valeurs multiples permettent de sélectionner plusieurs options et peuvent être utilisées dans le cadre de la clause IN. Par exemple, assignee IN ($assignee).

Utiliser les transformations de Grafana pour répondre aux questions courantes

Les macros sont des variables qui font référence à la fenêtre temporelle du tableau de bord afin que vous puissiez filtrer les problèmes uniquement dans la plage de la fenêtre du tableau de bord. Il existe 2 macros :

  • $__timeFrom

  • $__timeTo.

L'exemple de requête JQL suivant filtre les problèmes créés dans la fenêtre horaire du tableau de bord : createdDate >= $__timeFrom AND createdDate <= $__timeTo

Tirez le meilleur parti de la source de données

L'utilisation des transformations et des autres fonctionnalités intégrées de Grafana peut vous aider à visualiser de manière significative vos données Jira.

Utiliser des transformations pour améliorer JQL

Bien qu'il existe de nombreuses transformations parmi lesquelles choisir dans Grafana, les suivantes constituent une puissante augmentation qui donne à JQL certaines des fonctionnalités/pouvoirs du SQL.

Grouper par Cette transformation fournit une fonctionnalité clé qui ne fait pas partie de la syntaxe Jira JQL standard : le regroupement. À l'aide de la transformation Grouper par, vous pouvez les regrouper par sprints ou autres champs de problèmes, et les agréger par groupe pour obtenir des indicateurs tels que la vélocité et les estimations de points narratifs par rapport à la réalisation réelle d'un sprint.

Jointure externe Comme pour les jointures SQL, vous pouvez joindre deux requêtes ou plus par le biais de champs communs. Cela permet de combiner des ensembles de données issus de requêtes et d'utiliser d'autres transformations pour calculer des valeurs à partir de plusieurs requêtes/ensembles de données.

Ajouter un champ à partir d'un calcul Semblable aux expressions SQL, cette transformation permet d'ajouter de nouveaux champs à votre jeu de données en fonction des calculs d'autres champs. Les champs utilisés dans le calcul peuvent provenir d'une seule requête ou de requêtes que vous avez réunies. Vous pouvez également enchaîner des calculs et effectuer des calculs à partir de champs calculés.

Utiliser les transformations de Grafana pour répondre aux questions courantes

Vous pouvez utiliser les 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.

Comment afficher la vélocité par sprint ?

  1. Sélectionnez les champs : nom du sprint, estimation des points narratifs.

  2. Ajoutez un filtre JQL : project = "Your Project" AND type != epic AND status = done order by created ASC

  3. Ajouter un groupe par transformation :

    • Nom du sprint | Grouper par

    • Estimation des points narratifs | Calculer | Total

  4. Choisissez la visualisation Bar Gauage.

Comment puis-je montrer ce qui a été terminé par rapport à ce qui a été estimé lors d'un sprint ?

  1. Ajoutez une requête. Sélectionnez d'abord les champs : nom du sprint, date de début du sprint, estimation des points du scénario.

    Ajoutez ensuite un filtre JQL : project = 'Your Project' AND type != epic

  2. Ajoutez une deuxième requête. Sélectionnez d'abord les champs : nom du sprint, date de début du sprint, estimation des points du scénario.

    Ajoutez ensuite un filtre JQL : project = 'Your Project' AND type != epic AND status = done

  3. Ajouter un groupe par transformation :

    • Nom du sprint | Grouper par

    • Date de début du sprint | Regrouper par

    • Estimation des points narratifs | Calculer | Total

  4. 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 d'abord les champs : créé, statut, catégorie modifiée.

    Ajoutez ensuite un filtre JQL : project = 'Your Project' AND type != epic AND status = done

  2. Ajouter une transformation : Ajouter un champ à partir du calcul

    • Mode = Réduire la ligne

    • Calcul = Différence

  3. Ajouter une transformation : Ajouter un champ à partir du calcul

    • Mode = Opération binaire

    • Fonctionnement = Différence/86000000

    • Alias = Jours

  4. Ajouter une transformation : organiser les champs

    • Masquer un champ différent

  5. Ajouter une transformation : filtrer les données par valeurs

    • Type de filtre = Inclure

    • conditions = Correspond à n'importe laquelle

      • Champ = jours | Match = est supérieur | Valeur = 1

  6. Ajouter une transformation : Réduire

    • Mode = série par lignes

    • Calculs = moyenne

  7. Choisissez la visualisation des statistiques.