github-actions-exporter

github-actions-exporter

github-actions-exporter for prometheus, which will focus on GitHub self-hosted runners performance

The Motivation

This project was forked from https://github.com/Labbs/github-actions-exporter, which is focusing on GitHub Actions Runner. And since the original repo long time no maintenance, and we want to focus on Self-Hosted Runner, so these are main reasons I forked and updated almost the code.

The Features

• Collected GitHub Actions Workflow data
• Collected Github Actions Workflow jobs data
• Collected Github Actions self-hosted runner data
• Tracking API rate limit remaining from GitHub API
• Grafaba dashboard samples
• Optimize and reduce GitHub API calling
• Unit tests coverage(Soon)
• CI/CD automation build binary, docker image and publish release support(Soon)

Options

Exported stats

github_workflow_run_status

Gauge type

Result possibility

Fields

github_workflow_run_duration_ms

Gauge type

Result possibility

Fields

github_runner_status

Gauge type (If you have self hosted runner)

Result possibility

Fields

github_runner_organization_status

Gauge type (If you have self hosted runner for an organization)

Result possibility

Fields

github_runner_enterprise_status

Gauge type (If you have self hosted runner for an enterprise)

Result possibility

Fields

Setting up authentication with GitHub API

There are two ways for github-actions-exporter to authenticate with the GitHub API (only 1 can be configured at a time however):

1. Using a GitHub App (not supported when you use Github Enterprise )
2. Using a Personal Access Token

Functionality wise, there isn't much of a difference between the 2 authentication methods. The primarily benefit of authenticating via a GitHub App is an increased API quota.

If you are deploying the solution for a GitHub Enterprise Server environment you are able to configure your rate limiting settings making the main benefit irrelevant. If you're deploying the solution for a GitHub Enterprise Cloud or regular GitHub environment and you run into rate limiting issues, consider deploying the solution using the GitHub App authentication method instead.

GitHub App Authentication

You can create a GitHub App for either your account or any organization. If you want to create a GitHub App for your account, open the following link to the creation page, enter any unique name in the "GitHub App name" field, and hit the "Create GitHub App" button at the bottom of the page.

• Create GitHub Apps on your account

If you want to create a GitHub App for your organization, replace the :org part of the following URL with your organization name before opening it. Then enter any unique name in the "GitHub App name" field, and hit the "Create GitHub App" button at the bottom of the page to create a GitHub App.

• Create GitHub Apps on your organization

Github Token/App Permissions

Scopes needed configuration for the Github token/app

repo
  - Actions: Read-only
  - Administration: Read-only
  - Deployments: Read-only

org
  - Self-hosted runners: Read-only

If you want to monitor a public repository, you must put the public_repo option in the repo scope of your github token or Github App Authentication.

Common Errors

Invalid Github Token

if token is invalid then 401 Bad credentials will be returned on github API error and displayed in an error message.

Invalid Github App configuration

if the app id or app installation id value is incorrect then messages like the following are displayed:

could not refresh installation id 12345678's token: request &{Method:POST URL:https://api.github.com/app/installations/12345678/access_tokens

if the github_app_private_key is incorrect then errors like the following are displayed.

 Error: Client creation failed.authentication failed: could not parse private key: Invalid Key: Key must be PEM encoded PKCS1 or PKCS8 private ke