This document is a step-by-step guide for setting up the GitHub integration within BrightGauge.

Step 1 - Log in to your BrightGauge Account

If you haven’t created an account yet, go here to get started.

If you are logged in with a New Account:

From the account Overview page, click on the "Add a Datasource" button:

•  If you are logged in with an Existing Account:

  Click on the Data menu at the top righthand corner of the screen, and select Datasources from the drop-down menu:

                 

Find the GitHub datasource under "All" or under the appropriate category:

Step 2 - Authenticate with GitHub

Now we need to authenticate with GitHub.  

1. Click on the Authorize in GitHub button at the center of your screen.
   

   

2. If you're not currently logged into GitHub, they'll ask you to log in.  If you are, proceed to step 3.
   

   

3. Authorize BrightGauge to speak with GitHub.
   

   

4. Once authenticated, the window closes and a successful test connection shows in BrightGauge.
   

   

5. Name the datasource (by default it says GitHub Api) and make sure to click save at the bottom left.  If you do not save the datasource, you will have to redo all steps.

   

Dashboards, reports, datasets, and gauges will be added to your account after the datasource is saved. They will start syncing immediately and typically complete syncing after 20-30 minutes. 

Your Default Dashboards

• BGS - Developer Dashboard

Your Default Reports

• Developer Report

For a list of all default gauges, please visit the Gauges section of your account, sort by the Datasource you'd like to see and select for Default.  

If you have any questions, please contact Support by selecting Help > Open a Ticket from the top menu bar.

Datasets

• Pull Requests: List of all pull requests for your organization and their respective attributes (e.g. Name, State, Base and Head Ref, etc).
• Organization Repositories: List of all repositories for your organization and their respective attributes (e.g. Name, Description, Open Issues Count, etc).
• Repository Events: List of all your organizations events and their respective attributes (e.g. Event Type, Commit URL, Issue Number, etc).
• Repository Issues: List of all of your organizations issues and their respective attributes (e.g. Assignee, Comments, State, etc).
• Repository Branches: List of all branches for your organization and their respective attributes (e.g. Name, Last Commit, Commit Message, etc).