更新时间:2026-06-12 GMT+08:00
分享

查看应用调用链信息

调用链分析界面通过可视化展示请求的完整生命周期,支持查看各节点的详细信息,包括响应时间、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的输入内容,发现上下文拼接错误导致模型理解偏差。
图1 调用链详情

前提条件

费用说明

查看调用链数据本身不收取任何费用,但数据上报至其他服务会产生相应的管理费用。该功能依赖应用性能管理APM服务,费用明细请参考APM计费说明

约束与限制

仅通过API调用产生的数据才会上报到运营运维模块。控制台调试和编排预览不计入统计。使用API调用智能体,请参考API调用实践

查看调用链信息

调用链详情页面提供了全方位的可观测性视图,帮助您深入分析智能体的运行状态。除了宏观的调用树,页面还详细展示了每个Span的链路信息、Metadata、人工标注信息,以及性能指标和运行日志。这些多维度的数据能够帮助您快速定位性能瓶颈、进行根因分析。

查看应用调用链信息

  1. 登录AgentArts智能体平台
  2. 在左侧导航栏中选择“运营运维 > 观测”,进入“调用链分析”页签中可以查看智能体应用上报的调用链数据。

    进入调用链分析页面后,展示调用链数据列表,每条记录包含TraceID、请求状态、响应时间、Tokens等信息。
    图2 调用链分析

  3. 在数据展示区域,可以使用过滤功能筛选出目标记录。筛选后,列表仅显示符合条件的数据。如果页面无数据或数据未更新,请参见常见问题进行排查。
  4. 选择一条调用链记录并单击,进入该调用链的详情页面,即可查看该调用链的详细信息(左侧展示调用树,右侧展示选中Span的详细信息面板)。

    进入调用链详情页面后,页面顶部展示调用树,下方展示各Tab页签(元数据、标注、指标、日志),可切换查看不同维度的信息。

    如果调用过程发生报错,单击左侧调用树中的报错节点,在右侧的“链路信息”页签中查看报错详情,快速定位问题根因。

    在调用链详情页面,单击对输出数据进行点赞和点踩。
    图3 调用链详情

查看元数据信息

元数据由系统在智能体运行过程中自动采集生成,与当前Span对应,并以JSON格式展示所选Span的所有元数据,并支持一键复制。元数据是以键值对形式存储的补充信息,例如应用程序版本、运行环境和调用的模型等。

适用场景:查看模型版本、运行环境等补充信息。
图4 元数据信息

查看标注信息

展示当前数据的详细标注结果,涵盖标签名称、标注内容等信息,便于用户直观核查数据的标注详情。

适用场景:核查数据标注详情,用于数据质量管理。
图5 标注信息

查看指标信息

以折线图形式直观展示当前Span的关键性能指标,涵盖Token消耗趋势与平均响应时间变化,帮助您实时监测资源占用与服务耗时情况。

适用场景:监测Token消耗趋势与响应时间变化。如需查看更大时间范围的趋势,请使用运营指标功能。

仅展示当前Span的前后15分钟(最大到当前时间)的指标数据。

图6 指标信息

查看日志信息

展示智能体运行的日志信息,支持快速回溯故障现场,定位问题根因。

适用场景:回溯故障现场,定位错误根因。失败状态的Span可在日志中查看具体错误原因。
图7 日志信息

调用链信息说明

调用链列表包含以下信息,如表1所示。

表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

使用过滤器筛选信息

调用链分析界面支持按多种维度灵活筛选所需数据记录,帮助运维人员快速定位和分析目标信息。

表2 过滤维度

过滤维度

说明

上报时间

支持选择要查看的调用链数据的时间范围,可查看30天内的数据。

应用类型

按照应用类型进行过滤,提供以下几种分类:

  • 单智能体应用:智能体平台中的单智能体应用每次对话产生的调用链数据。
  • 工作流应用:智能体平台中的工作流应用每次运行产生的调用链数据。
  • 多智能体应用:智能体平台中的多智能体应用每次对话产生的调用链数据。

应用

在选定应用类型后,进一步筛选具体的Agent应用。支持在下拉列表中搜索应用名称。

数据类型

调用链由一个或多个Span组成,呈树状结构:根节点为Root Span(代表用户发起的整次请求),子节点为各子步骤(如大模型调用等)。平台支持按照数据类型过滤,三种分类可选:

  • ALL Span:查看所有子请求的完整请求链路信息,适合全面分析整个调用流程。
  • Root Span:查看根请求的链路信息,适合快速定位主流程。
  • Model Span:查看与模型相关的请求链路,适合聚焦模型调用性能分析。

Trace ID

支持根据TraceID来筛选调用链数据。

请求状态

支持按调用链的执行状态筛选。

输入

支持根据输入中包含的特定信息筛选调用链数据。

输出

支持根据输出中包含的特定信息筛选调用链数据。

会话ID

支持根据会话ID来筛选调用链数据。

标注

支持根据标注信息筛选调用链数据。

常见问题

为什么看不到我的调用链数据? 请检查以下原因:
  • 数据过期:调用链数据有保留周期限制。超过保留期限的记录将被系统自动清理。
  • 无调用记录:确认该应用在选定时间段内是否有实际的调用发生。
  • 调用方式限制:目前仅通过API调用产生的数据才会上报到运营运维,对话预览或调试运行产生的数据不会上报。

Root Span”和“ALL Span”有什么区别?

  • Root Span:仅展示调用链的入口记录(如用户发起对话的那一步),适合快速统计调用次数。
  • All Span:展示调用链内部的所有步骤细节(如模型推理、工具调用),适合深入排查具体哪一步出错或耗时过长。

为什么指标信息只显示15分钟的数据?

指标信息展示的是当前Span执行前后15分钟(最大到当前时间)的性能数据,用于聚焦分析该次调用附近的资源占用和耗时变化。如需查看更大时间范围的趋势,请使用运营指标功能。

相关文档