

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 GitLab dati
<a name="gitlab-AMG-datasource"></a>

L'origine GitLab dati ti consente di tenere traccia di GitLab statistiche dettagliate, ad esempio i principali contributori, gli impegni giornalieri o le implementazioni giornaliere. Puoi anche utilizzare variabili modello, come i progetti, per impostare filtri per le tue dashboard. Puoi combinare i dati dell' GitLab API con i dati 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).

## Limiti noti
<a name="gitlab-known-limitations"></a>

Gli avvisi non sono ancora supportati su questo plugin perché le trasformazioni non sono supportate nelle query di avviso e le trasformazioni sono l'unico modo per ottenere metriche aggregate significative dai dati grezzi dell'API. GitLab 

## Aggiungere la fonte di dati
<a name="gitlab-adding-the-data-source"></a>

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 `Admin` ricopre il ruolo. 

1.  Seleziona **GitLab**dall'elenco delle fonti di dati. 

1. Immetti le seguenti informazioni:
   + In **Nome**, inserisci un nome per questa fonte di GitLab dati.
   + Per **URL**, inserisci l'URL principale dell' GitLab istanza, ad esempio**https://gitlab.com/api/v4**.
   + Per il **token di accesso**, inserisci il tuo token di accesso GitLab personale.

## Interroga la fonte GitLab dei dati
<a name="gitlab-query"></a>

Dall'editor di GitLab query è possibile selezionare diversi tipi di risorse, ad esempio commit, problemi o rilasci.

**Filtrare e visualizzare i progetti**

1.  Dal menu a discesa, scegli **Progetti**. 

1.  (Facoltativo) Filtra in base ai progetti di cui sei proprietario. 

1.  Utilizza il menu a discesa e seleziona **Sì** o **No** per filtrare i risultati. 
**Nota**  
 Il recupero di tutti i progetti **Owned = No** può richiedere molto tempo. 

**Filtra e visualizza i commit**

1.  **Dal menu a discesa, scegli Commit.** 

1.  Usa il campo di input per aggiungere l'ID del progetto. 

1.  (Facoltativo) Per filtrare, branch/tag utilizza il campo di input per aggiungere un branch/tag riferimento. 

**Filtra e visualizza i problemi**

1.  Dal menu a discesa, scegli **Problemi**. 

1.  Utilizza il campo di immissione per aggiungere l'ID del progetto. 

1.  (Facoltativo) Per filtrare in base title/description, utilizza il campo di input per cercare i problemi in base al **titolo** e alla **descrizione**. 

**Visualizza i comunicati**

1.  Dal menu a discesa, scegli **Implementazioni**. 

1.  Utilizza il campo di input per aggiungere l'ID del progetto. 

1.  (Facoltativo) Per filtrare in base environment/status, utilizza i campi di input. L'attributo **status** può essere uno dei seguenti valori:`created`,`running`,`success`,`failed`, o`canceled`. 

**Visualizza etichette**

1.  Dal menu a discesa, scegli **Etichette**. 

1.  Usa il campo di immissione per aggiungere l'ID del progetto. 

## Modelli e variabili
<a name="gitlab-templates"></a>

Per aggiungere una nuova variabile di GitLab query, vedere[Aggiungere una variabile di query](variables-types.md#add-a-query-variable). Usa la tua fonte di GitLab dati come fonte di dati. Scegli un tipo di risorsa: **pubblicazioni**, **progetti** o **etichette**.

Per ottenere un elenco dinamico di progetti, etichette e così via tra cui scegliere, crea una variabile di tipo Query. Le variabili di tipo di GitLab query utilizzano l'editor di query per interrogare e restituire progetti, etichette e così via. L'esempio seguente crea una variabile Project per parametrizzare le query

**Crea una variabile Project per parametrizzare le tue query**

1.  **Aggiungi una variabile di tipo Query named.** **project** 

1.  Seleziona la tua fonte di GitLab dati e aggiorna **On Dashboard Load**. 

1.  Seleziona il tipo di risorsa **Projects**, **Sì** per **Owned**, **nome per il** **campo di visualizzazione** e **id** per il **campo valore**. 

1. Scegli **Aggiorna** per aggiungere la variabile alla dashboard.

1. Aggiungi un nuovo pannello alla dashboard e utilizzalo **$project** come ID del progetto.

   Ora, quando scegli dal menu a discesa, ottieni i risultati che appartengono a quel progetto.

## Usare le trasformazioni di Grafana per rispondere a domande comuni
<a name="gitlab-transformations"></a>

Ora che puoi eseguire GitLab query di base per trovare commit, problemi, ecc., 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. Di seguito sono riportate alcune domande comuni e come utilizzare le trasformazioni per rispondere.

**Quante commits/issues /implementazioni al giorno nel mio progetto?**

1.  Aggiungi una query. Seleziona **Commit per il** tipo di risorsa e aggiungi l'ID del progetto. 

1.  **Aggiungi un nuovo **gruppo** per trasformazione: per **Raggruppa** per, seleziona **created\_at\_date**, quindi calcola (Count) =id** 

1. **Scegli la visualizzazione del grafico.**

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

1.  Aggiungi una query. Seleziona **Problemi** per il tipo di risorsa e aggiungi l'ID del progetto. 

1.  ******Aggiungi un nuovo **campo Aggiungi dalla trasformazione del calcolo**: per **Modalità**, seleziona **Operazione binaria, per Operazione**, seleziona **closed\_at = created\_at e per Alias scegli resolution\_time**.****** 

1.  ******Aggiungi un nuovo **campo Aggiungi dalla trasformazione del calcolo**: per **Modalità**, seleziona Operazione **binaria, per Operazione**, seleziona resolution\_time/86400000 e per Alias scegli **resolution\_time**.****** 

   ****Per Sostituisci tutti i campi, scegli True.****

1. Scegli la visualizzazione **Stat**.
   + Mostra = Calcola
   + Calcolo = Media
   + Campi = **resolution\_time**