Stellen Sie eine Connect zu einer Jira-Datenquelle her

Verschaffen Sie sich ein Gesamtbild Ihres Entwicklungsprozesses, indem Sie Problemdaten aus Jira mit Anwendungsleistungsdaten aus anderen Quellen kombinieren.

Anmerkung

Diese Datenquelle ist nur für Grafana Enterprise bestimmt. Weitere Informationen finden Sie unter Zugriff auf Enterprise-Plug-ins verwalten.

In Workspaces, die Version 9 oder neuer unterstützen, müssen Sie für diese Datenquelle möglicherweise außerdem das entsprechende Plugin installieren. Weitere Informationen finden Sie unter Erweitere deinen Workspace mit Plugins.

• Erstellen Sie Anmerkungen auf der Grundlage der Problemerstellung oder -lösung, um die Beziehung zwischen Problemen und Kennzahlen zu ermitteln.

• Verfolge detaillierte Jira-Statistiken, wie etwa die durchschnittliche Zeit bis zur Lösung und den Durchsatz von Problemen.

Um die Jira-Datenquelle verwenden zu können, benötigst du ein Atlassian-Konto mit Zugriff auf ein Jira-Projekt.

Bekannte Beschränkungen

Benutzerdefinierte Feldtypen von Jira-Addons werden möglicherweise nicht unterstützt.

Die Datenquelle wird hinzugefügt

1. Öffnen Sie die Grafana-Konsole im Amazon Managed Grafana-Arbeitsbereich und stellen Sie sicher, dass Sie angemeldet sind.

2. Wählen Sie im Seitenmenü unter Konfiguration (das Zahnradsymbol) die Option Datenquellen aus.

3. Wählen Sie Datenquelle hinzufügen aus.

   Anmerkung

   Wenn Sie den Link Datenquellen nicht in Ihrem Seitenmenü sehen, bedeutet dies, dass Ihr aktueller Benutzer die Admin Rolle nicht hat.

4. Wählen Sie Jira aus der Liste der Datenquellen aus.

5. Geben Sie die folgenden Informationen ein:

   • Geben Sie unter Name einen Namen für diese Jira-Datenquelle ein.

   • Gib als URL die Root-URL für deine Atlassian-Instanz ein, z. B. https://bletchleypark.atlassian.net

   • Gib unter Benutzer eine E-Mail-Adresse für das Benutzer-/Dienstkonto ein.

   • Geben Sie für API-Token ein API-Token ein, das für den Benutzer generiert wurde.

Fragen Sie die Jira-Datenquelle ab

Im Jira Query Editor können Sie Felder auswählen und Probleme abfragen.

Die Jira-Datenquelle fragt Jira nach Issues ab. Dabei kann es sich um Bugs, User Stories, Support-Tickets oder andere Aufgaben in Jira handeln

Probleme filtern und anzeigen

1. Wähle „Felder“, wähle das Drop-down-Menü aus und verwende die Eingabemaske, um aus beliebigen Feldern in deiner Jira-Instanz, einschließlich benutzerdefinierter Felder, auszuwählen. Einige Felder zum Ausprobieren:

   • Zusammenfassung — Der Name des Problems

   • Epischer Name — Die Episoden, zu denen eine Ausgabe gehört

   • Story-Point-Schätzung — Die Anzahl der Story Points, die das Team für ein Problem geschätzt hat

2. Filtere oder sortiere die Probleme. Gib dazu mit der Atlassian-Abfragesprache JQL einen gültigen JQL-Ausdruck ein, um die Probleme anhand ihrer Felder wie Project, Assignee oder Sprint zu filtern oder zu sortieren.

Von hier aus können Sie Ihre Daten in einer Tabelle anzeigen oder Grafana-Transformationen verwenden, um diese Problemdaten zu bearbeiten, Berechnungen auszuführen oder die Daten in ein Zeitreihendiagramm umzuwandeln. Weitere Informationen finden Sie unter Eine Transformation anwenden.

Zeitreihenabfrage

Um Zeitreihendaten anzuzeigen, wählen Sie ein Datumsfeld zusammen mit einem numerischen Feld aus und wechseln Sie dann zur Grafikvisualisierung. Zum Beispiel: Sprint-Startdatum, Story-Point-Schätzung.

Das vorherige Beispiel allein ist nicht sehr nützlich. Das numerische Feld kann (und wird höchstwahrscheinlich auch) anhand von Transformationen berechnet werden. Die Verwendung der Option „Nach Transformation gruppieren“ würde eine Gruppierung nach dem Startdatum des Sprints und eine Zusammenfassung der Story-Point-Schätzung ermöglichen, sodass die Story Points im Zeitverlauf pro Sprint visualisiert werden könnten. Weitere Informationen zu Umwandlungen finden Sie unter Eine Transformation anwenden.

Vorlagen und Variablen

Informationen zum Hinzufügen einer neuen Jira-Abfragevariablen finden Sie unterHinzufügen einer Abfragevariablen. Verwenden Sie Ihre Jira-Datenquelle als Datenquelle.

Sie können Variablen in Ihren Dashboards definieren und sie in JQL-Ausdrücken referenzieren. Sie können beispielsweise ein Projektstatus-Dashboard erstellen und zwischen Projekten wählen, oder ein episches Status-Dashboard und verschiedene Epics oder ein Aufgabenstatus-Dashboard und verschiedene Verantwortliche auswählen.

Um eine dynamische Liste von Projekten, Epen, Verantwortlichen usw. zur Auswahl zu erhalten, erstelle eine Variable vom Typ Abfrage. Variablen vom Typ Abfrage verwenden JQL, um Probleme abzufragen und Projekte, Epen, Verantwortliche oder alles, was mit Problemen zu tun hat, zurückzugeben. Im Folgenden wird ein Beispiel gezeigt:

Erstellen Sie eine Assignee-Variable, um den Status von Problemen nach Beauftragtem abzurufen

1. Fügen Sie eine Variable vom Typ Abfrage mit dem Namen hinzu. assignee

2. Wählen Sie Feld: Beauftragter aus.

3. ) Optional) Fügen Sie einen JQL-Filter hinzu project = „Ihr Projekt“.

4. Wählen Sie Ausführen, um eine Liste der Beauftragten anzuzeigen.

5. Wählen Sie „Aktualisieren“, um die Variable zum Dashboard hinzuzufügen.

6. Fügen Sie dem Dashboard ein neues Panel hinzu und bearbeiten Sie die JQL, um mit Ihrer neuen Variablen assignee = $assignee zu filtern.

   Wenn Sie jetzt aus der Dropdownliste auswählen, sehen Sie nur die Probleme, die diesem Benutzer zugewiesen sind.

Variablen mit mehreren Werten ermöglichen die Auswahl mehrerer Optionen und können als Teil der IN-Klausel verwendet werden. Zum Beispiel Assignee IN ($assignee).

Verwendung von Transformationen von Grafana zur Beantwortung häufig gestellter Fragen

Makros sind Variablen, die auf das Dashboard-Zeitfenster verweisen, sodass Sie Probleme nur innerhalb des Bereichs des Dashboard-Fensters filtern können. Es gibt 2 Makros:

• $__timeFrom

• $__TimeTo.

Das folgende Beispiel für eine JQL-Abfrage filtert Probleme, die im Zeitfenster des Dashboards entstanden sind: createdDate >= $__timeFrom AND createdDate <= $__timeTo

Holen Sie das Beste aus der Datenquelle heraus

Mithilfe der Transformationen und anderer integrierter Funktionen von Grafana können Sie Ihre Jira-Daten aussagekräftig anzeigen.

Verwenden von Transformationen zur Erweiterung von JQL

In Grafana stehen zwar viele Transformationen zur Auswahl, aber die folgenden bieten eine leistungsstarke Erweiterung, um JQL einige der Funktionen/Leistungsfähigkeit von SQL zu verleihen.

Group By Diese Transformation bietet eine wichtige Funktion, die nicht Teil der Jira-JQL-Standardsyntax ist: Gruppierung. Mithilfe der Transformation „Gruppieren nach“ können Sie nach Sprints oder anderen Problemfeldern gruppieren und nach Gruppen aggregieren, um Kennzahlen wie Geschwindigkeit und Story-Point-Schätzungen im Vergleich zu den tatsächlich in einem Sprint abgeschlossenen Ergebnissen zu erhalten.

Äußere Verknüpfung Ähnlich wie bei SQL-Verknüpfungen können Sie zwei oder mehr Abfragen anhand gemeinsamer Felder miteinander verbinden. Dies bietet eine Möglichkeit, Datensätze aus Abfragen zu kombinieren und andere Transformationen zu verwenden, um Werte aus mehreren Abfragen/Datensätzen zu berechnen.

Feld aus Formel hinzufügen Ähnlich wie bei SQL-Ausdrücken ermöglicht diese Transformation das Hinzufügen neuer Felder zu Ihrem Datensatz auf der Grundlage von Berechnungen anderer Felder. Die in der Berechnung verwendeten Felder können aus einer einzelnen Abfrage oder aus Abfragen stammen, die Sie miteinander verknüpft haben. Sie können Berechnungen auch verketten und Berechnungen anhand berechneter Felder durchführen.

Verwendung von Transformationen von Grafana zur Beantwortung häufig gestellter Fragen

Sie können Transformationen verwenden, um Datensätze zu visualisieren, zu aggregieren, zu gruppieren und zu verbinden, zusammen mit vielen anderen Arten von Transformationen, um einfache Ergebnisse in Antworten auf komplexe Fragen umzuwandeln.

Wie zeige ich die Geschwindigkeit pro Sprint an?

1. Wählen Sie Felder aus: Sprint-Name, Story-Point-Schätzung.

2. Fügen Sie einen JQL-Filter hinzu: project = "Your Project" AND type != epic AND status = done order by created ASC

3. Fügen Sie eine Gruppierung nach Transformation hinzu:

   • Sprint-Name | Gruppieren nach

   • Story Point-Schätzung | Berechnen | Summe

4. Wählen Sie die Bar Gauge-Visualisierung aus.

Wie zeige ich an, was in einem Sprint abgeschlossen und was geschätzt wurde?

1. Fügen Sie eine Abfrage hinzu. Wählen Sie zunächst Felder aus: Sprint-Name, Sprint-Startdatum, Story Point-Schätzung.

   Fügen Sie dann einen JQL-Filter hinzu: project = 'Your Project' AND type != epic

2. Fügen Sie eine zweite Abfrage hinzu. Wählen Sie zunächst Felder aus: Sprint-Name, Sprint-Startdatum, Story Point-Schätzung.

   Fügen Sie dann einen JQL-Filter hinzu: project = 'Your Project' AND type != epic AND status = done

3. Fügen Sie eine Gruppierung nach Transformation hinzu:

   • Sprint-Name | Gruppieren nach

   • Startdatum des Sprints | Gruppieren nach

   • Story Point-Schätzung | Berechnen | Summe

4. Wählen Sie die Grafikvisualisierung.

Was ist die durchschnittliche Zeit bis zur Erledigung von Problemen in meinem Projekt?

1. Fügen Sie eine Abfrage hinzu. Wählen Sie zunächst Felder: Erstellt, Statuskategorie geändert aus.

   Fügen Sie dann einen JQL-Filter hinzu: project = 'Your Project' AND type != epic AND status = done

2. Fügen Sie eine Transformation hinzu: Fügen Sie ein Feld aus der Formel hinzu

   • Modus = Zeile reduzieren

   • Berechnung = Unterschied

3. Fügen Sie eine Transformation hinzu: Fügen Sie ein Feld aus der Berechnung hinzu

   • Modus = Binäre Operation

   • Betrieb = Unterschied/86000000

   • Alias = Tage

4. Fügen Sie eine Transformation hinzu: Organisieren Sie Felder

   • Anderes Feld ausblenden

5. Fügen Sie eine Transformation hinzu: Daten nach Werten filtern

   • Filtertyp = Einschließen

   • Bedingungen = Entspricht einer beliebigen

     • Feld = Tage | Treffer = Ist größer | Wert = 1

6. Transformation hinzufügen: Reduzieren

   • Modus = Reihe zu Zeilen

   • Berechnungen = Mittelwert

7. Wählen Sie die Statistik-Visualisierung.