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

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

• Copilot 사용 메트릭 대시보드는 엔터프라이즈 및 조직 수준에서 사용할 수 있습니다.
• Copilot 사용 지표 API는 엔터프라이즈 수준, 조직 수준, 사용자 수준의 레코드를 지원합니다.

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

Copilot 사용 대시보드 메트릭

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

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

코드 생성 대시보드 메트릭

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

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

API 및 내보내기 필드

이러한 필드는 내보낸 NDJSON 보고서와 Copilot 사용 지표 API에 나타납니다. 메트릭에 따라 엔터프라이즈, 조직 또는 사용자 범위에서 일별 레코드를 제공합니다.

API에서 반환된 데이터의 스키마는 Copilot 사용 메트릭에 대한 예제 스키마을 참조하세요.

분야	Description
agent_edit	IDE 파일에 Copilot(에이전트 및 편집 모드)를 사용하여 직접 변경 사항을 작성하면, 추가되고 삭제된 줄들이 모두 기록됩니다.

          `agent_edit` 는 제안 기반 메트릭에 포함되지 않으며, 제안 스타일 필드(예: `user_initiated_interaction_count`)에 채워지지 않을 수 있습니다. 사용자 지정 에이전트의 편집 횟수도 계산합니다. |

| report_start_day / report_end_day | 28일 보고 기간의 시작 및 종료 날짜입니다. | | day | 이 레코드가 나타내는 달력의 날입니다. | | enterprise_id | 엔터프라이즈의 고유 ID입니다. | | organization_id (API만 해당) | 조직의 고유한 ID. | | user_id / user_login | 사용자의 고유 식별자 및 GitHub 사용자 이름. | | user_initiated_interaction_count | Copilot에 전송된 명시적 프롬프트 수입니다.

모델에 적극적으로 전송된 메시지 또는 프롬프트만 계산합니다. 채팅 패널 열기, 모드 전환(예: 요청, 편집, 계획 또는 에이전트), 바로 가기 키를 사용하여 인라인 UI를 열거나 구성을 변경하는 것은 포함되지 않습니다 . | | chat_panel_agent_mode | 에이전트 모드가 선택된 채팅 패널에서 사용자가 시작한 상호 작용을 캡처합니다. | | chat_panel_ask_mode | 요청 모드가 선택된 채팅 패널에서 사용자가 시작한 상호 작용을 캡처합니다. | | chat_panel_custom_mode | 사용자 지정 에이전트가 선택된 채팅 패널에서 사용자가 시작한 상호 작용을 캡처합니다. | | chat_panel_edit_mode | 편집 모드가 선택된 채팅 패널에서 사용자가 시작한 상호 작용을 캡처합니다. | | chat_panel_unknown_mode | 모드를 알 수 없는 채팅 패널에서 사용자가 시작한 상호 작용을 캡처합니다. | | code_generation_activity_count | 생성된 고유 Copilot 출력 이벤트의 수입니다.

포함: 주석 및 문서 문자열을 포함하여 생성된 모든 콘텐츠입니다.
여러 블록: 단일 사용자 프롬프트의 각 고유 코드 블록은 별도의 생성으로 계산됩니다.
메모: 하나의 프롬프트가 여러 세대를 생성할 user_initiated_interaction_count수 있으므로 이 메트릭은 직접 비교할 수 없습니다. | | code_acceptance_activity_count | 사용자가 수락한 제안 또는 코드 블록 수입니다.

총계: '파일에 적용', '커서에 삽입', '터미널에 삽입', 복사 버튼 사용과 같은 모든 기본 제공 작업이 포함됩니다.
해당되지 않음: 수동 OS 클립보드 작업(예: Ctrl+C).
세분성: 각 수락 작업은 초기 프롬프트에서 생성된 코드 블록 수에 관계없이 개수를 한 번 증가합니다. | | loc_suggested_to_add_sum | Copilot는 완성, 인라인 채팅, 채팅 패널 등 다양한 기능을 활용하여 제안하는 코드 줄입니다(에이전트 편집 제외 ). | | loc_suggested_to_delete_sum | Copilot에서 삭제하도록 제안한 코드 줄(향후 지원 계획)입니다. | | loc_added_sum | 편집기에 실제로 추가된 코드 줄(허용된 완성, 적용된 코드 블록, 에이전트/편집 모드). | | loc_deleted_sum | 편집기의 코드 줄 삭제 현황(현재는 에이전트 편집에서). | | totals_by_ide | 사용된 IDE별 메트릭 분석입니다. | | totals_by_feature | Copilot 기능별 메트릭 분석(예: 인라인 채팅, 채팅 패널)입니다. | | totals_by_language_feature | 언어 및 기능 차원을 결합한 분석 결과입니다. | | totals_by_model_feature / totals_by_language_model | 채팅 활동에 대한 모델별 분석(완료가 아님). 자동 모델 선택가 활성화되면, 활동은 Auto로 표시되는 대신 실제로 사용된 모델에 귀속됩니다. | | last_known_ide_version / last_known_plugin_version | 각 사용자에 대해 감지된 최신 IDE 및 Copilot 채팅 확장 버전입니다. | | daily_active_cli_users | 지정된 날짜에 CLI를 통해 Copilot를 사용한 엔터프라이즈 또는 조직의 고유 사용자 수입니다. 이 필드는 IDE 활성 사용자 수와 독립적 이며 IDE 기반 활성 사용자 정의에 포함되지 않습니다 . 해당 날짜에 CLI 사용량이 없는 엔터프라이즈 또는 조직에서는 생략됩니다. | | totals_by_cli | 지정된 날짜에 엔터프라이즈 또는 조직에 대한 CLI 관련 메트릭 분석입니다. IDE 메트릭과 무관합니다. CLI 사용량은 같은 ****totals_by_ide다른 필드에 반영totals_by_feature. 해당 날짜에 CLI 사용량이 없는 엔터프라이즈 또는 조직에서는 생략됩니다. 다음에 나오는 코파일럿 CLI 메트릭 필드 상세 정보를 확인해 주시기 바랍니다. | | used_cli | 사용자가 해당 날짜에 코파일럿 CLI를 사용했는지 여부를 기록합니다. | | used_agent | 사용자가 그날 IDE 에이전트 모드를 사용했는지 여부를 캡처합니다. | | used_chat | 사용자가 그날 IDE 채팅을 사용했는지 여부를 캡처합니다. |

코파일럿 CLI 지표 필드(API 전용)

          `totals_by_cli` CLI 사용량이 있는 경우 개체에 다음 중첩된 필드가 포함됩니다.

분야	Description
totals_by_cli.session_count	이 날짜에 시작된 고유 CLI 세션 수입니다.
totals_by_cli.request_count	이 날, CLI를 통한 Copilot의 총 요청 수에는 사용자가 직접 요청한 것과 자동화된 에이전트가 후속으로 호출한 것이 모두 포함됩니다.
totals_by_cli.token_usage.output_tokens_sum	이 날의 모든 CLI 요청에서 생성된 총 출력 토큰 수입니다.
totals_by_cli.token_usage.prompt_tokens_sum	이 날의 모든 CLI 요청에서 전송된 총 프롬프트 토큰 수입니다.
totals_by_cli.token_usage.avg_tokens_per_request	CLI 요청당 출력 및 프롬프트 토큰의 평균 수는 (output_tokens_sum + prompt_tokens_sum) ÷ request_count로 계산됩니다.
totals_by_cli.prompt_count	세션 내에서 실행된 총 사용자 프롬프트, 명령 또는 쿼리 수입니다.
totals_by_cli.last_known_cli_version	해당 사용자에게 그날 감지된 최신 코파일럿 CLI 버전입니다.

끌어오기 요청 활동 필드(API에만 해당)

이 필드들은 Copilot의 활동을 비롯해 엔터프라이즈 또는 조직 수준에서 매일 발생하는 풀 리퀘스트 생성, 코드 리뷰, 병합, 제안 등의 활동을 기록합니다.

분야	Description
pull_requests.total_created	이 특정 날짜에 생성된 총 끌어오기 요청 수입니다. 생성은 일회성 이벤트입니다. 각 끌어오기 요청은 생성된 날짜에만 계산됩니다.
pull_requests.total_reviewed	특정 날짜에 검토된 총 풀 리퀘스트 수입니다. 동일한 풀 리퀘스트가 여러 날에 걸쳐 리뷰를 받으면, 여러 날에 걸쳐 각각 계산될 수 있습니다. 하루에 여러 검토 작업이 발생하더라도 각 끌어오기 요청은 한 번 계산됩니다.
pull_requests.total_merged	해당 날짜에 병합 완료된 풀 리퀘스트의 총 개수를 나타냅니다. 병합은 일회성 이벤트입니다. 각 풀 리퀘스트는 병합이 완료된 시점을 기준으로 집계됩니다.
pull_requests.median_minutes_to_merge	이 특정 날짜에 병합된 끌어오기 요청에 대한 끌어오기 요청 만들기 및 병합 사이의 중간 시간(분)입니다. 중앙값은 이례적으로 오래 지속되는 끌어오기 요청에서 이상값의 영향을 줄이는 데 사용됩니다.
pull_requests.total_suggestions	작성자와 관계없이 이 특정 날짜에 생성된 끌어오기 요청 검토 제안의 총 수입니다.
pull_requests.total_applied_suggestions	작성자와 관계없이 이 특정 날짜에 적용된 끌어오기 요청 검토 제안의 총 수입니다.
pull_requests.total_created_by_copilot	이 특정일에 Copilot에서 생성된 끌어오기 요청 수입니다.
pull_requests.total_reviewed_by_copilot	이 날짜에 Copilot가 검토한 풀 리퀘스트의 수입니다. Copilot가 여러 날에 걸쳐 풀 리퀘스트를 검토하면, 해당 풀 리퀘스트는 여러 날에 걸쳐 각각 계산될 수 있습니다.
pull_requests.total_merged_created_by_copilot	특정 날짜에 병합된 Copilot가 생성한 풀 리퀘스트의 개수입니다. 각 풀 리퀘스트는 병합이 완료된 시점을 기준으로 집계됩니다.
pull_requests.median_minutes_to_merge_copilot_authored	Copilot에서 생성되어 해당 날짜에 병합된 풀 리퀘스트의 생성부터 병합까지 소요된 시간(분)입니다.
pull_requests.total_copilot_suggestions	해당 날짜에 Copilot가 생성한 풀 리퀘스트 검토 제안의 총 개수입니다.
pull_requests.total_copilot_applied_suggestions	해당 날짜에 Copilot가 생성하여 적용된 풀 리퀘스트 검토 제안의 총 횟수입니다.