人工智能AI 应用AI Agent代码智能体交互助手工具调用MCP Clients【免费下载链接】vscode-copilot-chatCopilot Chat extension for VS Code项目地址https://gitcode.com/gh_mirrors/vs/vscode-copilot-chat点击查看免费下载本文是 vscode-copilot-chat 扩展 OpenTelemetry 插桩的开发者指南聚焦docs/monitoring/agent_monitoring_arch.md所描述的架构设计前台 Agent、进程内 Copilot CLI、终端 Copilot CLI、Claude Code 四条执行路径为何采用四种截然不同的追踪策略以及CopilotCliBridgeSpanProcessor如何把 SDK 原生 Span 桥接到调试面板。读完本文你将掌握该扩展 OTel 服务的代码结构、Span 层级约定、配置解析链路与插桩扩展模式可直接对照源码继续深入。用户视角的配置与使用说明见 agent_monitoring.md可视化数据流图见 otel-data-flow.html。多 Agent 架构四条执行路径四种追踪策略扩展中存在四条 agent 执行路径它们运行在不同进程中OTel 插桩策略也因此不对称Agent进程模型策略调试面板数据源前台 AgenttoolCallingLoopExtension host直接使用IOTelService创建 Span扩展自建 SpanCopilot CLI 进程内Extension host同进程Bridge SpanProcessor— SDK 原生创建 Span桥接转发至调试面板经桥接的 SDK 原生 SpanCopilot CLI 终端独立终端进程转发 OTel 环境变量N/A独立进程Claude Code子进程Node fork合成 Span— 扩展从消息循环中自行创建 Span扩展合成 Span为什么不对称CLI SDK 与扩展同进程运行拥有完整的追踪层级subagent、permissions、hooks桥接可以直接捕获而 Claude Code 是独立子进程内部 Span 无法访问合成 Span 成为唯一选择。Copilot CLI Bridge SpanProcessorSDK 原生 Span 的桥接转发扩展向 SDK 的BasicTracerProvider注入CopilotCliBridgeSpanProcessor把已完成的 Span 转发到调试面板。核心调用链如下Extension Roottracer A invoke_agent copilotcli → traceparent → SDK SDK Nativetracer B同一 traceId invoke_agent → chat → execute_tool → invoke_agent (subagent) → permission → ... BridgeSDK Provider B → MultiSpanProcessor._spanProcessors.push(bridge) → onEnd(ReadableSpan) → ICompletedSpanData CHAT_SESSION_ID → IOTelService.injectCompletedSpan → onDidCompleteSpan → Debug Panel File Logger⚠️ SDK 内部访问警告桥接访问_delegate._activeSpanProcessor._spanProcessors——这是 OTel SDK v2BasicTracerProvider的内部属性。v2 移除了公开的addSpanProcessor()APISDK 自身在forceFlush()中也使用相同模式。这在 OTel SDK 大版本升级时可能失效桥接内置了运行时守卫可优雅降级。从源码看桥接实现于 copilotCliBridgeSpanProcessor.ts其关键机制包括traceId → sessionId 映射registerTrace()/unregisterTrace()维护映射表onEnd()时仅为已注册的 CLI 会话注入copilot_chat.chat_session_id防止前台 agent 的 Span 泄漏进 CLI 会话的调试面板桶。Hook Span 富化SDK 原生hook xxxSpan 通过github.copilot.hook.invocation_id关联会话事件数据重映射为execute_hook {hook_type}并补充copilot_chat.hook_input/hook_output/hook_result_kind等属性若hook.end数据未到Span 会暂存于_pendingHookSpans待数据到达后再注入。安装时机桥接在首次会话创建后安装一次_installBridgeIfNeeded()见 copilotcliSessionService.ts。通过opentelemetry/api的trace.getTracerProvider()拿到全局 Provider再沿_delegate → _activeSpanProcessor → _spanProcessors内部路径注入桥接处理器。Span 层级四种执行路径的追踪树前台 Agentinvoke_agent copilot (INTERNAL) ← toolCallingLoop.ts ├── chat gpt-4o (CLIENT) ← chatMLFetcher.ts │ ├── execute_tool readFile (INTERNAL) ← toolsService.ts │ └── execute_tool runCommand (INTERNAL) ├── chat gpt-4o (CLIENT) └── ...Copilot CLI 进程内Bridgeinvoke_agent copilotcli (INTERNAL) ← copilotcliSession.tstracer A └── [traceparent linked] invoke_agent (CLIENT) ← SDK OtelSessionTrackertracer B ├── chat claude-opus-4.6-1m (CLIENT) ├── execute_tool task (INTERNAL) │ └── invoke_agent task (CLIENT) ← SUBAGENT │ ├── chat claude-opus-4.6-1m │ ├── execute_tool bash │ │ └── permission │ └── execute_tool report_intent ├── chat claude-opus-4.6-1m (CLIENT) └── ...从 copilotcliSession.ts 的源码可见扩展创建invoke_agent copilotcli根 Span 后通过getSpanContext()取得 traceId/spanId 拼接 W3Ctraceparent00-{traceId}-{spanId}-01再经_updateSdkTraceContext()交给 SDK从而实现两个 TracerProvider 之间的显式上下文传播。Copilot CLI 终端独立invoke_agent (CLIENT) ← 独立 copilot 二进制 │ service.name github-copilot ├── chat gpt-4o (CLIENT) └── 独立根 trace与扩展无链接Claude Code合成invoke_agent claude (INTERNAL) ← claudeCodeAgent.ts ├── chat claude-sonnet-4 (CLIENT) ← chatMLFetcher.ts (FREE) ├── execute_hook PreToolUse (INTERNAL) ← claudeHookRegistry.ts ├── execute_tool Read (INTERNAL) ← message loop ├── execute_hook PostToolUse (INTERNAL) ← claudeHookRegistry.ts ├── chat claude-sonnet-4 (CLIENT) ├── execute_hook PreToolUse (INTERNAL) ├── execute_tool Edit (INTERNAL) ├── execute_hook PostToolUse (INTERNAL) └── 扁平层级无 subagent 嵌套文件结构与插桩点OTel 相关代码分布在src/platform/otel/与 Copilot CLI 会话目录中src/platform/otel/ ├── common/ │ ├── otelService.ts # IOTelService 接口 ISpanHandle injectCompletedSpan │ ├── otelConfig.ts # 配置解析env → settings → defaults │ ├── noopOtelService.ts # 零成本 no-op 实现 │ ├── agentOTelEnv.ts # deriveCopilotCliOTelEnv / deriveClaudeOTelEnv │ ├── genAiAttributes.ts # GenAI 语义约定属性键 │ ├── genAiEvents.ts # 事件发射辅助 │ ├── genAiMetrics.ts # GenAiMetrics 类指标记录 │ ├── messageFormatters.ts # Message → OTel JSON schema 转换器 │ ├── index.ts # 公共 API 桶导出 │ └── test/ └── node/ ├── otelServiceImpl.ts # NodeOTelService真实 SDK 实现 ├── inMemoryOTelService.ts # InMemoryOTelService调试面板无 SDK ├── fileExporters.ts # 基于文件的 span/log/metric 导出器 └── test/ src/extension/chatSessions/copilotcli/node/ ├── copilotCliBridgeSpanProcessor.ts # 桥接SDK Span → IOTelService ├── copilotcliSession.ts # 根 invoke_agent Span traceparent └── copilotcliSessionService.ts # 桥接安装 环境变量设置 src/extension/trajectory/vscode-node/ ├── otelChatDebugLogProvider.ts # 调试面板数据提供器 └── otelSpanToChatDebugEvent.ts # Span → ChatDebugEvent 转换插桩点一览文件插桩内容chatMLFetcher.tschatSpan — 所有 LLM API 调用前台 Claude 代理anthropicProvider.tschatSpan — BYOK Anthropic 请求toolCallingLoop.tsinvoke_agentSpan — 前台 agent 编排toolsService.tsexecute_toolSpan — 前台工具调用copilotcliSession.tsinvoke_agent copilotcli包装 Span traceparent 传播copilotCliBridgeSpanProcessor.ts桥接SDKReadableSpan→ICompletedSpanDatacopilotcliSessionService.ts桥接安装 SDK 的 OTel 环境变量copilotCLITerminalIntegration.ts向终端进程转发 OTel 环境变量claudeCodeAgent.tsinvoke_agent claudeexecute_tool合成 SpanclaudeHookRegistry.tsexecute_hookSpan — Claude hook 执行otelSpanToChatDebugEvent.tsSpan → 调试面板事件转换服务层IOTelService 抽象接口设计IOTelService定义于 otelService.ts是核心抽象——所有消费方只依赖此接口绝不直接依赖 OTel SDK。关键方法startSpan/startActiveSpan— 创建追踪 SpaninjectCompletedSpan— 注入外部创建的 Span桥接使用onDidCompleteSpan— 任意 Span 结束时触发的事件调试面板监听onDidEmitSpanEvent— Span 事件addEvent同步触发用于流式展示进行中的 Span 事件recordMetric/incrementCounter— 指标emitLogRecord— OTel 日志事件storeTraceContext/getStoredTraceContext/runWithTraceContext— 跨边界传播flush/shutdown— 生命周期管理配套类型包括ISpanHandle轻量 Span 句柄提供setAttribute/setStatus/recordException/addEvent/getSpanContext/end、ICompletedSpanData可序列化的完成 Span 快照供调试面板消费、TraceContext可跨边界的 traceId spanId。三种实现类使用时机NoopOTelServiceOTel 禁用默认— 零成本NodeOTelServiceOTel 启用 — 完整 SDK、OTLP 导出InMemoryOTelService调试面板常开 — 无 SDK仅内存同进程双 TracerProviderCLI SDK 激活且 OTel 启用时进程内存在两个 ProviderProvider ANodeOTelService扩展的 Provider保存的 tracer 引用在全局覆盖后依然存活Provider BBasicTracerProviderSDK 的 Provider取代 A 成为全局 Provider两者导出到同一 OTLP 端点。桥接处理器挂在 Provider B 上将 Span 转发至 Provider A 的事件发射器。配置分层优先级与 Agent 环境变量翻译resolveOTelConfig()实现于 otelConfig.ts按以下优先级解析COPILOT_OTEL_*环境变量最高OTEL_EXPORTER_OTLP_*标准环境变量VS Code 设置github.copilot.chat.otel.*默认值最低总开关telemetry.telemetryLevel off时所有 OTel 全部禁用kill switch。源码层面值得注意的细节COPILOT_OTEL_ENABLED布尔解析支持true/1OTEL_EXPORTER_OTLP_ENDPOINT存在本身即可激活 OTelotlpEndpointEnvVar渠道gRPC 端点会被解析为 originscheme://host:portHTTP 端点为完整 hrefCOPILOT_OTEL_FILE_EXPORTER_PATH存在时 exporterType 强制为file。配置对象通过Object.freeze冻结保证不可变。Agent 专属环境变量翻译扩展配置Copilot CLI 环境变量Claude Code 环境变量enabledCOPILOT_OTEL_ENABLEDtrueCLAUDE_CODE_ENABLE_TELEMETRY1otlpEndpointOTEL_EXPORTER_OTLP_ENDPOINTOTEL_EXPORTER_OTLP_ENDPOINTcaptureContentOTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENTtrueOTEL_LOG_USER_PROMPTS1fileExporterPathCOPILOT_OTEL_FILE_EXPORTER_PATHN/A翻译逻辑见 agentOTelEnv.ts两个推导函数都只设置process.env中尚未存在的变量因此用户显式设置的环境变量可作为 per-agent 覆盖。deriveClaudeOTelEnv还会额外设置OTEL_METRICS_EXPORTERotlp、OTEL_LOGS_EXPORTERotlp并在captureContent开启时设置OTEL_LOG_TOOL_DETAILS1Claude 无文件导出器。调试面板常开行为CLI SDK 的 OTelOtelLifecycle无论用户 OTel 设置如何都始终初始化确保调试面板始终通过桥接收到 SDK 原生 Span。COPILOT_OTEL_ENABLED在LocalSessionManager构造前设置SDK 才能创建其OtelSessionTracker见 copilotcliSessionService.ts。用户 OTel禁用SDK Span 经桥接 → 仅调试面板无 OTLP 导出SDK 文件导出器指向/dev/null用户 OTel启用SDK Span 经桥接 → 调试面板且经 SDK 自身BatchSpanProcessor→ OTLP内容捕获行为矩阵CLI SDK 用单一captureContent标志OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT同时控制调试面板与 OTLP 导出的内容捕获。扩展按以下优先级在 SDK 初始化前设置该标志#OTel 启用captureContentenvcaptureContent设置SDK 标志调试面板内容OTLP 内容1否未设置未设置true有N/A文件 → /dev/null2否未设置truetrue有N/A文件 → /dev/null3否未设置falsetrue有N/A文件 → /dev/null4是未设置未设置false无无5是未设置truetrue有有6是未设置falsefalse无无7是true任意true有有8是false任意false无无9否true任意true有N/A文件 → /dev/null10否false任意false无N/A文件 → /dev/null关键设计决策行 1–3OTel 禁用时扩展强制captureContenttrue让调试面板始终显示完整内容OTLP 通过指向/dev/null的文件导出器抑制内容不会外泄。行 4–6OTel 启用时扩展尊重用户的captureContent设置因为 OTLP 处于激活状态内容可能被导出到外部 collector。行 7–8、9–10显式环境变量覆盖始终生效标准 OTel 优先级。已知限制单一captureContent标志CLI SDK 仅暴露一个布尔标志同时作用于本地调试面板与远程OTLP通道无法只开启调试面板内容而抑制 OTLP反之亦然。这意味着OTel 启用且captureContent: false默认时调试面板也会丢失 prompt/response 正文。想在 OTel 启用时于调试面板看到内容必须设captureContent: true——但这也会把内容发送到 OTLP。为什么扩展层无法修复SDK 在 Span 创建时捕获内容Span 到达桥接或导出器时内容已存在或缺失事后无法增删。ReadableSpan对象不可变桥接与 OTLP 导出器都无法选择性剥离或注入属性。运行两个不同captureContent标志的 SDK 实例在架构上不可行。未来的 SDK 增强可为本地与导出通道提供独立标志。service.name取值来源service.name扩展Provider Acopilot-chatCopilot CLI SDK / 终端github-copilotClaude Code 子进程claude-codeSpan 约定与内容捕获命名约定遵循 OTel GenAI 语义约定常量取自 genAiAttributes.ts操作Span 名称KindAgent 编排invoke_agent {agent_name}INTERNALLLM API 调用chat {model}CLIENT工具执行execute_tool {tool_name}INTERNALHook 执行execute_hook {hook_type}INTERNAL调试面板直接使用 Span 名称展示与 Grafana 一致工具调用execute_tool {tool_name}、hook 执行execute_hook {hook_type}、subagent 调用invoke_agent {agent_name}不带 agent 名的 SDK 包装invoke_agentSpan 作为透明容器被跳过。错误处理span.setStatus(SpanStatusCode.ERROR, error.message); span.setAttribute(StdAttr.ERROR_TYPE, error.constructor.name);内容捕获以otel.config.captureContent为门控if (this._otelService.config.captureContent) { span.setAttribute(GenAiAttr.INPUT_MESSAGES, JSON.stringify(messages)); }添加插桩的两种标准模式模式一包装一个操作return this._otel.startActiveSpan( execute_tool myTool, { kind: SpanKind.INTERNAL, attributes: { [GenAiAttr.TOOL_NAME]: myTool } }, async (span) { try { const result await this._actualWork(); span.setStatus(SpanStatusCode.OK); return result; } catch (err) { span.setStatus(SpanStatusCode.ERROR, err instanceof Error ? err.message : String(err)); throw err; } }, );模式二跨边界 trace 传播// 父存储上下文 const ctx this._otelService.getActiveTraceContext(); if (ctx) { this._otelService.storeTraceContext(subagent:${id}, ctx); } // 子取回并用其作为父 const parentCtx this._otelService.getStoredTraceContext(subagent:${id}); return this._otel.startActiveSpan(invoke_agent child, { parentTraceContext: parentCtx }, ...);这种存储-取回模式正是 subagent 追踪树跨异步边界连通的关键父的 trace 上下文在runSubagent开始时存储子 agent 开始invoke_agentSpan 时取回作为父。属性命名空间命名空间使用者示例gen_ai.*所有 agent标准gen_ai.operation.name、gen_ai.usage.input_tokenscopilot_chat.*扩展专属copilot_chat.session_id、copilot_chat.chat_session_idgithub.copilot.*CLI SDK 内部github.copilot.cost、github.copilot.aiuclaude_code.*Claude 子进程claude_code.token.usage、claude_code.cost.usage调试面板与 OTLP 隔离调试面板创建的 Span 使用非标准操作名content_event、user_message绝不能出现在用户的 OTLP collector 中。NodeOTelService中的DiagnosticSpanExporter过滤 Span仅导出invoke_agent、chat、execute_tool、embeddings、execute_hook五种操作。其中execute_hook操作同时被前台 agenttoolCallingLoop.ts与 Claude hooksclaudeHookRegistry.ts使用。调试面板专属 Span 通过onDidCompleteSpan可见但被排除在 OTLP 批量导出之外。测试体系测试覆盖配置解析、环境变量推导、桥接处理器与导出器src/platform/otel/common/test/ ├── agentOTelEnv.spec.ts # 环境变量推导 ├── genAiEvents.spec.ts ├── genAiMetrics.spec.ts ├── messageFormatters.spec.ts ├── noopOtelService.spec.ts └── otelConfig.spec.ts src/platform/otel/node/test/ ├── fileExporters.spec.ts └── traceContextPropagation.spec.ts src/extension/chatSessions/copilotcli/node/test/ └── copilotCliBridgeSpanProcessor.spec.ts # 桥接处理器测试运行npm test -- --grep OTel\|Bridge。此外src/platform/otel/common/test/下还有agentTraceHierarchy.spec.ts、chatMLFetcherSpanLifecycle.spec.ts、byokProviderSpans.spec.ts等测试分别验证 agent 追踪层级、chat Span 生命周期与 BYOK 提供方 Span。风险与已知限制风险影响缓解SDK_spanProcessors内部访问OTel SDK v2 小/大版本更新可能破坏运行时守卫 优雅回退SDK 自身在forceFlush()中使用相同模式同进程双 TracerProviderSpan 上下文可能不跨 Provider 边界扩展保存 tracer 引用显式传播 traceparent为 CLI SDK 修改process.env影响整个 extension host仅设置 OTel 专属变量在 SDK 构造前设置OTLP 中出现重复invoke_agentSpan扩展根 SDK 根都被导出不同service.name加以区分Claude 不支持文件导出器Claude 子进程无法写 JSON-lines 文件文档化限制CLI 运行时仅支持otlp-http终端 CLI 无法使用仅 gRPC 端点文档化限制小结vscode-copilot-chat 的 OTel 插桩以IOTelService接口为统一抽象针对四条 agent 执行路径分别采用直接插桩、Bridge 桥接、环境变量转发与合成 Span 四种策略。其核心价值在于即使 OTel 导出被禁用调试面板也能通过常开 桥接机制持续呈现 SDK 原生追踪树而captureContent单标志的设计约束则清晰地界定了本地展示与远程导出的安全边界。开发者可按本文的两种标准模式为新的 agent 能力添加插桩并通过service.name与命名空间约定保证数据在任意 OTLP 后端中可区分、可关联。赞分享人工智能AI 应用AI Agent代码智能体交互助手工具调用MCP Clients【免费下载链接】vscode-copilot-chatCopilot Chat extension for VS Code项目地址https://gitcode.com/gh_mirrors/vs/vscode-copilot-chat点击查看免费下载相关推荐Mermaid Live Editor 在线图表编辑器3步快速画图、导出与分享Mermaid Live Editor 在线图表编辑器3步快速画图、导出与分享 周会前 10 分钟你需要交出一张系统架构图给同事讲。打开浏览器进入 Merm前端开发者工具数据可视化Chat Nio链路追踪分布式追踪架构深度解析Chat Nio链路追踪分布式追踪架构深度解析 在当今复杂的微服务架构中分布式追踪Distributed Tracing已成为确保系统可观测性的关键技术后端前端人工智能大模型AI 应用LLM 网关API网关Opik TypeScript SDK 的 OpenTelemetry 集成用 opik-otel 把 OTel 追踪桥接到 Opik 分布式追踪Opik TypeScript SDK 的 OpenTelemetry 集成用 opik otel 把 OTel 追踪桥接到 Opik 分布式追踪 opik人工智能LLMOps模型评测可观测性AI AgentAI 应用后端前端上一篇pm-skills /write-prd完全教程AI生成8大板块专业PRD的完整指南下一篇为什么这个分布式ID生成器能每秒处理600万个请求创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
