# 에이전트 모니터링을 위한 OpenTelemetry

에이전트가 모델 및 도구를 수행하고 상호 작용하는 방법을 Copilot 이해합니다.

OTel(OpenTelemetry)은 오픈 소스 관찰성 프레임워크입니다. 원격 분석 이벤트 및 메트릭을 수집하고 호환되는 관찰 도구로 내보내는 표준 방법을 제공합니다. 자세한 내용은 OTel 웹사이트의 [OpenTelemetry란 무엇인가요?](https://opentelemetry.io/docs/what-is-opentelemetry/) 문서를 참조하세요.

OTel 모니터링을 사용하도록 설정하면 사용자의 Copilot 클라이언트에서 OTel 호환 백 엔드로 데이터를 보낼 수 있습니다. 이렇게 하면 에이전트 세션을 분석하고 엔터프라이즈 전체의 에이전트 사용량을 이해할 수 있습니다.

## 어떤 데이터를 보내나요 Copilot ?

Copilot 는 다음 세 가지 유형의 데이터를 보냅니다.

* **추적은** 모델 호출 및 도구 사용을 포함하여 에이전트 세션의 흐름을 표시하고 각 단계를 연결합니다. 예를 들어 추적은 에이전트가 모델을 호출하고, 도구를 사용하고 `readFile` , 모델을 다시 호출하여 응답을 생성하는 것을 표시할 수 있습니다.
* **메트릭은** 시간에 따른 패턴을 식별하는 데 도움이 되는 숫자 측정값입니다. 예를 들어 토큰 사용 메트릭은 모델 호출에 사용되는 입력 및 출력 토큰의 수를 추적합니다.
* **이벤트는** 특정 시점에 개별 작업을 기록합니다. 예를 들어 피드백 편집 이벤트는 사용자가 에이전트 편집을 수락하거나 거부했는지 여부를 기록합니다.

기본적으로 데이터에는 프롬프트, 응답 또는 도구 인수가 포함되지 않습니다. 이 콘텐츠를 캡처하도록 선택할 수 있지만 코드, 파일 콘텐츠 및 사용자 프롬프트와 같은 중요한 정보가 포함될 수 있습니다.

## OpenTelemetry 사용

사용자의 Copilot 클라이언트에서 OTel 데이터를 수집하려면 다음을 수행합니다.

1. **관찰 가능성 백 엔드를 설정합니다.** OTLP(OpenTelemetry Protocol)를 지원하는 보안 백 엔드를 선택합니다. 일부 백 엔드는 OTLP 데이터를 직접 받을 수 있습니다. 다른 백 엔드의 경우 [OpenTelemetry Collector](https://opentelemetry.io/docs/collector/) 를 배포하여 데이터를 수신, 처리 및 전달합니다. 예제는 설명서의 VS Code[관찰 가능성 백 엔드와 함께 사용을](https://code.visualstudio.com/docs/agents/guides/monitoring-agents#_use-with-observability-backends) 참조하세요.
2. **사용자의 클라이언트를 구성합니다.** 각 클라이언트에서 OTel을 사용하도록 구성 값을 설정하고 엔드포인트, 헤더 및 인증 토큰을 구성하여 데이터를 OTLP 엔드포인트로 보내도록 구성합니다.
3. **데이터를 해석합니다.** 수집된 데이터를 사용하여 세션을 분석하고 추세를 식별합니다. 예제 구현은 Microsoft 설명서에서 [Grafana를 사용하여 AI 코딩 에이전트 모니터링](https://learn.microsoft.com/en-gb/azure/managed-grafana/grafana-opentelemetry-app-insights)을 참조하세요.

### 사용자 클라이언트 구성

엔터프라이즈는 관리되는 설정을 사용하여 지원되는 클라이언트에서 OTel 구성을 적용할 수 있습니다. 이러한 설정은 사용자의 클라이언트에 적용되며 재정의할 수 없습니다. 이 속성에는 `telemetry` OpenTelemetry를 사용하도록 설정하고 구성하기 위한 키가 포함됩니다.

자세한 내용은 [엔터프라이즈 관리 설정 구성](/ko/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-managed-settings) 및 [엔터프라이즈 관리 설정](/ko/enterprise-cloud@latest/copilot/reference/enterprise-administrators/enterprise-managed-settings)을(를) 참조하세요.

## 클라이언트 설명서

클라이언트에서 OpenTelemetry를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.

* 설명서[에서 OpenTelemetry를](https://code.visualstudio.com/docs/agents/guides/monitoring-agents)VS Code 사용하여 에이전트 사용량 모니터링
* [코필로트 SDK용 OpenTelemetry 계측](/ko/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/observability/opentelemetry)
* [GitHub Copilot CLI 명령 참조](/ko/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#opentelemetry-monitoring)