查看应用调用链信息
调用链分析界面通过可视化展示请求的完整生命周期,支持查看各节点的详细信息,包括响应时间、Token消耗等关键指标。当智能体响应缓慢或回答不符合预期时,您可以通过调用链分析各个节点的执行情况,快速定位性能瓶颈或报错环节。例如,当智能体回答延迟超过10秒,通过调用链查看哪个Span耗时最长,定位瓶颈。或者当智能体回答内容错误,通过调用链查看Model Span的输入是否正确、工具调用是否返回了预期结果。
调用链由一个或多个Span组成,呈树状结构。根节点为Root Span(代表用户发起的整次请求),子节点为各个子步骤(如大模型、工具调用等)。当用户通过API发起一次请求时,系统会为该请求创建一个Root Span,请求执行过程中每经过一个子步骤(如调用大模型、执行工具等),系统会自动创建一个子Span并挂载到Root Span下,形成完整的调用树。平台支持通过以下Span类型进行分类查找:
- ALL Span:查看所有子请求的完整请求链路,适合全面分析整个调用流程。
- Root Span:用户发起的整次请求入口,适合快速统计调用次数、概览请求状态。
- Model Span:大模型调用节点,适合聚焦模型调用性能分析。
调用链详情页面提供了全方位的可观测性视图,除宏观的调用树外,还详细展示了每个Span的元数据、标注信息、性能指标和运行日志,帮助您快速定位性能瓶颈、进行根因分析。
典型排查场景:
- 定位耗时瓶颈:某次调用响应时间为30秒,通过调用链发现某个工具调用耗时25秒,针对性优化工具逻辑。
- 排查回答异常:智能体回答不符合预期,通过调用链查看Model Span的输入内容,发现上下文拼接错误导致模型理解偏差。
前提条件
- 已开通AgentArts服务。
- 已开启数据上报。数据上报请参考开启数据上报。
费用说明
查看调用链数据本身不收取任何费用,但数据上报至其他服务会产生相应的管理费用。该功能依赖应用性能管理APM服务,费用明细请参考APM计费说明。
约束与限制
仅通过API调用产生的数据才会上报到运营运维模块。控制台调试和编排预览不计入统计。使用API调用智能体,请参考API调用实践。
查看调用链信息
调用链详情页面提供了全方位的可观测性视图,帮助您深入分析智能体的运行状态。除了宏观的调用树,页面还详细展示了每个Span的链路信息、Metadata、人工标注信息,以及性能指标和运行日志。这些多维度的数据能够帮助您快速定位性能瓶颈、进行根因分析。
查看应用调用链信息
- 登录AgentArts智能体平台。
- 在左侧导航栏中选择“运营运维 > 观测”,进入“调用链分析”页签中可以查看智能体应用上报的调用链数据。 进入调用链分析页面后,展示调用链数据列表,每条记录包含TraceID、请求状态、响应时间、Tokens等信息。图2 调用链分析
- 在数据展示区域,可以使用过滤功能筛选出目标记录。筛选后,列表仅显示符合条件的数据。如果页面无数据或数据未更新,请参见常见问题进行排查。
- 选择一条调用链记录并单击,进入该调用链的详情页面,即可查看该调用链的详细信息(左侧展示调用树,右侧展示选中Span的详细信息面板)。
进入调用链详情页面后,页面顶部展示调用树,下方展示各Tab页签(元数据、标注、指标、日志),可切换查看不同维度的信息。
如果调用过程发生报错,单击左侧调用树中的报错节点,在右侧的“链路信息”页签中查看报错详情,快速定位问题根因。
在调用链详情页面,单击
和
对输出数据进行点赞和点踩。 图3 调用链详情
查看元数据信息
元数据由系统在智能体运行过程中自动采集生成,与当前Span对应,并以JSON格式展示所选Span的所有元数据,并支持一键复制。元数据是以键值对形式存储的补充信息,例如应用程序版本、运行环境和调用的模型等。
查看标注信息
展示当前数据的详细标注结果,涵盖标签名称、标注内容等信息,便于用户直观核查数据的标注详情。
查看指标信息
以折线图形式直观展示当前Span的关键性能指标,涵盖Token消耗趋势与平均响应时间变化,帮助您实时监测资源占用与服务耗时情况。
仅展示当前Span的前后15分钟(最大到当前时间)的指标数据。
查看日志信息
展示智能体运行的日志信息,支持快速回溯故障现场,定位问题根因。
调用链信息说明
调用链列表包含以下信息,如表1所示。
| 参数 | 说明 | 示例 |
|---|---|---|
| TraceID | 整个调用链的唯一标识符。所有属于同一请求的步骤都共享同一个TraceID,能够关联所有相关的数据信息。 | 4395e80d9a8744d493287ae5db7328d8 |
| 请求状态 | 表示当前Span执行的状态。 取值范围:成功、失败。失败时可在日志信息中查看具体错误原因。 |
|
| 输入 | 请求的原始输入内容。 | 赛里木湖有哪些必游景点和推荐活动? |
| 输出 | 请求的最终输出结果。例如大模型的回答或工具调用返回的信息。 | 以下是赛里木湖最值得体验的**必游景点**和**特色活动**,结合景观精华与文化体验,助你规划不留遗憾的旅程: --- ### **一、 必游核心景点** 1. **点将台** - **亮点**:景区制高点,成吉思汗点将台遗址,360°俯瞰赛湖全景的最佳位置,湖水色彩层次分明。 - **贴士**:清晨或傍晚登顶,避开人流,光线柔和易出片。 2. **亲水滩** - **亮点**:湖水透明度极高的浅滩区,常有天鹅群栖息(5-9月高概率),可近距离观鸟、触摸冰蓝湖水。 - **贴士**:带上面包屑吸引天鹅,但保持距离勿惊扰。 |
| 响应时间 | 模型处理用户请求并返回响应的总耗时,单位为毫秒(ms)。 | 30703 ms |
| 会话ID | 用于标识一次连续对话过程的唯一ID。同一会话中的多轮对话共享此ID,用于关联上下文。 | 2acae36c-fc00-4a3a-aed2-688771ffd58c |
| Tokens | 大模型调用过程中,Model Span中输入和输出的token总数。在元数据信息中可分别查看输入Token和输出Token的信息。 | 2000 |
| 开始时间 | 当前Span开始执行的时间。 | 2025-09-02 23:47:19 |
| 标注 | 展示当前数据的标注数量。标注由人工添加,可在标注信息中查看标注详情。 | 3 |
使用过滤器筛选信息
调用链分析界面支持按多种维度灵活筛选所需数据记录,帮助运维人员快速定位和分析目标信息。
| 过滤维度 | 说明 |
|---|---|
| 上报时间 | 支持选择要查看的调用链数据的时间范围,可查看30天内的数据。 |
| 应用类型 | 按照应用类型进行过滤,提供以下几种分类:
|
| 应用 | 在选定应用类型后,进一步筛选具体的Agent应用。支持在下拉列表中搜索应用名称。 |
| 数据类型 | 调用链由一个或多个Span组成,呈树状结构:根节点为Root Span(代表用户发起的整次请求),子节点为各子步骤(如大模型调用等)。平台支持按照数据类型过滤,三种分类可选:
|
| Trace ID | 支持根据TraceID来筛选调用链数据。 |
| 请求状态 | 支持按调用链的执行状态筛选。 |
| 输入 | 支持根据输入中包含的特定信息筛选调用链数据。 |
| 输出 | 支持根据输出中包含的特定信息筛选调用链数据。 |
| 会话ID | 支持根据会话ID来筛选调用链数据。 |
| 标注 | 支持根据标注信息筛选调用链数据。 |
常见问题
- 数据过期:调用链数据有保留周期限制。超过保留期限的记录将被系统自动清理。
- 无调用记录:确认该应用在选定时间段内是否有实际的调用发生。
- 调用方式限制:目前仅通过API调用产生的数据才会上报到运营运维,对话预览或调试运行产生的数据不会上报。
“Root Span”和“ALL Span”有什么区别?
- Root Span:仅展示调用链的入口记录(如用户发起对话的那一步),适合快速统计调用次数。
- All Span:展示调用链内部的所有步骤细节(如模型推理、工具调用),适合深入排查具体哪一步出错或耗时过长。
为什么指标信息只显示15分钟的数据?
指标信息展示的是当前Span执行前后15分钟(最大到当前时间)的性能数据,用于聚焦分析该次调用附近的资源占用和耗时变化。如需查看更大时间范围的趋势,请使用运营指标功能。
