From 4d8c883b2ac1a7be8243da8c487cc688d36f4f9c Mon Sep 17 00:00:00 2001 From: Imran Maszeri Date: Tue, 30 Jun 2026 14:56:45 +0800 Subject: [PATCH 1/2] add ai_credits_used and update schema output --- .../copilot-usage-metrics.md | 3 +++ .../copilot-usage-metrics/example-schema.md | 21 +++++++++---------- 2 files changed, 13 insertions(+), 11 deletions(-) diff --git a/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md b/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md index e8358e457d31..89a5a0eb1485 100644 --- a/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md +++ b/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md @@ -111,6 +111,9 @@ Per-user reports contain one record per user for the reporting period. The 28-da | `used_copilot_code_review_active` | `boolean` | Yes | Whether the user actively engaged with {% data variables.copilot.copilot_code-review_short %} that day. A user is considered active if they manually requested a {% data variables.product.prodname_copilot_short %} review, or applied a {% data variables.product.prodname_copilot_short %} review suggestion. Null when there is no {% data variables.copilot.copilot_code-review_short %} signal for the user that day. | | `used_copilot_code_review_passive` | `boolean` | Yes | Whether the user had {% data variables.product.prodname_copilot_short %} automatically assigned to review their pull request that day, without actively engaging with the review. Null when there is no {% data variables.copilot.copilot_code-review_short %} signal for the user that day. | | `ai_adoption_phase` | `object` | No | The user's AI adoption phase for the day. Always present; defaults to the "No Cohort" phase. See [AI adoption phase fields](#ai-adoption-phase-fields). | +| `ai_credits_used` | `number` | No | Total AI credits consumed by the user on this day. | +| `used_copilot_cloud_agent` | `boolean` | No | Whether the user used Copilot cloud agent that day. | +| `used_copilot_coding_agent` | `boolean` | No | Whether the user used Copilot cloud agent that day. Carries the same value as `used_copilot_cloud_agent`; both names are retained for backward compatibility. | | `totals_by_cli` | `object` | Yes | CLI-specific metrics for the user. Omitted when the user had no {% data variables.copilot.copilot_cli_short %} usage that day. See [{% data variables.copilot.copilot_cli_short %} metrics fields](#copilot-cli-metrics-fields). | | `totals_by_ide` | `array` | No | Per-IDE breakdown of the user's activity. See [Activity breakdown objects](#activity-breakdown-objects). | | `totals_by_feature` | `array` | No | Per-feature breakdown of the user's activity. See [Activity breakdown objects](#activity-breakdown-objects). | diff --git a/content/copilot/reference/copilot-usage-metrics/example-schema.md b/content/copilot/reference/copilot-usage-metrics/example-schema.md index 2e7db8049773..395152a995d3 100644 --- a/content/copilot/reference/copilot-usage-metrics/example-schema.md +++ b/content/copilot/reference/copilot-usage-metrics/example-schema.md @@ -85,12 +85,17 @@ The following are example schemas for the user-level and enterprise-level data r "used_agent": false, "used_chat": false, "used_cli": true, + "used_copilot_coding_agent": false, + "used_copilot_cloud_agent": false, + "ai_adoption_phase": { + "phase_number": 2, + "phase": "Phase 2", + "version": "v1" + }, "user_id": 1, "user_login": "login1", "user_initiated_interaction_count": 0, - "etl_id": "green", - "day_partition": "2025-10-01", - "entity_id_partition": 1 + "ai_credits_used": 500 }] ``` @@ -175,10 +180,7 @@ The following are example schemas for the user-level and enterprise-level data r } ], "enterprise_id" : "1", "report_end_day" : "2025-10-01", - "report_start_day" : "2025-09-04", - "etl_id" : "green", - "day_partition" : "2025-10-01", - "entity_id_partition" : 1 + "report_start_day" : "2025-09-04" }, { "day_totals" : [ { "code_acceptance_activity_count" : 1, @@ -243,10 +245,7 @@ The following are example schemas for the user-level and enterprise-level data r } ], "enterprise_id" : "2", "report_end_day" : "2025-10-01", - "report_start_day" : "2025-09-04", - "etl_id" : "green", - "day_partition" : "2025-10-01", - "entity_id_partition" : 2 + "report_start_day" : "2025-09-04" } ] ``` From 7afd4317c420c9f9fb7d10de48b615f57fafdf59 Mon Sep 17 00:00:00 2001 From: Sharra-writes Date: Wed, 1 Jul 2026 12:13:33 -0700 Subject: [PATCH 2/2] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- .../reference/copilot-usage-metrics/copilot-usage-metrics.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md b/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md index 89a5a0eb1485..a6f86730076d 100644 --- a/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md +++ b/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md @@ -111,9 +111,7 @@ Per-user reports contain one record per user for the reporting period. The 28-da | `used_copilot_code_review_active` | `boolean` | Yes | Whether the user actively engaged with {% data variables.copilot.copilot_code-review_short %} that day. A user is considered active if they manually requested a {% data variables.product.prodname_copilot_short %} review, or applied a {% data variables.product.prodname_copilot_short %} review suggestion. Null when there is no {% data variables.copilot.copilot_code-review_short %} signal for the user that day. | | `used_copilot_code_review_passive` | `boolean` | Yes | Whether the user had {% data variables.product.prodname_copilot_short %} automatically assigned to review their pull request that day, without actively engaging with the review. Null when there is no {% data variables.copilot.copilot_code-review_short %} signal for the user that day. | | `ai_adoption_phase` | `object` | No | The user's AI adoption phase for the day. Always present; defaults to the "No Cohort" phase. See [AI adoption phase fields](#ai-adoption-phase-fields). | -| `ai_credits_used` | `number` | No | Total AI credits consumed by the user on this day. | -| `used_copilot_cloud_agent` | `boolean` | No | Whether the user used Copilot cloud agent that day. | -| `used_copilot_coding_agent` | `boolean` | No | Whether the user used Copilot cloud agent that day. Carries the same value as `used_copilot_cloud_agent`; both names are retained for backward compatibility. | +| `ai_credits_used` | `number` | No | Total {% data variables.product.prodname_ai_credits_short %} consumed by the user on this day. | | `totals_by_cli` | `object` | Yes | CLI-specific metrics for the user. Omitted when the user had no {% data variables.copilot.copilot_cli_short %} usage that day. See [{% data variables.copilot.copilot_cli_short %} metrics fields](#copilot-cli-metrics-fields). | | `totals_by_ide` | `array` | No | Per-IDE breakdown of the user's activity. See [Activity breakdown objects](#activity-breakdown-objects). | | `totals_by_feature` | `array` | No | Per-feature breakdown of the user's activity. See [Activity breakdown objects](#activity-breakdown-objects). |