{"meta":{"title":"에이전트 모니터링을 위한 OpenTelemetry","intro":"에이전트가 모델 및 도구를 수행하고 상호 작용하는 방법을 Copilot 이해합니다.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ko/copilot","title":"GitHub Copilot"},{"href":"/ko/copilot/concepts","title":"개념"},{"href":"/ko/copilot/concepts/agents","title":"배포"},{"href":"/ko/copilot/concepts/agents/opentelemetry","title":"OpenTelemetry"}],"documentType":"article"},"body":"# 에이전트 모니터링을 위한 OpenTelemetry\n\n에이전트가 모델 및 도구를 수행하고 상호 작용하는 방법을 Copilot 이해합니다.\n\nOTel(OpenTelemetry)은 오픈 소스 관찰성 프레임워크입니다. 원격 분석 이벤트 및 메트릭을 수집하고 호환되는 관찰 도구로 내보내는 표준 방법을 제공합니다. 자세한 내용은 OTel 웹사이트의 [OpenTelemetry란 무엇인가요?](https://opentelemetry.io/docs/what-is-opentelemetry/) 문서를 참조하세요.\n\nOTel 모니터링을 사용하도록 설정하면 사용자의 Copilot 클라이언트에서 OTel 호환 백 엔드로 데이터를 보낼 수 있습니다. 이렇게 하면 에이전트 세션을 분석하고 엔터프라이즈 전체의 에이전트 사용량을 이해할 수 있습니다.\n\n## 어떤 데이터를 보내나요 Copilot ?\n\nCopilot 는 다음 세 가지 유형의 데이터를 보냅니다.\n\n* **추적은** 모델 호출 및 도구 사용을 포함하여 에이전트 세션의 흐름을 표시하고 각 단계를 연결합니다. 예를 들어 추적은 에이전트가 모델을 호출하고, 도구를 사용하고 `readFile` , 모델을 다시 호출하여 응답을 생성하는 것을 표시할 수 있습니다.\n* **메트릭은** 시간에 따른 패턴을 식별하는 데 도움이 되는 숫자 측정값입니다. 예를 들어 토큰 사용 메트릭은 모델 호출에 사용되는 입력 및 출력 토큰의 수를 추적합니다.\n* **이벤트는** 특정 시점에 개별 작업을 기록합니다. 예를 들어 피드백 편집 이벤트는 사용자가 에이전트 편집을 수락하거나 거부했는지 여부를 기록합니다.\n\n기본적으로 데이터에는 프롬프트, 응답 또는 도구 인수가 포함되지 않습니다. 이 콘텐츠를 캡처하도록 선택할 수 있지만 코드, 파일 콘텐츠 및 사용자 프롬프트와 같은 중요한 정보가 포함될 수 있습니다.\n\n## OpenTelemetry 사용\n\n사용자의 Copilot 클라이언트에서 OTel 데이터를 수집하려면 다음을 수행합니다.\n\n1. **관찰 가능성 백 엔드를 설정합니다.** 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) 참조하세요.\n2. **사용자의 클라이언트를 구성합니다.** 각 클라이언트에서 OTel을 사용하도록 구성 값을 설정하고 엔드포인트, 헤더 및 인증 토큰을 구성하여 데이터를 OTLP 엔드포인트로 보내도록 구성합니다.\n3. **데이터를 해석합니다.** 수집된 데이터를 사용하여 세션을 분석하고 추세를 식별합니다. 예제 구현은 Microsoft 설명서에서 [Grafana를 사용하여 AI 코딩 에이전트 모니터링](https://learn.microsoft.com/en-gb/azure/managed-grafana/grafana-opentelemetry-app-insights)을 참조하세요.\n\n### 사용자 클라이언트 구성\n\n엔터프라이즈는 관리되는 설정을 사용하여 지원되는 클라이언트에서 OTel 구성을 적용할 수 있습니다. 이러한 설정은 사용자의 클라이언트에 적용되며 재정의할 수 없습니다. 이 속성에는 `telemetry` OpenTelemetry를 사용하도록 설정하고 구성하기 위한 키가 포함됩니다.\n\n자세한 내용은 [엔터프라이즈 관리 설정 구성](/ko/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-managed-settings) 및 [엔터프라이즈 관리 설정](/ko/copilot/reference/enterprise-administrators/enterprise-managed-settings)을(를) 참조하세요.\n\n## 클라이언트 설명서\n\n클라이언트에서 OpenTelemetry를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.\n\n* 설명서[에서 OpenTelemetry를](https://code.visualstudio.com/docs/agents/guides/monitoring-agents)VS Code 사용하여 에이전트 사용량 모니터링\n* [코필로트 SDK용 OpenTelemetry 계측](/ko/copilot/how-tos/copilot-sdk/observability/opentelemetry)\n* [GitHub Copilot CLI 명령 참조](/ko/copilot/reference/copilot-cli-reference/cli-command-reference#opentelemetry-monitoring)"}