埋点字段说明

埋点时机

为适配 Google ADK 埋点规范，VeADK 中的埋点时机与 Google ADK 保持一致，主要在以下几个时机进行埋点：

• 调用 Agent 时：在 Runner 的 _run_with_trace 函数中埋点，Span 名称为 invocation
• 运行 Agent 时：在 Agent 的 run_async 函数中埋点，Span 名称为 invoke_agent {agent.name}
• 调用模型时：在 BaseLlmFlow 的 _call_llm_with_tracing 函数中埋点，Span 名称为 call_llm
• 调用工具时：在 BaseLlmFlow 的 _execute_single_function_call_async 函数中埋点，Span 名称为 execute_tool {tool.name}

在每个时机时，都会创建对应名字的 Span，用于记录该时机的详细信息。当某阶段结束时，会调用对应的打点函数，将该阶段的信息记录到 Span 中：

• Google ADK 打点文件
• VeADK 打点文件

埋点字段说明

VeADK 的 Span 属性命名和值规范遵循 OpenTelemetry 社区以及火山引擎 CozeLoop、APMPlus 等产品要求。VeADK 中的 Span 属性主要分为三类：

• 通用类：在所有类型的 Span 中存在
• LLM 类：在 call_llm Span 中存在
• Tool 类：在 tool_call Span 中存在

通用类

LLM 类

Tool 类