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
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.
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.
Limiti noti
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
-
Apri la console Grafana nell'area di lavoro Amazon Managed Grafana e assicurati di aver effettuato l'accesso.
-
Nel menu laterale sotto Configurazione (l'icona a forma di ingranaggio), scegli Data Sources.
-
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. -
Seleziona GitLabdall'elenco delle fonti di dati.
-
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
Dall'editor di GitLab query è possibile selezionare diversi tipi di risorse, ad esempio commit, problemi o rilasci.
Filtrare e visualizzare i progetti
-
Dal menu a discesa, scegli Progetti.
-
(Facoltativo) Filtra in base ai progetti di cui sei proprietario.
-
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
-
Dal menu a discesa, scegli Commit.
-
Usa il campo di input per aggiungere l'ID del progetto.
-
(Facoltativo) Per filtrare per ramo/tag, utilizza il campo di input per aggiungere un riferimento a ramo/tag.
Filtra e visualizza i problemi
-
Dal menu a discesa, scegli Problemi.
-
Utilizza il campo di immissione per aggiungere l'ID del progetto.
-
(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
-
Dal menu a discesa, scegli Implementazioni.
-
Utilizza il campo di input per aggiungere l'ID del progetto.
-
(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
-
Dal menu a discesa, scegli Etichette.
-
Usa il campo di input per aggiungere l'ID del progetto.
Modelli e variabili
Per aggiungere una nuova variabile di GitLab query, vedereAggiungere una variabile di query. 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
-
Aggiungi una variabile di tipo Query named.
project
-
Seleziona la tua fonte di GitLab dati e aggiorna On Dashboard Load.
-
Seleziona il tipo di risorsa Projects, Sì per Owned, nome per il campo di visualizzazione e id per il campo valore.
-
Scegli Aggiorna per aggiungere la variabile alla dashboard.
-
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
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 impegni/problemi/implementazioni al giorno nel mio progetto?
-
Aggiungi una query. Seleziona Commit per il tipo di risorsa e aggiungi l'ID del progetto.
-
Aggiungi un nuovo gruppo per trasformazione: per Raggruppa per, seleziona created_at_date, quindi calcola (Count) =id
-
Scegli la visualizzazione del grafico.
Qual è il tempo medio necessario per chiudere i problemi del mio progetto?
-
Aggiungi una query. Seleziona Problemi per il tipo di risorsa e aggiungi l'ID del progetto.
-
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.
-
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.
-
Scegli la visualizzazione Stat.
-
Mostra = Calcola
-
Calcolo = Media
-
Campi = resolution_time
-