GitHub

Suis l’activité de tes dépôts publics et privés à côté du reste de chaque projet.

Ce que tu obtiens

Métrique	Comment c’est compté	Valeur sur la période
Commits	Commits sur la branche par défaut, par date de commit	Somme des jours
PRs merged	Pull requests fusionnées, par date de fusion	Somme des jours
Lines changed	Lignes ajoutées plus supprimées, merge commits exclus	Somme des jours
Open issues	Issues ouvertes maintenant (pull requests exclues)	Dernière observation

Les Releases deviennent des événements sur le projet, pour voir ce qui est sorti quand.

Les jours sont comptés en UTC. Les issues ouvertes n’apparaissent que si le dépôt a les issues activées.

Activité, pas productivité

Ces chiffres décrivent l’activité d’un dépôt. Ils ne mesurent le travail de personne, et un gros commit peut compter moins que dix petits.

Étape 1 : Créer un jeton

Un fine-grained personal access token te permet de choisir exactement quels dépôts Metribay peut lire, en lecture seule.

1. Sur GitHub, ouvre Settings → Developer settings → Personal access tokens → Fine-grained tokens et sélectionne Generate new token.

2. Donne-lui un nom comme « Metribay » et choisis une date d’expiration.

3. Sous Resource owner, choisis-toi ou l’organisation propriétaire des dépôts.

4. Sous Repository access, choisis Only select repositories et sélectionne ceux à suivre.

5. Sous Permissions → Repository permissions, mets en Read-only :

   • Contents
   • Issues
   • Pull requests

   Metadata est ajouté en lecture seule automatiquement.

6. Sélectionne Generate token et copie-le. GitHub ne l’affiche qu’une fois.

Certaines organisations doivent approuver les jetons fine-grained avant qu’ils fonctionnent. Si les dépôts n’apparaissent pas, demande à un owner d’organisation d’approuver la demande.

Anticipe l’expiration

Quand le jeton expire, la source affiche Needs attention. Mets un rappel calendrier, crée un nouveau jeton avant et mets à jour le compte connecté.

Étape 2 : Le connecter dans Metribay

1. Sur la page projet, sélectionne Add data source et choisis GitHub.

2. Ouvre Connect an account with your own credentials et colle le jeton dans Personal access token.

3. Sélectionne Save account and continue.

4. Choisis un dépôt dans la liste.

5. Sélectionne Add and start import.

Saisir le dépôt à la main

Ouvre Enter it manually et saisis-le comme owner/repository, par exemple octocat/hello-world.

Autres façons de se connecter

Classic personal access token. Ça marche aussi. Pour les dépôts publics, aucun scope requis. Pour les privés, il faut le scope repo, qui accorde aussi l’écriture : préfère un jeton fine-grained.

GitHub App. Si tu fais tourner ta propre GitHub App, ouvre Use a GitHub App instead et remplis Client Id, Installation Id et GitHub App private key (PEM). Donne à l’app les permissions read-only Contents, Issues et Pull requests. Avec une app, saisis les dépôts à la main : la liste n’est pas disponible.

Bon à savoir

• Les premiers imports peuvent prendre du temps sur des dépôts très actifs, car Metribay lit chaque commit, pull request et release dans la fenêtre d’historique.
• Chaque synchro relit toute la fenêtre d’historique. Des commits peuvent apparaître sur la branche par défaut longtemps après avoir été écrits, quand une branche est fusionnée. Relire garde les comptes justes.
• De longues fenêtres sur de très gros dépôts peuvent atteindre les limites GitHub. Si le premier import échoue, essaie une fenêtre d’historique plus courte.

Voir aussi Dépannage.