Copilot 사용 메트릭에서 사용할 수 있는 데이터

사용 메트릭 대시보드 및 API는 Copilot 일관된 필드 집합을 사용하여 데이터를 표시하고 내보냅니다. 이 참조는 사용 가능한 모든 메트릭을 나열하고 대시보드 시각적 개체와 NDJSON 또는 API 내보내기 모두에서 해당 값을 해석하는 방법을 설명합니다.

• Copilot 사용 메트릭 대시보드는 엔터프라이즈 및 조직 수준에서 사용할 수 있습니다.
• 사용 메트릭 API는 Copilot 집계된 리포지토리 수준 및 개별 사용자 수준 보고서 세분성을 사용하여 엔터프라이즈 또는 조직 범위에서 보고서를 반환합니다. 셰이프는 범위 및 세분성에 따라 다릅니다.
• 팀 수준 메트릭은 미리 집계되지 않습니다. 사용자별 사용 메트릭 보고서와 사용자 팀 보고서를 조인하여 생성합니다. 팀 수준의 Copilot 사용 지표을(를) 참조하세요.
• 리포지토리 수준 보고서에는 요청된 날짜에 끌어오기 요청 작업이 있는 리포지토리당 하나의 레코드가 포함됩니다. 이 문서의 뒷부 분에 있는 리포지토리 수준 필드(API에만 해당) 를 참조하세요.

이러한 메트릭을 읽고 해석하는 방법에 대한 지침은 GitHub Copilot 사용 메트릭스을 참조하세요.

Copilot 사용량 대시보드 메트릭

이러한 메트릭은 사용량 대시보드에 Copilot 직접 표시됩니다. 이러한 차트에는 사용량이 포함되지코파일럿 CLI 않습니다.

Metric	Description
에이전트 도입	현재 월에서 Copilot에이전트를 시도한 라이선스가 부여된 활성 사용자의 비율입니다.
활성 사용자당 평균 채팅 요청	활성 사용자당 평균 채팅 요청 수입니다.
코드 완성(제안/수락됨)	표시되고 수락된 인라인 코드 제안의 총 수입니다.
코드 완성 수락률	사용자가 수락한 제안의 백분율입니다.
일일 활성 사용자	지정된 날짜에 사용한 Copilot 고유 사용자 수입니다.
주간 활성 사용자	7일 동안 사용한 Copilot 고유 사용자 수입니다.
총 활성 사용자	현재 월에서 활성 상태인 라이선스가 있는 사용자입니다.
언어 사용
Copilot에서 사용되는 프로그래밍 언어 분포
일일 언어 사용량	사용되는 언어의 일일 분석입니다.
모델 사용	채팅에 사용되는 AI 모델의 배포입니다.
일일 모델 사용량	채팅 모델 사용량의 일일 분석입니다.
채팅 모드당 모델 사용량	기능별 Copilot 모델 사용량(요청, 편집, 계획, 에이전트).
언어당 모델 사용량	모델별로 세분화되는 언어의 분포입니다.
가장 자주 사용되는 채팅 모델	지난 28일 동안 가장 자주 사용되는 채팅 모델입니다.
채팅 모드당 요청 수	모드별 채팅 요청 수(요청, 편집, 계획, 에이전트).

영향 대시보드 메트릭

이러한 메트릭은 사용자를 채택 코호트로 그룹화하고 해당 채택을 연결하여 요청 출력을 끌어오는 영향 대시보드에 표시됩니다. 채택 코호트 해석에 대한 지침은 GitHub Copilot 사용 메트릭스을 참조하세요.

Metric	Description
참여 추세	지난 6개월 동안 조직의 도입 코호트 구성과 풀 리퀘스트 처리량(월별 병합된 총 풀 리퀘스트 수)이 어떻게 변화했는지.
도입 코호트 분포	해당 기간 동안 각 채택 단계(수동 사용자, 1단계, 2단계, 3단계)로 그룹화된 라이선스 사용자의 공유입니다. 수동 사용자는 API의 No Cohort 값에 해당합니다.
채택 승수	배포된 코드(월별 사용자당 병합된 풀 리퀘스트 수)와 풀 리퀘스트 병합 시간 측면에서 활성 사용자(1단계, 2단계 또는 3단계)와 수동 사용자를 비교하여, 더 깊은 Copilot 도입의 상대적 영향을 보여 줍니다.
Recommendations	조직의 현재 코호트 분포를 기반으로 한 Copilot 클라우드 에이전트 구성 또는 Copilot 코드 검토 사용 설정과 같은 제안된 작업.

코드 생성 대시보드 메트릭

이러한 메트릭은 코드 생성 대시보드에 표시되며 사용자가 시작한 작업 및 에이전트 시작 작업에서 코드가 생성되는 방법에 대한 분석을 제공합니다. 모든 값은 IDE에서 추가되거나 삭제된 LoC(코드 줄)에서 파생됩니다.

Metric	Description
AI를 사용하여 변경된 코드 줄	지난 28일 동안 모든 모드에서 추가 및 삭제된 총 코드 줄입니다.
에이전트 기여	지난 28일 동안 에이전트(편집, 에이전트 및 사용자 지정 모드 포함)에서 추가 및 삭제된 코드 줄의 백분율입니다.
에이전트에 의해 삭제된 평균 줄	현재 월 동안 활성 사용자를 대신하여 에이전트가 자동으로 삭제한 평균 줄 수입니다.
추가 및 삭제된 줄의 일일 총계	매일 모든 모드에서 코드베이스에 추가되고 삭제된 총 줄 수입니다.
사용자가 시작한 코드 변경 내용	코드 완성 및 채팅 패널 작업(삽입, 복사 또는 적용)을 통해 사용자가 제안하거나 수동으로 추가한 줄입니다.
에이전트가 시작한 코드 변경	편집, 에이전트 및 사용자 지정 모드에서 사용자를 대신하여 에이전트가 코드베이스에 자동으로 추가하거나 삭제한 줄입니다.
모델당 사용자가 시작한 코드 변경 내용	사용자가 시작한 코드 줄은 IDE에 사용되는 모델별로 그룹화됩니다.
에이전트가 시작한 모델별 코드 변경 사항	에이전트가 시작한 코드 줄은 에이전트 작업을 수행하는 모델별로 그룹화됩니다.
언어별 사용자 시작 코드 변경 내용	프로그래밍 언어별로 그룹화된 사용자가 시작한 코드 줄입니다.
에이전트에 의해 시작된 코드 변경 사항 언어별	프로그래밍 언어별로 그룹화된 에이전트 시작 코드 줄입니다.

API 및 내보내기 필드

이러한 필드는 내보낸 NDJSON 보고서 및 사용 메트릭 API에 Copilot 표시됩니다. 아래 표 대부분에는 필드 이름, 해당 JSON 형식, 값이 null일 수 있는지 여부 및 설명이 나열되어 있습니다.

보고서는 범위 및 세분성에 따라 다른 셰이프로 제공되므로 레코드에서 사용할 수 있는 필드는 다음에서 가져온 보고서에 따라 달라집니다.

• 사용자별 보고서(*-users-1-day및*-users-28-day)에는 사용자당 하나의 레코드(예user_id: , user_login``ai_credits_used``used_* 표시기 및 ai_adoption_phase)가 포함됩니다. 여기에는 활성 사용자 수, pull_requests, 또는 totals_by_ai_adoption_phase가 포함되지 않습니다.
• 집계된 보고서 (enterprise-1-day 및 org-1-day)에는 활성 사용자 수를 pull_requests포함하여 엔터프라이즈 또는 조직당 하나의 집계된 레코드가 포함됩니다 totals_by_ai_adoption_phase. 여기에는 user_id, user_login 또는 used_* 표시기가 포함되지 않습니다.
• 28일 보고서(enterprise-28-day 및 org-28-day)는 일별 집계 레코드 배열을 day_totals 필드로 감싸며, 보고 기간은 최상위 수준에 있습니다.
• 사용자 팀 보고서 (*-user-teams-1-day)는 사용자가 속한 팀에 사용자를 매핑하므로 팀 수준 메트릭을 생성할 수 있습니다.
• 리포지토리 수준 보고서 (*-repos-1-day)에는 하루에 대한 끌어오기 요청 활동이 있는 리포지토리당 하나의 레코드가 포함됩니다. 여기에는 사용자가 만들고 Copilot 클라우드 에이전트 검토한 끌어오기 요청이 포함됩니다 Copilot 코드 검토.

조직 범위 보고서에는 organization_id와 함께 enterprise_id도 포함됩니다. API에서 반환된 데이터의 스키마는 Copilot 사용 메트릭에 대한 예제 스키마을 참조하세요.

Type 열은 JSON 스키마 형식( string, , integer, number``boolean``array및 object)을 사용합니다. Nullable 열은 필드 값이 null일 수 있는지 또는 원래 적용되어야 하는 레코드에서 값이 없을 수 있는지를 나타냅니다. 배열은 항상 존재하지만 비어 있을 수는 있습니다([]). 따라서 nullable이 아닙니다.

보고서 식별 및 파티션 필드

이러한 필드는 각 레코드의 범위, 날짜 및 (내보내기용) 파티션을 식별합니다. 정확한 집합은 보고서 셰이프에 따라 달라집니다.

분야	Type	널러블	Description
day	string	아니요	이 레코드가 나타내는 달력 날짜(형식) YYYY-MM-DD 입니다. 28일 보고서에서 day 는 최상위 수준이 아닌 각 day_totals 항목 내에 표시됩니다.
enterprise_id	string	아니요	엔터프라이즈의 고유 ID입니다. 엔터프라이즈 및 조직 범위 보고서에 모두 포함됩니다.
organization_id	string	예	조직의 고유한 ID. 조직 범위 보고서에만 포함됩니다. 엔터프라이즈 범위 보고서에서 생략됩니다.
etl_id / day_partition	string	아니요	하우스키핑에 사용되는 파티션 필드입니다. 내보낸 NDJSON 파일에 포함되고 사용 메트릭 API에서 반환됩니다.
entity_id_partition	integer	아니요	유지 관리에 사용되는 엔터티 파티션입니다. 내보낸 NDJSON 파일에 포함되고 사용 메트릭 API에서 반환됩니다.

사용자별 보고서 필드

사용자별 보고서에는 보고 기간 동안 사용자당 하나의 레코드가 포함됩니다. 사용자별 28일 보고서에는 보고 기간을 표시하기 위해 report_start_day 및 report_end_day도 포함됩니다.

분야	Type	널러블	Description
user_id	integer	아니요	사용자의 고유 식별자입니다.
user_login	string	아니요
GitHub 사용자의 사용자 이름입니다.
ai_credits_used	number	아니요	보고 기간에 사용자가 사용한 총 AI 크레딧입니다. 이 필드는 사용자별 보고서에만 포함되며 기능, 모델 또는 표면별로 세분화되지 않습니다. 이 지표는 청구 총액 산정용이 아니라 소비 분석용입니다.
user_initiated_interaction_count	integer	아니요	에 전송 Copilot된 명시적 프롬프트 수입니다. 모델에 적극적으로 전송된 메시지 또는 프롬프트만 계산합니다. 채팅 패널 열기, 모드 전환(예: 요청, 편집, 계획 또는 에이전트), 바로 가기 키를 사용하여 인라인 UI를 열거나 구성을 변경하는 것은 포함되지 않습니다 .
code_generation_activity_count	integer	아니요	생성된 고유 Copilot 출력 이벤트의 수입니다.
포함: 주석 및 문서 문자열을 포함하여 생성된 모든 콘텐츠입니다.
여러 블록: 단일 사용자 프롬프트의 각 고유 코드 블록은 별도의 생성으로 계산됩니다.
메모: 하나의 프롬프트가 여러 세대를 생성할 user_initiated_interaction_count수 있으므로 이 메트릭은 직접 비교할 수 없습니다.
code_acceptance_activity_count	integer	아니요	사용자가 수락한 제안 또는 코드 블록 수입니다.
총계: '파일에 적용', '커서에 삽입', '터미널에 삽입', 복사 버튼 사용과 같은 모든 기본 제공 작업이 포함됩니다.
해당되지 않음: 수동 OS 클립보드 작업(예: Ctrl+C).
세분성: 각 수락 작업은 초기 프롬프트에서 생성된 코드 블록 수에 관계없이 개수를 한 번 증가합니다.
loc_suggested_to_add_sum	integer	아니요	추가하도록 제안된 코드 Copilot 줄(완료, 인라인 채팅, 채팅 패널 등; 는 에이전트 편집 을 제외 합니다).
loc_suggested_to_delete_sum	integer	아니요	삭제하도록 제안된 코드 Copilot 줄(향후 지원 계획).
loc_added_sum	integer	아니요	실제로 편집기(허용된 완성, 적용된 코드 블록, 에이전트 및 편집 모드)에 추가된 코드 줄입니다.
loc_deleted_sum	integer	아니요	편집기의 코드 줄 삭제 현황(현재는 에이전트 편집에서).
used_agent	boolean	아니요	사용자가 해당 날 IDE에서 에이전트 모드를 사용했는지 여부입니다.
Copilot 코드 검토에 별도로 캡처되는 활동은 used_copilot_code_review_active 및 used_copilot_code_review_passive에 포함되지 않습니다.
used_chat	boolean	아니요	사용자가 그날 IDE 채팅을 사용했는지 여부입니다.
used_cli	boolean	아니요	사용자가 해당 날을 사용 코파일럿 CLI 했는지 여부입니다.
used_copilot_coding_agent	boolean	아니요	사용자가 그날 Copilot 클라우드 에이전트(이전의 Copilot 코딩 에이전트)를 사용했는지 여부입니다.
used_copilot_cloud_agent	boolean	아니요	사용자가 해당 날을 사용 Copilot 클라우드 에이전트 했는지 여부입니다.
used_copilot_coding_agent와 동일한 값을 가지며, 두 이름은 하위 호환성을 위해 유지됩니다.
used_copilot_code_review_active	boolean	예	사용자가 그날 Copilot 코드 검토에 적극적으로 참여했는지 여부입니다. 사용자가 수동으로 검토를 요청 Copilot 하거나 검토 제안을 적용한 경우 활성으로 Copilot 간주됩니다. 해당 날짜에 사용자에 대한 신호가 없는 Copilot 코드 검토 경우 Null입니다.
used_copilot_code_review_passive	boolean	예	그날 사용자가 리뷰에 적극적으로 참여하지 않았는데도 자신의 풀 리퀘스트를 검토하도록 Copilot가 자동으로 할당되었는지 여부입니다. 해당 날짜에 사용자에 대한 신호가 없는 Copilot 코드 검토 경우 Null입니다.
ai_adoption_phase	object	아니요	해당 날짜에 대한 사용자의 AI 채택 단계입니다. 항상 존재하며, 기본값은 "코호트 없음" 단계입니다.
AI 채택 단계 필드를 참조하세요.
totals_by_cli	object	예	사용자에 대한 CLI 관련 메트릭입니다. 사용자가 해당 날짜에 사용하지 않은 코파일럿 CLI 경우 생략됩니다.
메트릭 필드를 참조코파일럿 CLI하세요.
totals_by_ide	array	아니요	Per-IDE 사용자의 활동을 분석합니다.
활동 세분화 개체를 참조하세요.
totals_by_feature	array	아니요	사용자 활동의 기능별 분석입니다.
활동 세분화 개체를 참조하세요.
totals_by_language_feature	array	아니요	언어 및 기능 차원을 결합한 분석 결과입니다.
활동 세분화 개체를 참조하세요.
totals_by_language_model	array	아니요	채팅 활동에 대한 언어 및 모델 차원을 결합한 분석 결과입니다.
활동 세분화 개체를 참조하세요.
totals_by_model_feature	array	아니요	채팅 활동에 대한 모델 및 기능 차원을 결합하는 분석 결과입니다.
활동 세분화 개체를 참조하세요.

집계된 엔터프라이즈 및 조직 보고서 필드

집계된 보고서에는 엔터프라이즈 또는 조직당 하나의 레코드가 포함되어 있으며, 해당 날짜의 모든 사용자를 요약합니다. 활성 사용자 수에는 클라이언트 쪽 및 서버 쪽 원격 분석을 통해 식별된 사용자가 포함됩니다. 서버 쪽 원격 분석을 통해서만 표시되는 사용자는 활성 사용자 합계로 계산되지만 차원 분석 배열(totals_by_ide``totals_by_feature및 유사)에는 나타나지 않을 수 있습니다. 다음 표에는 활성-사용자 수, 활동 합계 및 분석이 나와 있습니다.

활성 사용자 수:

분야	Type	널러블	Description
daily_active_users	integer	아니요	지정된 날짜에 사용한 Copilot 고유 사용자 수입니다.
weekly_active_users	integer	아니요	최근 7일간 Copilot을 사용한 고유 사용자 수입니다.
monthly_active_users	integer	아니요	후행 28일 기간 동안 사용한 Copilot 고유 사용자 수입니다.
monthly_active_chat_users	integer	아니요	후행 28일 기간 동안 채팅을 사용한 고유 사용자 수입니다.
monthly_active_agent_users	integer	아니요	후행 28일 기간 동안 에이전트 모드를 사용한 고유 사용자 수입니다.
daily_active_copilot_cloud_agent_users	integer	아니요	지정된 날짜에 사용한 Copilot 클라우드 에이전트 고유 사용자 수입니다.
weekly_active_copilot_cloud_agent_users	integer	아니요	최근 7일간 Copilot 클라우드 에이전트을 사용한 고유 사용자 수입니다.
monthly_active_copilot_cloud_agent_users	integer	아니요	후행 28일 기간 동안 사용한 Copilot 클라우드 에이전트 고유 사용자 수입니다.
daily_active_copilot_code_review_users	integer	아니요	지정된 날짜에 적극적으로 사용한 Copilot 코드 검토 고유 사용자 수입니다. 활성 사용은 수동으로 검토를 요청하거나 제안을 적용하는 것을 의미합니다. 사용자가 같은 기간에 활성 신호와 수동 신호를 모두 사용하는 경우 활성 신호로만 계산됩니다.
weekly_active_copilot_code_review_users	integer	아니요	최근 7일 동안 Copilot 코드 검토을 적극적으로 사용한 고유 사용자 수입니다. 사용자가 같은 기간에 활성 신호와 수동 신호를 모두 사용하는 경우 활성 신호로만 계산됩니다.
monthly_active_copilot_code_review_users	integer	아니요	후행 28일 기간 동안 적극적으로 사용한 Copilot 코드 검토 고유 사용자 수입니다. 사용자가 같은 기간에 활성 신호와 수동 신호를 모두 사용하는 경우 활성 신호로만 계산됩니다.
daily_passive_copilot_code_review_users	integer	아니요	활성 참여 없이 지정된 날짜에 끌어오기 요청을 검토하도록 자동으로 할당된 고유 사용자 Copilot 코드 검토 수입니다.
weekly_passive_copilot_code_review_users	integer	아니요	최근 7일 동안 활성 참여가 없는 상태에서, 풀 리퀘스트 검토 대상으로 Copilot 코드 검토 이 자동 배정된 고유 사용자 수.
monthly_passive_copilot_code_review_users	integer	아니요	최근 28일 동안 활성 참여가 없는 상태에서, 풀 리퀘스트 검토 대상으로 Copilot 코드 검토 이 자동 배정된 고유 사용자 수.
daily_active_cli_users	integer	예	지정된 날짜에 사용한 코파일럿 CLI 고유 사용자 수입니다. 이 수는 IDE 활성 사용자 수와 독립적 이며 IDE 기반 활성 사용자 정의에 포함되지 않습니다 . 해당 날 CLI 사용량이 없는 엔터프라이즈 또는 조직에 대해서는 생략되었습니다.

활동 합계 및 분석:

분야	Type	널러블	Description
user_initiated_interaction_count	integer	아니요	하루 동안 모든 사용자에게 전송된 Copilot 명시적 프롬프트의 총 수입니다.
code_generation_activity_count	integer	아니요	해당 날짜의 모든 사용자에 대해 생성된 총 고유 Copilot 출력 이벤트 수입니다.
code_acceptance_activity_count	integer	아니요	하루 동안 모든 사용자가 수락한 총 제안 또는 코드 블록 수입니다.
loc_suggested_to_add_sum	integer	아니요	해당 날짜에 추가하도록 제안된 집계된 코드 줄입니다. 사용자별 필드와 동일한 정의입니다.
loc_suggested_to_delete_sum	integer	아니요	하루 동안 삭제하도록 제안된 집계된 코드 줄입니다. 사용자별 필드와 동일한 정의입니다.
loc_added_sum	integer	아니요	해당 날짜에 추가된 집계된 코드 줄입니다. 사용자별 필드와 동일한 정의입니다.
loc_deleted_sum	integer	아니요	하루 동안 삭제된 코드 줄 수의 합계 사용자별 필드와 동일한 정의입니다.
totals_by_ide	array	아니요	IDE별로 집계된 활동 내역.
활동 세분화 개체를 참조하세요.
totals_by_feature	array	아니요	기능별 집계 활동 내역.
활동 세분화 개체를 참조하세요.
totals_by_language_feature	array	아니요	집계된 언어 및 기능 활동 분석.
활동 세분화 개체를 참조하세요.
totals_by_language_model	array	아니요	집계된 언어 및 모델별 활동 세분화.
활동 세분화 개체를 참조하세요.
totals_by_model_feature	array	아니요	집계된 모델 및 기능의 활동 세부 내역.
활동 세분화 개체를 참조하세요.
totals_by_cli	object	예	날짜에 대한 집계된 코파일럿 CLI 메트릭입니다. 해당 날짜에 CLI 사용량이 없는 경우 생략됩니다. 사용자별 양식과 달리 last_known_cli_version는 포함되지 않습니다.
메트릭 필드를 참조코파일럿 CLI하세요.
totals_by_ai_adoption_phase	array	예	사용자 및 해당 평균 활동의 단계별 집계입니다. 채택 단계 데이터를 사용할 수 없는 경우 생략됩니다.
AI 채택 단계 필드를 참조하세요.
pull_requests	object	아니요	엔터프라이즈 또는 조직의 일일 풀 리퀘스트 활동입니다.
끌어오기 요청 활동 필드를 참조하세요.

28일간 보고서 항목

28일 보고서(enterprise-28-day 및 org-28-day)는 래퍼입니다. 즉, 최상위 수준에 보고 기간이 있고 일별 집계 레코드 배열을 포함합니다.

분야	Type	널러블	Description
report_start_day	string	아니요
YYYY-MM-DD 형식의 28일 보고 기간 첫째 날입니다.
report_end_day	string	아니요	28일 보고 기간의 마지막 달력 날짜(형식)YYYY-MM-DD
created_at	string	아니요	보고서가 생성된 타임스탬프(ISO 8601)입니다.
day_totals	array	아니요	매일 집계된 레코드의 배열입니다. 각 항목에는 집계된 1일 보고서와 동일한 필드가 있습니다.
집계된 엔터프라이즈 및 조직 보고서 필드를 참조하세요.

사용자 팀 필드

이러한 필드는 일일 사용자 팀 보고서(조직 및 엔터프라이즈 범위에서 REST API를 통해 사용 가능)에 표시되며 사용자별 사용 메트릭 보고서와 조인하여 팀 수준 메트릭을 생성하는 데 사용됩니다. 전체 조인 레시피 및 엔드포인트 URL은 팀 수준의 Copilot 사용 지표을 참조하세요.

지정된 날짜에 사용자 수가 5 Copilot 명 미만인 팀은 사용자 팀 보고서에서 제외됩니다.

분야	Type	널러블	Description
user_id	integer	아니요	사용자의 고유 식별자입니다.
user_login	string	아니요
GitHub 사용자의 사용자 이름입니다.
day	string	아니요	이 레코드가 나타내는 달력의 날입니다.
organization_id	string	아니요	팀이 속한 조직의 고유 ID입니다. 조직 범위에만 해당.
enterprise_id	string	아니요	팀이 속한 엔터프라이즈의 고유 ID입니다. 엔터프라이즈 범위에만 해당. 엔터프라이즈 범위 보고서에는 엔터프라이즈 팀과 비즈니스 팀이 모두 포함됩니다.
team_id	integer	아니요	사용자가 속한 팀의 고유 ID입니다.
slug	string	아니요	팀의 URL에 사용하기 적합한 식별자입니다.

리포지토리 수준 필드(API에만 해당)

리포지토리 수준 보고서에는 조직 또는 엔터프라이즈의 리포지토리에 대한 일일 끌어오기 요청 생성, 검토, 병합 및 제안 활동이 표시되며, 여기에는 Copilot 클라우드 에이전트가 생성하고 Copilot 코드 검토가 검토한 끌어오기 요청도 포함됩니다. 각 행은 요청된 날짜에 끌어오기 요청 활동이 있는 하나의 리포지토리를 나타냅니다. 활동이 없는 리포지토리는 생략됩니다. 이러한 보고서는 끌어오기 요청 수명 주기 활동에 중점을 두고 IDE 사용 메트릭이 없는 경우에도 데이터를 포함할 수 있습니다.

이러한 필드는 조직 및 엔터프라이즈 범위의 REST API를 통해 사용할 수 있는 일일 리포지토리 수준 보고서(repos-1-day)에서 반환됩니다. 엔드포인트 URL, 응답 봉투, 사용 권한 및 다운로드 워크플로는 Copilot 사용 메트릭에 대한 REST API 엔드포인트을 참조하세요. 예를 들어 행은 Copilot 사용 메트릭에 대한 예제 스키마을 참조하세요.

분야	Type	널러블	Description
day	string	아니요	이 레코드가 나타내는 달력 날짜(형식) YYYY-MM-DD 입니다.
enterprise_id	string	아니요	엔터프라이즈의 고유 ID입니다. 엔터프라이즈 범위 보고서와 엔터프라이즈 소유 조직의 조직 범위 보고서에 표시됩니다. 엔터프라이즈가 소유하지 않은 조직의 경우 비어 있습니다.
organization_id	string	아니요	리포지토리를 소유하는 조직의 고유 ID입니다. 엔터프라이즈 및 조직 범위 보고서에 모두 포함됩니다.
repo_id	integer	아니요	리포지토리의 고유 ID입니다.
repo_owner_name	string	아니요	리포지토리 소유자의 로그인입니다.
repo_name	string	아니요	리포지토리 이름입니다.
repo_visibility	string	아니요	리포지토리 공개 범위 가능한 값은 PRIVATE, INTERNAL 및 PUBLIC입니다.
pull_requests	object	아니요	리포지토리에 대한 일일 끌어오기 요청 작업입니다.
끌어오기 요청 활동 필드를 참조하세요.

활동 세분화 개체

totals_by_* 필드는 세분화 객체의 배열입니다. 배열은 항상 존재하지만 비어 있을 수 있습니다. 각 개체 내에서 메트릭 필드(*_count 및 loc_*_sum)는 사용자별 최상위 필드와 동일한 정의를 따르며 차원 필드는 분석 차원 값에 설명된 값을 전달합니다.

객체	차원 필드	Description
totals_by_ide[]	ide	IDE별 분석. 사용자별 보고서에는 각 항목에 last_known_ide_version 및 last_known_plugin_version도 포함됩니다.
totals_by_feature[]	feature	기능별 Copilot 분석(예: 인라인 채팅 또는 채팅 패널).
totals_by_language_feature[]
language, feature	언어와 기능을 결합한 분류.
user_initiated_interaction_count를 포함하지 않습니다.
totals_by_language_model[]
language, model	채팅 활동(완료가 아님)에 대한 언어와 모델을 결합한 분석입니다.
totals_by_model_feature[]
model, feature	채팅 활동(완료되지 않음)에 대한 모델 및 기능 결합 분석

사용자별 보고서에서 각 totals_by_ide[] 항목은 사용자에 대해 가장 최근에 검색된 IDE 및 공동 파일럿 채팅 확장 버전도 보고합니다.

분야	Type	널러블	Description
last_known_ide_version	object	예	사용자에 대해 검색된 최신 IDE 버전(예: { ide_version, sampled_at }.) 상한이 적용된 "기타" IDE 버킷과 같은 집계된 세부 분류 행에서는 생략됩니다.
last_known_ide_version.ide_version	string	아니요	IDE 버전 문자열입니다.
last_known_ide_version이(가) 있으면 표시됩니다.
last_known_ide_version.sampled_at	string	예	버전이 샘플링된 시각(ISO 8601)
last_known_plugin_version	object	예	사용자에 대해 검색된 가장 최근의 Copilot 확장은 다음과 같습니다 { plugin, plugin_version, sampled_at }. 집계된 세부 분류 행에서는 생략됩니다.
last_known_plugin_version.plugin	string	아니요	확장 이름(예: copilot 또는 copilot-chat).
last_known_plugin_version이(가) 있으면 표시됩니다.
last_known_plugin_version.plugin_version	string	아니요	확장 버전 문자열입니다.
last_known_plugin_version이(가) 있으면 표시됩니다.
last_known_plugin_version.sampled_at	string	예	버전이 샘플링된 시각(ISO 8601)

코파일럿 CLI 메트릭 필드

이 개체에는 totals_by_cli 사용량이 있을 때 코파일럿 CLI 다음 중첩 필드가 포함됩니다. CLI 사용량이 없으면 개체가 생략됩니다. CLI 사용량은 IDE 메트릭과 독립적입니다. 이러한 메트릭은 같은 ****totals_by_ide필드에 반영totals_by_feature. last_known_cli_version 개체는 사용자별 보고서에만 나타납니다.

분야	Type	널러블	Description
totals_by_cli.session_count	integer	아니요	이 날짜에 시작된 고유 CLI 세션 수입니다.
totals_by_cli.request_count	integer	아니요	사용자가 시작한 프롬프트와 자동화된 에이전트 후속 호출을 포함하여 이 날 CLI를 통해 수행 Copilot 된 총 요청 수입니다.
totals_by_cli.prompt_count	integer	아니요	세션 내에서 실행된 총 사용자 프롬프트, 명령 또는 쿼리 수입니다.
totals_by_cli.token_usage.output_tokens_sum	integer	아니요	이 날의 모든 CLI 요청에서 생성된 총 출력 토큰 수입니다.
totals_by_cli.token_usage.prompt_tokens_sum	integer	아니요	이 날의 모든 CLI 요청에서 전송된 총 프롬프트 토큰 수입니다.
totals_by_cli.token_usage.avg_tokens_per_request	number	예	CLI 요청당 출력 및 프롬프트 토큰의 평균 수는 (output_tokens_sum + prompt_tokens_sum) ÷ request_count로 계산됩니다. 그날 요청이 없으면 Null입니다.
totals_by_cli.last_known_cli_version	object	아니요	해당 사용자의 그날 가장 최신 코파일럿 CLI 버전은 { cli_version, sampled_at }로 감지되었습니다. 사용자별 보고서만 보고합니다.
totals_by_cli.last_known_cli_version.cli_version	string	아니요
코파일럿 CLI 버전 문자열입니다. 버전이 감지되지 않으면 unknown가 기본값으로 사용됩니다.
totals_by_cli.last_known_cli_version.sampled_at	string	예	버전이 샘플링된 시각(ISO 8601)

끌어오기 요청 활동 필드

pull_requests 개체는 엔터프라이즈 및 조직의 집계 보고서와 리포지토리 수준 보고서에 표시됩니다. Copilot 클라우드 에이전트 및 Copilot 코드 검토에 의해 수행된 활동을 포함하여, 매일의 풀 리퀘스트 생성, 검토, 병합 및 제안 활동을 집계합니다.

분야	Type	널러블	Description
pull_requests.total_created	integer	아니요	이 특정 날짜에 생성된 총 끌어오기 요청 수입니다. 생성은 일회성 이벤트입니다. 각 끌어오기 요청은 생성된 날짜에만 계산됩니다.
pull_requests.total_reviewed	integer	아니요	특정 날짜에 검토된 총 풀 리퀘스트 수입니다. 동일한 풀 리퀘스트가 여러 날에 걸쳐 리뷰를 받으면, 여러 날에 걸쳐 각각 계산될 수 있습니다. 하루에 여러 검토 작업이 발생하더라도 각 끌어오기 요청은 한 번 계산됩니다.
pull_requests.total_merged	integer	아니요	해당 날짜에 병합 완료된 풀 리퀘스트의 총 개수를 나타냅니다. 병합은 일회성 이벤트입니다. 각 풀 리퀘스트는 병합이 완료된 시점을 기준으로 집계됩니다.
pull_requests.median_minutes_to_merge	number	예	이 특정 날짜에 병합된 끌어오기 요청에 대한 끌어오기 요청 만들기 및 병합 사이의 중간 시간(분)입니다. 중앙값은 이례적으로 오래 지속되는 끌어오기 요청에서 이상값의 영향을 줄이는 데 사용됩니다. 해당 날짜에 병합된 풀 리퀘스트가 없으면 Null입니다.
pull_requests.total_suggestions	integer	아니요	작성자와 관계없이 이 특정 날짜에 생성된 끌어오기 요청 검토 제안의 총 수입니다.
pull_requests.total_applied_suggestions	integer	아니요	작성자와 관계없이 이 특정 날짜에 적용된 끌어오기 요청 검토 제안의 총 수입니다.
pull_requests.total_created_by_copilot	integer	아니요	이 특정 날짜에 생성된 Copilot 클라우드 에이전트 끌어오기 요청 수입니다.
pull_requests.total_reviewed_by_copilot	integer	아니요	이 특정 날짜에 검토된 Copilot 코드 검토 끌어오기 요청 수입니다. 풀 리퀘스트는 Copilot 코드 검토 이 여러 날에 걸쳐 검토하면 여러 날에 걸쳐 계산될 수 있습니다.
pull_requests.total_merged_created_by_copilot	integer	아니요	해당 날짜에 병합된 Copilot 클라우드 에이전트 pull request의 수입니다. 각 풀 리퀘스트는 병합이 완료된 시점을 기준으로 집계됩니다.
pull_requests.total_merged_reviewed_by_copilot	integer	아니요	보고 기간 동안 Copilot 코드 검토 에 의해 검토되고 병합된 풀 요청의 수입니다.
pull_requests.median_minutes_to_merge_copilot_authored	number	예	이 특정 날짜에 Copilot 클라우드 에이전트에 의해 생성되고 병합된 끌어오기 요청에 대해, 생성과 병합 사이의 시간 중간값(분)입니다. 해당 날짜에 이러한 끌어오기 요청이 병합되지 않은 경우 Null입니다.
pull_requests.median_minutes_to_merge_copilot_reviewed	number	예	끌어오기 요청 만들기와 병합 사이의 평균 시간(분)은 검토한 Copilot 코드 검토끌어오기 요청에 대해서만 계산됩니다. 해당 날짜에 이러한 끌어오기 요청이 병합되지 않은 경우 Null입니다.
pull_requests.total_copilot_suggestions	integer	아니요	특정 날짜에 Copilot 코드 검토이(가) 생성한 풀 리퀘스트 검토 제안 수입니다.
pull_requests.total_copilot_applied_suggestions	integer	아니요	이 특정 날짜에 Copilot 코드 검토가 생성한 끌어오기 요청 리뷰 제안 중 적용된 제안의 수입니다.
pull_requests.copilot_suggestions_by_comment_type	array	아니요	할당된 댓글 유형(예: security 또는 bug_risk)별로 세분화한 Copilot 코드 검토 제안의 집계 수입니다. 각 항목에는 comment_type, total_copilot_suggestions및 total_copilot_applied_suggestions. 항상 존재하지만 비워 둘 수 있습니다.

AI 채택 단계 필드

Copilot 활동을 기반으로 사용자를 AI 채택 단계로 그룹화합니다. 단계 정보는 사용자 ai_adoption_phase 별 개체와 집계된 totals_by_ai_adoption_phase 배열의 두 위치에 나타납니다. 단계 값은 분류 차원 값을 참조하세요.

분류 논리

사용자는 used_* 사용자별 필드(사용자별 보고서 필드 참조)가 2일 이상 활성 상태인 단계에 따라 true 단계로 분류됩니다****.

Phase	표면 기준
코호트 없음(영향 대시보드에 "수동 사용자"로 표시됨)	사용자가 해당 기간의 어떤 단계에서도 2일 참여 임계값을 충족하지 못했습니다.
1단계: 첫 번째 코드
used_chat가 true이거나, code_acceptance_activity_count가 0보다 크거나, used_agent가 true인 활성 일수가 최소 2일 이상입니다.
2단계: 에이전트 우선	단일 GitHub 기반 에이전트 환경이 사용된 활성 일수가 최소 2일이며, 다음 중 하나에 해당함: used_cli는 true, used_copilot_cloud_agent는 true, 또는 used_copilot_code_review_active는 true. 수동 Copilot 코드 검토 작업(used_copilot_code_review_passive)은 단계 분류에 포함되지 않습니다.
3단계: 다중 에이전트	2단계 아래에 나열된 두 개 이상의 GitHub 기반 에이전트 표면이 사용된 활성일이 2일 이상입니다.

사용자는 해당 단계에 도달하기 위해 단계 자체 기준에 대해 2일의 적격일만 필요합니다. 실제로 대부분의 에이전트 화면 사용은 완료 또는 채팅 활동과 함께 발생하지만 사용자는 2단계 또는 3단계에 도달하기 위해 1단계 기준을 독립적으로 충족할 필요가 없습니다.

단계 할당은 후행 28일 기간을 사용하여 매일 다시 계산되므로 창 내에서 활동이 이동함에 따라 사용자의 단계가 하루에서 다음 날로 변경될 수 있습니다. 이는 예상된 동작이며 데이터 오류를 나타내지 않습니다.

사용자 ai_adoption_phase 별 개체에는 다음이 포함됩니다.

분야	Type	널러블	Description
ai_adoption_phase.phase_number	integer	아니요	숫자 위상 식별자(예: 0 "코호트 없음").
ai_adoption_phase.phase	string	아니요	사람이 읽을 수 있는 단계 이름입니다.
ai_adoption_phase.version	string	아니요	사용되는 채택 단계 모델의 버전입니다(예: v1).

집계된 totals_by_ai_adoption_phase 배열의 각 항목에는 다음이 포함됩니다.

분야	Type	널러블	Description
phase	string	아니요	사람이 읽을 수 있는 단계 이름입니다.
phase_number	integer	아니요	숫자 단계 식별자입니다.
total_engaged_users	integer	아니요	해당 기간 동안 이 단계로 그룹화된 사용자 수입니다.
avg_user_initiated_interactions	number	아니요	이 단계에서 사용자당 평균 사용자가 시작한 상호작용 수입니다.
avg_code_generation_activities	number	아니요	이 단계의 사용자당 평균 코드 생성 활동입니다.
avg_code_acceptance_activities	number	아니요	이 단계의 사용자당 평균 코드 수락 활동입니다.
avg_loc_added	number	아니요	이 단계에서 사용자당 추가된 평균 코드 줄입니다.
avg_loc_deleted	number	아니요	이 단계에서 사용자당 평균 삭제 코드 라인 수
avg_pull_requests_reviewed	number	아니요	이 단계에서 사용자별로 검토한 평균 풀 리퀘스트 수
avg_pull_requests_created	number	아니요	이 단계에서 사용자당 생성된 평균 끌어오기 요청입니다.
avg_pull_requests_merged	number	아니요	이 단계에서 사용자당 병합된 평균 풀 리퀘스트 수
total_pull_requests_merged	integer	아니요	이 단계에서 사용자가 병합한 총 풀 리퀘스트 수입니다. 조직 일일 및 엔터프라이즈 일일 집계 보고서에 적용됩니다.
avg_pull_requests_median_minutes_to_merge	number	아니요	이 단계 사용자들의 사용자별 병합 완료까지의 중앙값 시간(분)의 평균입니다.

분류 차원 값

위의 분석 개체는 값이 고정 집합에서 오는 차원 필드를 사용합니다. 이러한 값은 별도의 필드가 아니라 필드 값입니다. 예를 들어 agent_edit 및 chat_panel_*_mode 값은 최상위 필드의 값이 아니라 feature 필드의 값입니다.

feature 차원은 활동이 속하는 Copilot 기능 또는 모드를 식별합니다:

가치	Description
code_completion	인라인 코드 완성.
chat_inline	편집기에서 인라인 채팅.
chat_panel_ask_mode	요청 모드가 선택된 채팅 패널 상호 작용
chat_panel_edit_mode	편집 모드가 선택된 채팅 패널 상호 작용
chat_panel_agent_mode	에이전트 모드와 채팅 패널 상호 작용이 선택되었습니다.
chat_panel_plan_mode	계획 모드가 선택된 채팅 패널 상호 작용
chat_panel_custom_mode	선택한 사용자 지정 에이전트와 채팅 패널 상호 작용
chat_panel_unknown_mode	모드를 알 수 없는 채팅 패널 상호 작용입니다.
agent_edit	에이전트 및 편집 모드에서 변경 내용을 IDE의 파일에 직접 쓸 때 Copilot 추가되고 삭제된 줄입니다. 사용자 지정 에이전트의 편집 횟수도 계산합니다.
agent_edit는 제안 기반 메트릭에 포함되지 않으며, user_initiated_interaction_count와 같은 제안 스타일 필드가 채워지지 않을 수 있습니다.
copilot_cli
코파일럿 CLI에 기인한 활동입니다.
others	위의 값에서 다루지 않는 모든 기능입니다.

ide 차원은 활동이 발생한 IDE를 식별합니다. 전체 목록은 아니지만 관찰된 값의 예로는 vscode, ,visualstudio, intellij``eclipse, xcode``neovim, vim``emacs및 zed등이 있습니다.

차원은 model 채팅 활동에 사용되는 AI 모델을 식별합니다. 값에는 특정 모델 식별자(예: gpt-5.4 또는 claude-sonnet-4.6), auto, unknown, 및 others가 포함됩니다. auto 값은 자동 모델 선택이 사용되었고 요청이 특정 모델에 귀속되지 않은 활동을 나타냅니다.

phase 차원은 사용자가 속하는 AI 도입 단계를 식별합니다: No Cohort, Phase 1, Phase 2, 또는 Phase 3.