GitHub Copilot metrics

Loading version...

Port's GitHub Copilot integration allows you to ingest organization-level and enterprise-level GitHub Copilot usage metrics into your software catalog.

Supported resources organization-usage-metricsuser-usage-metricsorganization-user-usage-metricsenterprise-usage-metricsenterprise-user-usage-metrics

Prerequisites

GitHub token

Port's GitHub Copilot integration requires a classic GitHub token generated by organization owners or parent enterprise owners and billing managers with at least one of the following scopes enabled:

• manage_billing:copilot
• read:org
• read:enterprise

In addition, the Copilot Metrics API access policy must be enabled for the organization within GitHub settings.

Setup

Choose one of the following installation methods: Not sure which method is right for your use case? Check the available installation methods.

Choose method

Configuration

Port integrations use a YAML mapping block to ingest data from the third-party api into Port.

The mapping makes use of the JQ JSON processor to select, modify, concatenate, transform and perform other operations on existing fields and values from the integration API.

Default mapping configuration

This is the default mapping configuration for this integration:

Default mapping configuration (click to expand)

entityDeletionThreshold: 0
resources:
- kind: organization-usage-metrics
  selector:
    query: 'true'
  port:
    entity:
      mappings:
        identifier: (.__organization.login + "@" + .day)
        title: (.__organization.login + " copilot-metrics " + .day)
        blueprint: '"githubCopilotOrganizationUsage"'
        properties:
          record_date: .day + "T00:00:00Z"
          daily_active_users: .daily_active_users
          weekly_active_users: .weekly_active_users
          monthly_active_chat_users: .monthly_active_chat_users
          monthly_active_agent_users: .monthly_active_agent_users
          user_initiated_interaction_count: .user_initiated_interaction_count
          code_generation_activity_count: .code_generation_activity_count
          code_acceptance_activity_count: .code_acceptance_activity_count
          loc_suggested_to_add_sum: .loc_suggested_to_add_sum
          loc_added_sum: .loc_added_sum
          loc_suggested_to_delete_sum: .loc_suggested_to_delete_sum
          loc_deleted_sum: .loc_deleted_sum
          prs_created_by_copilot: .pull_requests.total_created_by_copilot
          prs_reviewed_by_copilot: .pull_requests.total_reviewed_by_copilot
          prs_merged_by_copilot: .pull_requests.total_merged_created_by_copilot
          total_copilot_applied_suggestions: .pull_requests.total_copilot_applied_suggestions
          git_hub_org: .__organization.login
- kind: organization-user-usage-metrics
  selector:
    query: 'true'
  port:
    entity:
      mappings:
        identifier: (.user_login + "@" + .__organization.login + "@" + .day)
        title: (.user_login + "@" + .__organization.login + "@" + .day)
        blueprint: '"githubCopilotUserUsage"'
        properties:
          record_date: .day + "T00:00:00Z"
          code_generation_activity_count: .code_generation_activity_count
          code_acceptance_activity_count: .code_acceptance_activity_count
          loc_suggested_to_add_sum: .loc_suggested_to_add_sum
          loc_suggested_to_delete_sum: .loc_suggested_to_delete_sum
          loc_added_sum: .loc_added_sum
          loc_deleted_sum: .loc_deleted_sum
          user_initiated_interaction_count: .user_initiated_interaction_count
          git_hub_org: .__organization.login
          used_agent: .used_agent
          used_chat: .used_chat
          username: .user_login
- kind: enterprise-usage-metrics
  selector:
    query: 'true'
  port:
    entity:
      mappings:
        identifier: (.__enterprise.slug + "@" + .day)
        title: (.__enterprise.slug + " copilot-metrics " + .day)
        blueprint: '"githubCopilotOrganizationUsage"'
        properties:
          record_date: .day + "T00:00:00Z"
          daily_active_users: .daily_active_users
          weekly_active_users: .weekly_active_users
          monthly_active_agent_users: .monthly_active_agent_users
          monthly_active_chat_users: .monthly_active_chat_users
          user_initiated_interaction_count: .user_initiated_interaction_count
          code_generation_activity_count: .code_generation_activity_count
          code_acceptance_activity_count: .code_acceptance_activity_count
          loc_suggested_to_add_sum: .loc_suggested_to_add_sum
          loc_added_sum: .loc_added_sum
          loc_suggested_to_delete_sum: .loc_suggested_to_delete_sum
          loc_deleted_sum: .loc_deleted_sum
          prs_created_by_copilot: .pull_requests.total_created_by_copilot
          prs_reviewed_by_copilot: .pull_requests.total_reviewed_by_copilot
          prs_merged_by_copilot: .pull_requests.total_merged_created_by_copilot
          total_copilot_applied_suggestions: .pull_requests.total_copilot_applied_suggestions
- kind: enterprise-user-usage-metrics
  selector:
    query: 'true'
  port:
    entity:
      mappings:
        identifier: (.user_login + "@" + .__enterprise.slug + "@" + .day)
        title: (.user_login + "@" + .__enterprise.slug + "@" + .day)
        blueprint: '"githubCopilotUserUsage"'
        properties:
          record_date: .day + "T00:00:00Z"
          code_generation_activity_count: .code_generation_activity_count
          code_acceptance_activity_count: .code_acceptance_activity_count
          loc_suggested_to_add_sum: .loc_suggested_to_add_sum
          loc_suggested_to_delete_sum: .loc_suggested_to_delete_sum
          loc_added_sum: .loc_added_sum
          loc_deleted_sum: .loc_deleted_sum
          user_initiated_interaction_count: .user_initiated_interaction_count
          git_hub_org: .__enterprise.slug
          used_agent: .used_agent
          used_chat: .used_chat
          username: .user_login
      relations:
        github_team:
          combinator: '"and"'
          rules:
            - property: '"member_logins"'
              operator: '"contains"'
              value: .user_login

Mapping & selectors per resource

To view and test the integration's mapping against examples of the third-party API responses, use the jq playground in your connectors page. Find the integration in the list of connectors and click on it to open the playground.

GitHub integration required

The github_team relation on enterprise user usage metrics requires the GitHub integration to be installed and syncing githubTeam entities with the member_logins property populated.

Monitoring and sync status

To learn more about how to monitor and check the sync status of your integration, see the relevant documentation.

Track AI credit cost

GitHub's Copilot usage metrics API includes an ai_credits_used field on user-level reports. It is the total AI credits a user consumed for that day, across all Copilot activity. The field is available on both organization and enterprise user reports. See GitHub's changelog announcement.

You can map that field into a dedicated blueprint to monitor spend, compare consumption across users, and estimate USD cost next to request volume.

Metrics signal, not a billed total

ai_credits_used is an overall per-user total. GitHub does not break it down by feature, model, or surface. Treat amount as a consumption estimate for analysis, not an invoice line. The mapping multiplies credits by 0.01 to store an estimated USD value.

Add this mapping in addition to the default organization-user-usage-metrics (or enterprise-user-usage-metrics) block. Ocean can ingest the same kind twice into different blueprints.

Create the cost usage blueprint

1. Go to the data model page in Port.

2. Click + Blueprint.

3. Click the {...} Edit JSON button.

4. Copy and paste the following JSON configuration:

   GitHub Copilot cost usage blueprint (click to expand)

   {
     "identifier": "githubCopilotCostUsage",
     "description": "Per-user USD cost across a date range",
     "title": "GitHub Copilot Cost Usage",
     "icon": "GithubCopilot",
     "schema": {
       "properties": {
         "record_date": {
           "type": "string",
           "format": "date-time",
           "title": "Range Start (UTC)"
         },
         "range_end": {
           "type": "string",
           "format": "date-time",
           "title": "Range End (UTC)"
         },
         "user_name": {
           "type": "string",
           "title": "User Name"
         },
         "currency": {
           "type": "string",
           "title": "Currency"
         },
         "amount": {
           "type": "number",
           "title": "AI Credit Amount"
         },
         "requests": {
           "type": "number",
           "title": "Requests"
         }
       },
       "required": [
         "record_date"
       ]
     },
     "mirrorProperties": {},
     "calculationProperties": {},
     "aggregationProperties": {},
     "relations": {}
   }

5. Click Save.

Add the mapping

1. Go to the connectors page in Port.
2. Open your GitHub Copilot integration and select the Mapping tab.
3. Add one of the following resource blocks, then click Save & Resync.

Organization

Organization cost mapping (click to expand)

- kind: organization-user-usage-metrics
  selector:
    query: 'true'
  port:
    entity:
      mappings:
        identifier: (.user_login + "@" + .__organization.login + "@" + .day)
        title: (.user_login + "@" + .__organization.login + "@" + .day)
        blueprint: '"githubCopilotCostUsage"'
        properties:
          record_date: .report_start_day + "T00:00:00Z"
          range_end: .report_end_day + "T00:00:00Z"
          user_name: .user_login
          currency: '"USD"'
          amount: (.ai_credits_used * 0.01)
          requests: .user_initiated_interaction_count

Enterprise

Enterprise cost mapping (click to expand)

- kind: enterprise-user-usage-metrics
  selector:
    query: 'true'
  port:
    entity:
      mappings:
        identifier: (.user_login + "@" + .__enterprise.slug + "@" + .day)
        title: (.user_login + "@" + .__enterprise.slug + "@" + .day)
        blueprint: '"githubCopilotCostUsage"'
        properties:
          record_date: .report_start_day + "T00:00:00Z"
          range_end: .report_end_day + "T00:00:00Z"
          user_name: .user_login
          currency: '"USD"'
          amount: (.ai_credits_used * 0.01)
          requests: .user_initiated_interaction_count

Migration Guide

This guide covers the migration from the legacy copilot-organization-metrics kind to the new organization-usage-metrics kind. GitHub shut down the legacy Copilot Metrics API on April 2, 2026.

What changed

• The copilot-organization-metrics kind was replaced by organization-usage-metrics, which uses a new blueprint (githubCopilotOrganizationUsage) and features a restructured schema.
• GitHub discontinued support for team-level metrics. As a result, the copilot-team-metrics kind stopped functioning after the sunset date. There is no replacement for this functionality in the new API or the integration.

Migrate from copilot-organization-metrics

1. Add the new blueprint

Ensure you have the githubCopilotOrganizationUsage blueprint in Port. You can find the blueprint definition in the Organization usage metrics section above.

2. Add the new integration mapping

In your Port connector configuration, add the organization-usage-metrics kind. You can find the full mapping in the organization-usage-metrics resource section above.

3. Verify token permissions

Ensure you are using a classic PAT (fine-grained PATs are not supported) with at least one of the following scopes: manage_billing:copilot or read:enterprise. The token must be generated by an Enterprise Administrator or Billing Manager, or a user with the proper fine-grained permissions to access Copilot metrics. Also confirm that the "Copilot usage metrics" policy is set to Enabled everywhere in your enterprise settings under AI Controls -> Copilot -> Metrics.

4. Remove legacy kinds

Once data is flowing correctly via organization-usage-metrics, remove both copilot-organization-metrics and copilot-team-metrics from your mapping. Note that copilot-team-metrics has no replacement — it is simply being removed.

Existing entities

Entities already ingested under the github_copilot_usage blueprint will not be automatically deleted. A resync will auto-reconcile the environment.

Related guide

Visualize GitHub Copilot metrics