Of course you have provided all your developers with a Github Copilot license. But do you have a clue on how they are using it? In this post I show you how to use the Github Copilot Metrics API to monitor the usage.
Let's dive in...
Connect to the Metrics API
To start calling the Metrics API endpoint, we need to generate a Personal Access Token(PAT).
-
Click on your profile icon in the upper-right corner of any of your Github Pages and choose Settings from the dropdown.
-
In the left sidebar, click on Developer settings at the bottom.
-
Click on Fine-grained tokens under Personal access tokens.
-
Click on Generate new token.
-
Under Token name, enter a name for the token.
-
Set the Resource owner to the organization you want to monitor the metrics for.
-
Under Permissions, select at least the following permission sets:
-
"GitHub Copilot Business" organization permissions (read)
- "Administration" organization permissions (read)
-
Click Generate token. Copy and save the token to a secure location.
Now you can already try to call the API through Postman for example:
Visualize the data with Power BI
If you want to have a better visualization of the results, you can use the provided Power BI dashboard.
- Clone the repository found here.
- Go to the samples folder and open the GitHub Copilot - Telemetry Sample (DM).pbix file in Power BI Desktop.
- Open Power Query Editor by right clicking the GH Copilot – Details data source and selecting Edit query.
- Go to the Advanced Editor and replace the existing lines with the following code:
- Click Close & Apply to apply the changes and refresh the report.
Visualize the data with the Copilot Metrics Viewer
If you don’t have Power BI, you also have the option to use the Copilot Metrics Viewer.
This application displays a set of charts with various metrics related to GitHub Copilot for your GitHub Organization or Enterprise Account. These visualizations are designed to provide clear representations of the data, making it easy to understand and analyze the impact and adoption of GitHub Copilot.
- Clone the repository found here.
- Update the .env file with the following settings:
- Build the docker image using:
docker build -t copilot-metrics-viewer .
- Remark: I had to change the line endings to LF for the 99-config-app.sh file before I was able to build and run the image successfully.
- Run the docker image using:
docker run -p 8080:80 --env-file ./.env copilot-metrics-viewer
- If we now browse to localhost:8080, you should see the metrics viewer application:
More information
REST API endpoints for GitHub Copilot usage metrics - GitHub Docs