查看第三方智能体上报的Trace、Metric数据
通过OpenTelemetry协议上报的Trace和Metric数据,与AgentArts平台内智能体自动上报的数据共享同一套观测页面。
上报成功后,您可以在“智能体列表”页面筛选“第三方托管”智能体的数据进行查看,除了第三方智能体外,您也可以通过该页面查看有AgentArts平台创建的智能体数据。
Trace记录一次完整请求的调用路径、各节点耗时与输入输出,用于排查调用异常和定位性能瓶颈;Metric记录聚合统计信息(如请求次数、Token消耗、成功率等),用于监控运行状态和成本趋势。
以下重点说明与第三方智能体上报数据关联最密切的页签。当前OTel协议上报仅支持Trace和Metric数据,暂不支持日志上报。
| 页签 | 可查看内容 |
|---|---|
| 概览 | 智能体的关键运行指标总览,包括Token消耗、模型调用情况、会话数等。 |
| Token分析 | Token消耗的详细统计与趋势,支持按模型、会话、Trace排行等。 |
| 模型分析 | 各模型的调用次数、耗时、成功率及首Token时延等。 |
| 调用链分析 | 请求的完整调用路径、各节点耗时、输入输出内容。 |
| 会话分析 | 用户与智能体的对话历史。 |
| 日志 | 运行过程中的事件记录(仅支持查看在AgentArts平台中创建的智能体日志)。 |
典型使用场景:当第三方智能体调用失败时,可在“调用链分析”页签查看完整调用路径定位异常节点;Token消耗异常时,可在“Token分析”页签查看消耗排行。
查看概览数据
概览页签展示智能体的核心运行指标,分为服务指标和模型指标两部分:
| 指标 | 说明 |
|---|---|
| QPS/QPM | 每秒/每分钟请求数(状态分成功/失败两类) |
| 链路整体平均耗时 | 请求从发起到响应的平均耗时 计算方式:链路总耗时/总请求次数 |
| 响应成功率 | 请求响应成功的比例 |
| Token消耗 | 大模型调用消耗的Token总量 |
| 用户数 | 使用该智能体的用户总数(去重) |
| 会话数 | 发生过交互的会话总数 |
| Trace数 | 调用链总数 |
| Span数 | 所有节点总数 |
| Span成功率 | Span 执行成功的比例 |
| 指标 | 说明 |
|---|---|
| 模型调用次数 | 模型调用的总次数 |
| 模型调用平均耗时 | 模型的平均响应时间 |
| 模型调用成功率 | 模型的调用成功比例 |
查看Token分析数据
“Token分析”页签展示Token消耗相关的统计数据。
| 指标 | 说明 |
|---|---|
| Token消耗(Total/Input/Output) | 各类型Token的消耗总量与趋势 |
| 单次请求平均Token消耗 | 每次请求的平均Token消耗 |
| 模型调用平均Token消耗 | 每次模型调用的平均Token消耗 |
| Token消耗模型排行(Top5) | Token消耗量最高的5个模型 |
| Token消耗会话排行(Top5) | Token消耗量最高的5个会话 |
| Token消耗Trace排行(Top5) | Token消耗量最高的5个Trace |
查看模型分析数据
“模型分析”页签按展示模型调用性能相关的数据。
| 指标 | 说明 |
|---|---|
| 模型数 | 调用过的不同模型数量 |
| 模型Token消耗 | 各模型的Token消耗总量 |
| 模型调用次数 | 各模型的调用总次数趋势 |
| 模型调用平均耗时 | 模型调用的平均耗时 |
| 模型调用成功率 | 模型的调用成功率趋势 |
| 模型首Token平均耗时 | 模型的首Token平均时延 |
| 模型调用排行(Top5) | 调用次数最多的5个模型 |
| 模型调用平均耗时排行(Top5) | 平均耗时最长的5个模型 |
查看调用链数据
“调用链分析”页签展示请求的完整调用路径详情。选择一条调用链记录,可以查看调用树的结构、链路信息、元数据等。
查看会话数据
“会话分析”页签记录用户与智能体的对话历史,每条会话记录展示以下信息。
| 字段 | 说明 |
|---|---|
| 会话ID | 唯一标识每个会话 |
| 耗时 | 会话总耗时 |
| Tokens | 会话的Token总消耗 |
| Input Tokens | 输入Token消耗 |
| Output Tokens | 输出Token消耗 |
| 调用链数 | 关联的调用链条数 |
| 用户ID | 用户标识 |
| 触发类型 | 触发方式 |
| 开始时间 | 会话开始时间 |
常见问题
上报数据后,在观测页面看不到数据
请按以下顺序排查:
- 检查接入配置:确认接入地址、鉴权信息、智能体ID是否配置正确,详见上报第三方智能体Trace、Metric数据。
- 检查数据格式:确认上报的数据格式符合OpenTelemetry协议规范,必填字段是否完整,详见OpenTelemetry字段映射。
- 检查时间范围:确认观测页面的时间筛选条件包含数据上报的时间范围。
概览页签中Token消耗显示为0
Token消耗依赖上报的Metric数据。请确认代码中已正确上报gen_ai.usage.input_tokens和gen_ai.usage.output_tokens指标,详见OpenTelemetry字段映射。