gh-actions-stats

Github Actions Stats JS

Javascript packager to get insight on your github action's performance through the GHA-Stats platform.

Getting Sarted

First, install the package in your project by running

npm install -S gh-action-stats

Then add it to the start of your custom GitHub action as follows:

const collectStats = require('gh-action-stats');

collectStats();

Now every time your action is used in a workflow you will be able to see the stats.

Stats Collected

The following information is collected:

Variable	Description
GITHUB_RUN_ID	A unique number for each run within a repository. This number does not change if your re-run the workflow
GITHUB_ACTION	The unique identifier (id) of the action (your custom action).
GITHUB_ACTOR	The name of the person or app that initiated the workflow. For example, octocat.
GITHUB_REPOSITORY	The owner of the repository name, For example, octocat/Hello-World.
GITHUB_REF	The branch or tag ref that triggered the workflow. For example, refs/heads/feature-branch-1.If neither a branch or tag is available for the event type, the variable will not exist.
GITHUB_HEAD_REF	Only set for pull request events. The name of the head branch.
GITHUB_BASE_REF	Only set for pull request events. The name of the base branch.
RUNNER_OS	The operation system of the runner executing the job. Possible values are Linux, Windows, or macOS.

Usage Policy

Please make sure you state that you are using this package in your README as to make the users aware of the information collected.

Notes

This packages is made to work with node 12 or above.

Todo

• Runtime stats for debugging possible problems in runs.
• Test on self hosted runners