GitHub

Segui l’attività dei repository pubblici e privati accanto al resto di ogni progetto.

Cosa ottieni

Metrica	Come è contata	Valore di periodo
Commits	Commit sul branch predefinito, per data commit	Somma dei giorni
PRs merged	Pull request unite, per data merge	Somma dei giorni
Lines changed	Righe aggiunte più rimosse, esclusi merge commit	Somma dei giorni
Open issues	Issue aperti adesso (pull request escluse)	Ultima osservazione

Le Releases diventano eventi sul progetto, così vedi cosa è uscito quando.

I giorni sono contati in UTC. Gli issue aperti compaiono solo se il repository ha gli issue attivi.

Attività, non produttività

Questi numeri descrivono l’attività di un repository. Non misurano il lavoro di nessuno, e un commit grande può valere meno di dieci piccoli.

Passo 1: Creare un token

Un fine-grained personal access token ti permette di scegliere esattamente quali repository Metribay può leggere, con accesso read-only.

1. Su GitHub, apri Settings → Developer settings → Personal access tokens → Fine-grained tokens e seleziona Generate new token.

2. Dagli un nome come «Metribay» e scegli una data di scadenza.

3. Sotto Resource owner, scegli te stesso o l’organizzazione proprietaria dei repository.

4. Sotto Repository access, scegli Only select repositories e seleziona quelli da tracciare.

5. Sotto Permissions → Repository permissions, imposta su Read-only:

   • Contents
   • Issues
   • Pull requests

   Metadata viene aggiunto read-only da solo.

6. Seleziona Generate token e copialo. GitHub lo mostra una sola volta.

Alcune organizzazioni devono approvare i token fine-grained prima che funzionino. Se i repository non compaiono, chiedi a un owner dell’organizzazione di approvare la richiesta.

Pianifica la scadenza

Quando il token scade, la fonte dati mostra Needs attention. Imposta un promemoria calendario, crea un nuovo token prima e aggiorna l’account collegato.

Passo 2: Collegarlo in Metribay

1. Nella pagina del progetto, seleziona Add data source e scegli GitHub.

2. Apri Connect an account with your own credentials e incolla il token in Personal access token.

3. Seleziona Save account and continue.

4. Scegli un repository dall’elenco.

5. Seleziona Add and start import.

Inserire il repository a mano

Apri Enter it manually e digitalo come owner/repository, ad esempio octocat/hello-world.

Altri modi di accedere

Classic personal access token. Funziona anche. Per repository pubblici non servono scope. Per quelli privati serve lo scope repo, che concede anche scrittura: preferisci un token fine-grained.

GitHub App. Se gestisci la tua GitHub App, apri Use a GitHub App instead e compila Client Id, Installation Id e GitHub App private key (PEM). Dai all’app permessi read-only Contents, Issues e Pull requests. Con un’app, inserisci i repository a mano: l’elenco non è disponibile.

Da sapere

• I primi import possono richiedere tempo su repository molto attivi, perché Metribay legge ogni commit, pull request e release nella finestra storica.
• Ogni sync rilegge tutta la finestra storica. I commit possono comparire sul branch predefinito molto dopo essere stati scritti, quando un branch viene unito. Rileggere mantiene i conteggi corretti.
• Finestre lunghe su repository enormi possono raggiungere i limiti GitHub. Se il primo import fallisce, prova una finestra storica più corta.

Vedi anche Risoluzione problemi.