OTel(OpenTelemetry)은 오픈 소스 관찰성 프레임워크입니다. 원격 분석 이벤트 및 메트릭을 수집하고 호환되는 관찰 도구로 내보내는 표준 방법을 제공합니다. 자세한 내용은 OTel 웹사이트의 OpenTelemetry란 무엇인가요? 문서를 참조하세요.
OTel 모니터링을 사용하도록 설정하면 사용자의 Copilot 클라이언트에서 OTel 호환 백 엔드로 데이터를 보낼 수 있습니다. 이렇게 하면 에이전트 세션을 분석하고 엔터프라이즈 전체의 에이전트 사용량을 이해할 수 있습니다.
어떤 데이터를 보내나요 Copilot ?
Copilot 는 다음 세 가지 유형의 데이터를 보냅니다.
- 추적은 모델 호출 및 도구 사용을 포함하여 에이전트 세션의 흐름을 표시하고 각 단계를 연결합니다. 예를 들어 추적은 에이전트가 모델을 호출하고, 도구를 사용하고
readFile, 모델을 다시 호출하여 응답을 생성하는 것을 표시할 수 있습니다. - 메트릭은 시간에 따른 패턴을 식별하는 데 도움이 되는 숫자 측정값입니다. 예를 들어 토큰 사용 메트릭은 모델 호출에 사용되는 입력 및 출력 토큰의 수를 추적합니다.
- 이벤트는 특정 시점에 개별 작업을 기록합니다. 예를 들어 피드백 편집 이벤트는 사용자가 에이전트 편집을 수락하거나 거부했는지 여부를 기록합니다.
기본적으로 데이터에는 프롬프트, 응답 또는 도구 인수가 포함되지 않습니다. 이 콘텐츠를 캡처하도록 선택할 수 있지만 코드, 파일 콘텐츠 및 사용자 프롬프트와 같은 중요한 정보가 포함될 수 있습니다.
OpenTelemetry 사용
사용자의 Copilot 클라이언트에서 OTel 데이터를 수집하려면 다음을 수행합니다.
- 관찰 가능성 백 엔드를 설정합니다. OTLP(OpenTelemetry Protocol)를 지원하는 보안 백 엔드를 선택합니다. 일부 백 엔드는 OTLP 데이터를 직접 받을 수 있습니다. 다른 백 엔드의 경우 OpenTelemetry Collector 를 배포하여 데이터를 수신, 처리 및 전달합니다. 예제는 설명서의 VS Code관찰 가능성 백 엔드와 함께 사용을 참조하세요.
- 사용자의 클라이언트를 구성합니다. 각 클라이언트에서 OTel을 사용하도록 구성 값을 설정하고 엔드포인트, 헤더 및 인증 토큰을 구성하여 데이터를 OTLP 엔드포인트로 보내도록 구성합니다.
- 데이터를 해석합니다. 수집된 데이터를 사용하여 세션을 분석하고 추세를 식별합니다. 예제 구현은 Microsoft 설명서에서 Grafana를 사용하여 AI 코딩 에이전트 모니터링을 참조하세요.
사용자 클라이언트 구성
엔터프라이즈는 관리되는 설정을 사용하여 지원되는 클라이언트에서 OTel 구성을 적용할 수 있습니다. 이러한 설정은 사용자의 클라이언트에 적용되며 재정의할 수 없습니다. 이 속성에는 telemetry OpenTelemetry를 사용하도록 설정하고 구성하기 위한 키가 포함됩니다.
자세한 내용은 엔터프라이즈 관리 설정 구성 및 엔터프라이즈 관리 설정을(를) 참조하세요.
클라이언트 설명서
클라이언트에서 OpenTelemetry를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
- 설명서에서 OpenTelemetry를VS Code 사용하여 에이전트 사용량 모니터링
- 코필로트 SDK용 OpenTelemetry 계측
- GitHub Copilot CLI 명령 참조