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

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

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

이러한 메트릭을 읽고 해석하는 방법에 대한 지침은 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 보고서 및 사용 메트릭 API에 Copilot 표시됩니다. 메트릭에 따라 엔터프라이즈, 조직 또는 사용자 범위에서 일별 레코드를 제공합니다.

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 및 공동 파일럿 채팅 확장 버전입니다. | | 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에서 에이전트 모드를 사용했는지 여부를 캡처합니다. Copilot 코드 검토에 별도로 캡처되는 활동은 used_copilot_code_review_active 및 used_copilot_code_review_passive에 포함되지 않습니다. | | used_chat | 사용자가 그날 IDE 채팅을 사용했는지 여부를 캡처합니다. | | used_copilot_code_review_active | 사용자가 해당 날짜에 적극적으로 참여 Copilot 코드 검토 했는지 여부를 캡처합니다. 사용자가 수동으로 검토를 요청 Copilot 하거나 검토 제안을 적용한 경우 활성으로 Copilot 간주됩니다. | | used_copilot_code_review_passive | 사용자가 Copilot 검토에 적극적으로 참여하지 않고 해당 날짜에 끌어오기 요청을 검토하도록 자동으로 할당했는지 여부를 캡처합니다. |

          코파일럿 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 request의 수입니다. 각 풀 리퀘스트는 병합이 완료된 시점을 기준으로 집계됩니다.
pull_requests.median_minutes_to_merge_copilot_authored	이 특정 날짜에 Copilot에 의해 생성되고 병합된 끌어오기 요청에 대해, 생성과 병합 사이의 시간 중간값(분)입니다.
pull_requests.total_copilot_suggestions	특정 날짜에 Copilot이(가) 생성한 풀 리퀘스트 검토 제안 수입니다.
pull_requests.total_copilot_applied_suggestions	이 특정 날짜에 Copilot가 생성한 끌어오기 요청 리뷰 제안 중 적용된 제안의 수입니다.