GitHub

Sleduj aktivitu ve veřejných i soukromých repozitářích vedle zbytku každého projektu.

Co dostaneš

Metrika	Jak se počítá	Period value
Commits	Commity na default větvi podle data commitu	Sum of the days
PRs merged	Sloučené pull requesty podle data sloučení	Sum of the days
Lines changed	Přidané plus smazané řádky, bez merge commitů	Sum of the days
Open issues	Issues právě otevřené (pull requesty vynechány)	Latest observation

Releases se stanou events na projektu — vidíš, co kdy vyšlo.

Dny v UTC. Open issues jen když má repozitář issues zapnuté.

Activity, not productivity

Čísla popisují aktivitu repozitáře. Neměří práci jednotlivce; jeden velký commit může znamenat méně než deset malých.

Krok 1: Vytvoření tokenu

Fine-grained personal access token ti dovolí přesně vybrat repozitáře, které Metribay smí read-only číst.

1. Na GitHubu: Settings → Developer settings → Personal access tokens → Fine-grained tokens a Generate new token.

2. Jméno třeba „Metribay” a datum expirace.

3. V Resource owner vyber sebe nebo organizaci vlastnící repozitáře.

4. V Repository access zvol Only select repositories a vyber repozitáře ke sledování.

5. V Permissions → Repository permissions nastav Read-only:

   • Contents
   • Issues
   • Pull requests

   Metadata se přidá read-only samo.

6. Generate token a zkopíruj. GitHub ukáže token jednou.

Některé organizace musí fine-grained tokeny schválit. Nevidíš repozitáře? Požádej ownera organizace o schválení.

Plan for expiry

Po expiraci tokenu zdroj ukáže Needs attention. Nastav si připomínku, vytvoř nový token včas a aktualizuj connected account.

Krok 2: Propojení v Metribay

1. Na stránce projektu Add data source a GitHub.

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

3. Save account and continue.

4. Vyber repozitář ze seznamu.

5. Add and start import.

Ruční zadání repozitáře

Enter it manually a zadej owner/repository, třeba octocat/hello-world.

Jiné způsoby přihlášení

Classic personal access token. Funguje taky. Veřejné repozitáře nepotřebují scopes. Soukromé potřebují repo, což dává i zápis — raději fine-grained.

GitHub App. Máš-li vlastní GitHub App, otevři Use a GitHub App instead a vyplň Client Id, Installation Id a GitHub App private key (PEM). Dej app read-only Contents, Issues a Pull requests. S app zadáváš repozitáře ručně — seznam není k dispozici.

Dobré vědět

• First imports can take a while u rušných repozitářů — Metribay načte každý commit, PR a release v history window.
• Every sync rereads the whole history window. Commity se na default větvi mohou objevit dlouho po napsání po sloučení větve. Opakované čtení drží součty správně.
• Long windows on very large repositories mohou narazit na limity GitHubu. Selže-li první import, zkus kratší history window.

Viz také Řešení problémů.