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](upgrade-to-enterprise-plugins.md). 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](grafana-plugins.md). + 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. 1. **Nel menu laterale sotto **Configurazione** (l'icona a forma di ingranaggio), scegli Data Sources.** 1. Scegli **Aggiungi origine dati** **Nota** Se non vedi il link **Fonti di dati** nel menu laterale, significa che l'utente attuale non ha il `Admin` ruolo. 1. Seleziona **Jira** dall'elenco delle fonti di dati. 1. 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 email per l' user/service account. + 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 1. 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](panel-transformations.md#apply-a-transformation). ## 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](panel-transformations.md#apply-a-transformation). ## Modelli e variabili Per aggiungere una nuova variabile di query Jira, consulta[Aggiungere una variabile di query](variables-types.md#add-a-query-variable). 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 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** 1. Seleziona **campo: Assegnatario**. 1. ) Facoltativo) Aggiungi un progetto di filtro JQL = 'il tuo **progetto'**. 1. Scegli **Esegui** per visualizzare un elenco di assegnatari. 1. Scegli **Aggiorna** per aggiungere la variabile alla dashboard. 1. 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. Multi-value le variabili 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 di SQL. features/power **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 valori da più query. queries/datasets **Aggiungi campo da 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 posso mostrare Velocity per Sprint?** 1. Seleziona campi: **nome dello sprint**, stima degli **Story** point. 1. Aggiungi un filtro JQL: `project = "Your Project" AND type != epic AND status = done order by created ASC` 1. Aggiungi un **gruppo per** trasformazione: + Nome Sprint \| Raggruppa per + Stima dello Story Point \| Calcola \| Totale 1. 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` 1. 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` 1. Aggiungi un **gruppo per** trasformazione: + Nome Sprint \| Raggruppa per + Data di inizio dello sprint \| Raggruppa per + Stima dello Story Point \| Calcola \| Totale 1. 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` 1. Aggiungi una trasformazione: **aggiungi il campo dal calcolo** + Modalità = Riduci riga + Calcolo = Differenza 1. Aggiungi una trasformazione: **aggiungi un campo dal calcolo** + Modalità = Operazione binaria + Funzionamento = Differenza/ 86000000 + Alias = giorni 1. Aggiungi una trasformazione: **organizza** i campi + Nascondi campo diverso 1. Aggiungi una trasformazione: **filtra i dati in base ai valori** + Tipo di filtro = Includi + condizioni = Corrisponde a qualsiasi + Campo = Giorni \| Corrispondenza = È maggiore \| Valore = 1 1. Aggiungi una trasformazione: **Riduci** + Modalità = da serie a righe + Calcoli = media 1. Scegli la visualizzazione **Stat**.