GitHub

Sled aktivite verejných aj súkromných repozitárov vedľa ostatných dát projektu.

Čo dostaneš

Metric	How it’s counted	Period value
Commits	Commits on the default branch, by commit date	Sum of the days
PRs merged	Pull requests merged, by merge date	Sum of the days
Lines changed	Lines added plus lines removed, leaving out merge commits	Sum of the days
Open issues	Issues open right now (pull requests excluded)	Latest observation

Releases sa stanú udalosťami na projekte, aby si videl, čo vyšlo kedy.

Dni sa počítajú v UTC. Otvorené issue sa zobrazia len ak má repozitár issue zapnuté.

Activity, not productivity

Tieto čísla opisujú aktivitu repozitára. Nie sú mierou práce kohokoľvek a jeden veľký commit môže znamenať menej ako desať malých.

Krok 1: Vytvor token

Fine-grained personal access token ti umožní presne vybrať repozitáre, ktoré Metribay môže čítať, s read-only prístupom.

1. Na GitHub otvor Settings → Developer settings → Personal access tokens → Fine-grained tokens a vyber Generate new token.

2. Daj mu meno, napríklad „Metribay“, a zvoľ dátum expirácie.

3. Pod Resource owner vyber seba alebo organizáciu, ktorá vlastní repozitáre.

4. Pod Repository access zvoľ Only select repositories a vyber repozitáre.

5. Pod Permissions → Repository permissions nastav na Read-only:

   • Contents
   • Issues
   • Pull requests

   Metadata sa pridá samo ako read-only.

6. Vyber Generate token a skopíruj ho. GitHub ho ukáže len raz.

Niektoré organizácie musia fine-grained tokeny schváliť. Ak repozitáre nevidíš, požiadaj ownera organizácie o schválenie.

Plan for expiry

Keď token expiruje, zdroj ukáže Needs attention. Nastav si pripomienku, vytvor nový pred expiráciou a aktualizuj prepojený účet.

Krok 2: Prepoj v Metribay

1. Na stránke projektu vyber Add data source a GitHub.

2. Otvor Connect an account with your own credentials a vlož token do Personal access token.

3. Vyber Save account and continue.

4. Vyber repozitár zo zoznamu.

5. Vyber Add and start import.

Zadaj repozitár ručne

Otvor Enter it manually a napíš owner/repository, napríklad octocat/hello-world.

Iné spôsoby prihlásenia

Classic personal access token. Funguje tiež. Pre verejné repozitáre nepotrebuje scopes. Pre súkromné potrebuje repo, ktorý dáva aj zápis, preto radšej fine-grained token.

GitHub App. Ak prevádzkuješ vlastnú GitHub App, otvor Use a GitHub App instead a vyplň Client Id, Installation Id a GitHub App private key (PEM). Aplikácii daj read-only Contents, Issues a Pull requests. Pri app zadávaš repozitáre ručne: zoznam nie je k dispozícii.

Dobré vedieť

• Prvé importy môžu trvať pri rušných repozitároch, lebo Metribay prečíta každý commit, pull request a release v okne histórie.
• Každá synchronizácia znova načíta celé okno. Commity môžu pribudnúť na default branch dlho po napísaní pri merge vetvy. Opätovné čítanie drží správne súčty.
• Dlhé okná pri veľmi veľkých repozitároch môžu naraziť na GitHub limity. Ak prvý import zlyhá, skús kratšie okno histórie.

Pozri aj Riešenie problémov.