The GitHub Copilot Metrics Dashboard is a solution accelerator designed to visualize metrics from GitHub Copilot using the GitHub Copilot Metrics API and GitHub Copilot User Management API.
The dashboard showcases a range of features:
Filters: Ability to filter metrics by date range, languages, code editors and visualise data by time frame (daily, weekly, monthly).
Acceptance Average: Percentage of suggestions accepted by users for given date range and group by time range (daily, weekly, monthly).
Active Users: Number of active users for the last cycle.
Adoption Rate: Number of active users who are using GitHub Copilot in relation to the total number of licensed users.
Seat Information: Number of active, inactive, and total users.
Language: Breakdown of languages which can be used to filter the data.
Code Editors: Breakdown of code editors which can be used to filter the data.
Seats feature shows the list of user having a Copilot licence assigned.
This feature is can be enabled or disabled by setting the ENABLE_SEATS_FEATURE environment variable to true or false respectively (default value is true).
Assigned seats ingestion is enabled by default, is possbile to disable by setting the
ENABLE_SEATS_INGESTIONenvironment variable tofalse
The solution accelerator is a web application that uses Azure App Service, Azure Functions, Azure Cosmos DB, Azure Storage and Azure Key Vault. The deployment template will automatically populate the required environment variables in Azure Key Vault and configure the application settings in Azure App Service and Azure Functions.
The following steps will automatically provision Azure resources and deploy the solution accelerator to Azure App Service and Azure Functions using the Azure Developer CLI.
Important
🚨🚨🚨 You must setup authentication using the built-in authentication and authorization capabilities of Azure App Service.
You will be prompted to provide the following information:
- GitHub Enterprise name
- GitHub Organization name
- GitHub Token
- GitHub API Scope
- Use Metrics API (beta - will use the GA Metrics API) )
- Team Names (if you choose to use the new metrics API)
More details here for the GA Metrics API
Team Names must be a valid JSON array, e.g.
["team-1", "team-2]
GitHub API Scope define the GITHUB_API_SCOPE environment variable that can be "enterprise" or "organization". It is used to define at which level the GitHub APIs will gather data. If not specified, the default value is "organization".
- Download the Azure Developer CLI
- If you have not cloned this repo, run
azd init -t microsoft/copilot-metrics-dashboard. If you have cloned this repo, just run 'azd init' from the repo root directory. - Run
azd upto provision and deploy the application
azd init -t microsoft/copilot-metrics-dashboard
azd up
# if you are wanting to see logs run with debug flag
azd up --debugThis project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.