Connect a una fonte di dati Jira - Grafana gestito da Amazon
Limiti notiAggiungere la fonte di datiInterroga la fonte di dati JiraInterrogazione sulle serie temporModelli e variabiliUsare le trasformazioni di Grafana per rispondere a domande comuniOttieni il massimo dalla fonte di dati

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Connect a una fonte di dati Jira

Ottieni un quadro completo del tuo processo di sviluppo combinando i dati sui problemi di Jira con i dati sulle prestazioni delle applicazioni provenienti da altre fonti.

Nota

Questa fonte di dati è solo per Grafana Enterprise. Per ulteriori informazioni, consulta Gestisci l'accesso ai plugin Enterprise.

Inoltre, nelle aree di lavoro che supportano la versione 9 o successiva, questa fonte di dati potrebbe richiedere l'installazione del plug-in appropriato. Per ulteriori informazioni, consulta Estendi il tuo spazio di lavoro con i plugin.

  • Crea annotazioni basate sulla creazione o sulla risoluzione dei problemi, per vedere la relazione tra problemi e metriche.

  • Tieni traccia delle statistiche dettagliate di Jira, come il tempo medio di risoluzione e la velocità effettiva dei problemi.

Per utilizzare la fonte di dati Jira, è necessario un account Atlassian con accesso a un progetto Jira.

Limiti noti

I tipi di campo personalizzati dei componenti aggiuntivi di Jira potrebbero non essere supportati.

Aggiungere la fonte di dati

  1. Apri la console Grafana nell'area di lavoro Amazon Managed Grafana e assicurati di aver effettuato l'accesso.

  2. Nel menu laterale sotto Configurazione (l'icona a forma di ingranaggio), scegli Data Sources.

  3. Scegli Aggiungi origine dati

    Nota

    Se non vedi il link Fonti di dati nel menu laterale, significa che l'utente attuale non Admin ricopre il ruolo.

  4. Seleziona Jira dall'elenco delle fonti di dati.

  5. Immetti le seguenti informazioni:

    • Per Nome, inserisci un nome per questa fonte di dati Jira.

    • Per URL, inserisci l'URL principale dell'istanza Atlassian, ad esempio. https://bletchleypark.atlassian.net

    • Per Utente, inserisci un indirizzo e-mail per l'account utente/servizio.

    • Per il token API, inserisci un token API generato per l'utente.

Interroga la fonte di dati Jira

Da Jira Query Editor puoi selezionare campi e problemi di query.

L'origine dati di Jira interroga Jira per eventuali problemi, che possono rappresentare bug, storie degli utenti, ticket di assistenza o altre attività in Jira

Filtra e visualizza i problemi

  1. Scegli Campi, scegli il menu a discesa e usa type-ahead per selezionare uno qualsiasi dei campi della tua istanza Jira, compresi i campi personalizzati. Alcuni campi da provare:

    • Riepilogo: il nome del problema

    • Epic Name: l'epis a cui appartiene un numero

    • Stima dei punti storia: il numero di punti storia stimati dal team per un problema

  2. Filtra o ordina i problemi. A tale scopo, inserisci un'espressione JQL valida per filtrare o ordinare i problemi in base a uno qualsiasi dei relativi campi, ad esempio Project, Assignee o Sprint con il linguaggio di query Atlassian JQL.

Da qui, puoi visualizzare i dati in una tabella o utilizzare le trasformazioni Grafana per manipolare i dati emessi, eseguire calcoli o trasformare i dati in un grafico di serie temporali. Per ulteriori informazioni, consulta Applicare una trasformazione.

Interrogazione sulle serie tempor

Per mostrare i dati delle serie temporali, scegli un campo Data insieme a un campo numerico, quindi passa alla visualizzazione grafica. Ad esempio: Sprint Start Date, Story point estimate.

L'esempio precedente, da solo, non è molto utile. Il campo numerico può essere (e molto probabilmente lo sarà) calcolato in base alle trasformazioni. L'utilizzo del raggruppamento per trasformazione consentirebbe il raggruppamento per data di inizio dello Sprint e il riepilogo della stima degli Story point, consentendo una visualizzazione degli Story Points nel tempo per Sprint. Per ulteriori informazioni sulle trasformazioni, consulta Applicare una trasformazione.

Modelli e variabili

Per aggiungere una nuova variabile di query Jira, consultaAggiungere una variabile di query. Usa la tua fonte di dati Jira come fonte di dati.

Puoi definire variabili sui tuoi dashboard e farvi riferimento nelle espressioni JQL. Ad esempio, puoi creare una dashboard sullo stato del progetto e scegliere tra diversi progetti, oppure una dashboard sullo stato di Epic e scegliere diverse epic, oppure una dashboard sullo stato delle attività e scegliere diversi assegnatari.

Per ottenere un elenco dinamico di progetti, epic, assegnatari e così via tra cui scegliere, crea una variabile di tipo Query. Le variabili di tipo di query utilizzano JQL per interrogare problemi e restituire progetti, epic, assegnatari o qualsiasi cosa relativa ai problemi. Di seguito è riportato un esempio:

Crea una variabile Assegnatario per ottenere lo stato dei problemi da parte dell'Assegnatario

  1. Aggiungi una variabile di tipo Query named. assignee

  2. Seleziona campo: Assegnatario.

  3. ) Facoltativo) Aggiungi un progetto di filtro JQL = 'il tuo progetto'.

  4. Scegli Esegui per visualizzare un elenco di assegnatari.

  5. Scegli Aggiorna per aggiungere la variabile alla dashboard.

  6. Aggiungi un nuovo pannello alla dashboard e modifica il JQL per filtrarlo utilizzando la nuova variabile assignee = $assignee.

    Ora, quando scegli dal menu a discesa, vedi solo i problemi assegnati a quell'utente.

Le variabili multivalore consentono di selezionare più opzioni e possono essere utilizzate come parte della clausola IN. Ad esempio, assignee IN ($assignee).

Usare le trasformazioni di Grafana per rispondere a domande comuni

Le macro sono variabili che fanno riferimento alla finestra temporale del dashboard, quindi è possibile filtrare i problemi solo all'interno dell'intervallo della finestra del dashboard. Sono disponibili 2 macro:

  • $__timeFrom

  • $__timeTo.

Il seguente esempio di query JQL filtra i problemi creati nella finestra temporale del dashboard: createdDate >= $__timeFrom AND createdDate <= $__timeTo

Ottieni il massimo dalla fonte di dati

L'uso delle trasformazioni di Grafana e di altre funzionalità integrate può aiutarti a visualizzare in modo significativo i tuoi dati Jira.

Usare le trasformazioni per aumentare JQL

Sebbene ci siano molte trasformazioni in Grafana tra cui scegliere, le seguenti forniscono un potente potenziamento per dare a JQL alcune delle caratteristiche/potenza di SQL.

Raggruppa per Questa trasformazione fornisce una funzionalità chiave che non fa parte della sintassi JQL standard di Jira: il raggruppamento. Utilizzando la trasformazione Group By, puoi raggruppare per Sprint o altri campi Issue e aggregare per gruppo per ottenere metriche come la velocità e le stime degli story point rispetto a quelle effettive completate in uno Sprint.

Outer Join Analogamente ai join SQL, puoi unire 2 o più query tramite campi comuni. Ciò fornisce un modo per combinare i set di dati delle query e utilizzare altre trasformazioni per calcolare i valori da più interrogazioni/set di dati.

Aggiungi campo dal calcolo Simile alle espressioni SQL, questa trasformazione consente di aggiungere nuovi campi al set di dati in base ai calcoli di altri campi. I campi utilizzati nel calcolo possono provenire da una singola query o da query che hai unito. È inoltre possibile concatenare calcoli ed eseguire calcoli a partire da campi calcolati.

Usare le trasformazioni di Grafana per rispondere a domande comuni

Puoi utilizzare Transformations per visualizzare, aggregare, raggruppare e unire set di dati, oltre a molti altri tipi di trasformazioni per trasformare semplici risultati in risposte a domande complesse.

Come faccio a mostrare Velocity per Sprint?

  1. Seleziona campi: nome dello sprint, stima degli Story point.

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

  3. Aggiungi un gruppo per trasformazione:

    • Nome Sprint | Raggruppa per

    • Stima dello Story Point | Calcola | Totale

  4. Scegli la visualizzazione Bar Gauage.

Come faccio a mostrare ciò che è stato completato rispetto a quello stimato in uno Sprint?

  1. Aggiungi una query. Innanzitutto, seleziona Campi: Nome dello sprint, Data di inizio dello sprint, Stima dei punti della storia.

    Quindi aggiungi un filtro JQL: project = 'Your Project' AND type != epic

  2. Aggiungi una seconda interrogazione. Innanzitutto, seleziona Campi: Nome dello sprint, Data di inizio dello sprint, Story point estimative.

    Quindi aggiungi un filtro JQL: project = 'Your Project' AND type != epic AND status = done

  3. Aggiungi un gruppo per trasformazione:

    • Nome Sprint | Raggruppa per

    • Data di inizio dello sprint | Raggruppa per

    • Stima dello Story Point | Calcola | Totale

  4. Scegli la visualizzazione del grafico.

Qual è il tempo medio necessario per completare i problemi del mio progetto?

  1. Aggiungi una query. Innanzitutto, seleziona Campi: Creato, Stato, Categoria modificata.

    Quindi aggiungi un filtro JQL: project = 'Your Project' AND type != epic AND status = done

  2. Aggiungi una trasformazione: aggiungi il campo dal calcolo

    • Modalità = Riduci riga

    • Calcolo = Differenza

  3. Aggiungi una trasformazione: aggiungi un campo dal calcolo

    • Modalità = Operazione binaria

    • Funzionamento = Differenza/ 86000000

    • Alias = giorni

  4. Aggiungi una trasformazione: organizza i campi

    • Nascondi campo diverso

  5. Aggiungi una trasformazione: filtra i dati in base ai valori

    • Tipo di filtro = Includi

    • condizioni = Corrisponde a qualsiasi

      • Campo = Giorni | Corrispondenza = È maggiore | Valore = 1

  6. Aggiungi una trasformazione: Riduci

    • Modalità = da serie a righe

    • Calcoli = media

  7. Scegli la visualizzazione Stat.