Connect a una fonte di GitLab dati - Grafana gestito da Amazon

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

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

  4. Seleziona GitLabdall'elenco delle fonti di dati.

  5. 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 esempiohttps://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
  1. Dal menu a discesa, scegli Progetti.

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

  3. Utilizza il menu a discesa e seleziona 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.

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

  3. (Facoltativo) Per filtrare per ramo/tag, utilizza il campo di input per aggiungere un riferimento a ramo/tag.

Filtra e visualizza i problemi
  1. Dal menu a discesa, scegli Problemi.

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

  3. (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.

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

  3. (Facoltativo) Per filtrare per ambiente/stato, utilizza i campi di input. L'attributo status può essere uno dei seguenti valori:created,,, running successfailed, o. canceled

Visualizza etichette
  1. Dal menu a discesa, scegli Etichette.

  2. 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
  1. Aggiungi una variabile di tipo Query named. project

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

  3. Seleziona il tipo di risorsa Projects, per Owned, nome per il campo di visualizzazione e id per il campo valore.

  4. Scegli Aggiorna per aggiungere la variabile alla dashboard.

  5. 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?

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

  2. Aggiungi un nuovo gruppo per trasformazione: per Raggruppa per, seleziona created_at_date, quindi calcola (Count) =id

  3. 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.

  2. 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.

  3. 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.

  4. Scegli la visualizzazione Stat.

    • Mostra = Calcola

    • Calcolo = Media

    • Campi = resolution_time