

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 per titolo/descrizione, utilizza il campo di input per cercare i problemi in base al **titolo** e alla descrizione.** 

**Visualizza i rilasci**

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

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

1.  (Facoltativo) Per filtrare per ambiente/stato, 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 input 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 **\$1project** 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.

**Quanti sono commits/issues/deployments al giorno per il 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\$1at\$1date**, 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\$1at = created\$1at e per Alias scegli resolution\$1time**.****** 

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

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

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