使用 OpenTelemetry 監控代理程式使用情況

本文說明如何在 VS Code 中，為 Copilot Chat 代理程式互動啟用及設定 OpenTelemetry 監控。

Copilot Chat 可以透過 OpenTelemetry (OTel) 匯出追蹤、指標和事件，讓您能夠深入了解代理程式互動、LLM 呼叫、工具執行和權杖使用情況。所有訊號名稱和屬性都遵循 OTel GenAI 語意慣例，因此資料可與任何 OTel 相容的後端搭配使用。

收集什麼內容

Copilot Chat 發出三種類型的 OTel 訊號：追蹤、指標和事件。

追蹤

每個代理程式互動都會產生一個階層式 Span 樹，捕捉完整的執行流程

invoke_agent copilot                           [~15s]
  ├── chat gpt-4o                              [~3s]  (LLM requests tool calls)
  ├── execute_tool readFile                    [~50ms]
  ├── execute_tool runCommand                  [~2s]
  ├── chat gpt-4o                              [~4s]  (LLM generates final response)
  └── (span ends)

三種 Span 類型構成追蹤

當代理程式叫用子代理程式時 (例如，透過 runSubagent 工具)，追蹤內容會自動傳播。子代理程式的 invoke_agent span 會顯示為父代理程式的 execute_tool span 的子項，產生跨非同步邊界的連線追蹤樹。

指標

指標包含用於篩選的屬性，例如 gen_ai.request.model、gen_ai.provider.name、gen_ai.tool.name 和 error.type。

活動

資源屬性

所有訊號都帶有這些資源屬性

使用 OTEL_RESOURCE_ATTRIBUTES 新增自訂資源屬性，以依團隊、部門或其他組織界線進行篩選

export OTEL_RESOURCE_ATTRIBUTES="team.id=platform,department=engineering"

內容擷取

預設情況下，不會擷取提示內容、回應或工具引數。僅包含模型名稱、權杖計數和持續時間等中繼資料。

若要擷取完整內容，請啟用 github.copilot.chat.otel.captureContent Open in VS Code Open in VS Code Insiders 設定，或設定 COPILOT_OTEL_CAPTURE_CONTENT=true。這會將完整的提示訊息、回應訊息、系統提示、工具結構描述、工具引數和工具結果填入 span 屬性。

啟用 OTel 監控

符合下列任何條件時，OTel 會啟用

• github.copilot.chat.otel.enabled Open in VS Code Open in VS Code Insiders 為 true
• COPILOT_OTEL_ENABLED=true
• 已設定 OTEL_EXPORTER_OTLP_ENDPOINT

VS Code 設定

開啟設定 (⌘, (Windows、Linux Ctrl+,))，並搜尋 copilot otel

環境變數

環境變數始終優先於 VS Code 設定。

搭配可觀測性後端使用

Copilot Chat 的 OTel 輸出可與任何支援 OTLP 協定的後端搭配使用。將 github.copilot.chat.otel.otlpEndpoint Open in VS Code Open in VS Code Insiders 設定或 OTEL_EXPORTER_OTLP_ENDPOINT 環境變數指向後端的 OTLP 擷取 URL，並設定匯出器類型以符合後端的協定 (otlp-http 或 otlp-grpc)。

Aspire Dashboard

Aspire Dashboard 是本機開發最簡單的選項。它是一個單一的 Docker 容器，內建 OTLP 端點和追蹤檢視器，而且不需要雲端帳戶。

docker run --rm -d \
  -p 18888:18888 \
  -p 4317:18889 \
  --name aspire-dashboard \
  mcr.microsoft.com/dotnet/aspire-dashboard:latest

{
  "github.copilot.chat.otel.enabled": true,
  "github.copilot.chat.otel.exporterType": "otlp-grpc",
  "github.copilot.chat.otel.otlpEndpoint": "https://:4317"
}

開啟 https://:18888 並前往追蹤以檢視您的代理程式互動 Span。

Jaeger

Jaeger 是一個開放原始碼分散式追蹤平台，可直接接受 OTLP。

docker run -d --name jaeger -p 16686:16686 -p 4318:4318 jaegertracing/jaeger:latest

{
  "github.copilot.chat.otel.enabled": true,
  "github.copilot.chat.otel.otlpEndpoint": "https://:4318"
}

開啟 https://:16686，選取服務 copilot-chat，然後選取尋找追蹤。

Azure Application Insights

使用 OTel 收集器搭配 Azure Monitor 匯出器，將 Copilot Chat 遙測資料轉發到 Application Insights。將 VS Code github.copilot.chat.otel.otlpEndpoint Open in VS Code Open in VS Code Insiders 設定指向收集器的 OTLP 端點，並將收集器設定為匯出到您的 Application Insights 連線字串。

Langfuse

Langfuse 是一個開放原始碼 LLM 可觀測性平台，具有原生 OTLP 擷取功能，並支援 OTel GenAI 語意慣例。

{
  "github.copilot.chat.otel.enabled": true,
  "github.copilot.chat.otel.otlpEndpoint": "https://:3000/api/public/otel",
  "github.copilot.chat.otel.captureContent": true
}

使用 OTEL_EXPORTER_OTLP_HEADERS 環境變數設定驗證標頭。如需詳細資訊，請參閱 Langfuse OTel 文件。

其他後端

任何 OTLP 相容的後端都可運作，包括 Grafana Tempo、Honeycomb 和 Datadog。請參閱各後端的文件以了解 OTLP 擷取設定。

安全性與隱私

OTel 監控預設為關閉，除非您明確啟用，否則不會發出任何資料。您可以控制收集哪些內容以及資料傳送至何處。

相關內容

• Copilot 設定參考
• 針對 VS Code 中的 AI 進行疑難排解
• OTel GenAI 語意慣例
• Aspire Dashboard 獨立文件