# 查看应用调用链信息 调用链分析界面通过可视化展示请求的完整生命周期，支持查看各节点的详细信息，包括响应时间、Token消耗等关键指标。当智能体响应缓慢或回答不符合预期时，您可以通过调用链分析各个节点的执行情况，快速定位性能瓶颈或报错环节。例如，当智能体回答延迟超过10秒时，通过调用链查看哪个Span耗时最长，定位瓶颈；当智能体回答内容错误时，通过调用链查看Model Span的输入是否正确、工具调用是否返回了预期结果。 调用链由一个或多个Span组成，呈树状结构。根节点为Root Span（代表用户发起的整次请求），子节点为各个子步骤（如大模型、工具调用等）。当用户通过API发起一次请求时，系统会为该请求创建一个Root Span，请求执行过程中每经过一个子步骤（如调用大模型、执行工具等），系统会自动创建一个子Span并挂载到Root Span下，形成完整的调用树。平台支持通过以下Span类型进行分类查找： - ALL Span：查看所有子请求的完整请求链路，适合全面分析整个调用流程。 - Root Span：用户发起的整次请求入口，适合快速统计调用次数、概览请求状态。 - Model Span：大模型调用节点，适合聚焦模型调用性能分析。 - Tool Span：工具调用节点，适合排查工具执行情况及错误原因。 调用链详情页面提供了全方位的可观测性视图，除宏观的调用树外，还详细展示了每个Span的元数据、标注信息、性能指标和运行日志，帮助您快速定位性能瓶颈、进行根因分析。 典型排查场景： - 定位耗时瓶颈：某次调用响应时间为30秒，通过调用链发现某个工具调用耗时25秒，针对性优化工具逻辑。 - 排查回答异常：智能体回答不符合预期，通过调用链查看Model Span的输入内容，发现上下文拼接错误导致模型理解偏差。 图1调用链详情 ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002717835625.png) #### 前提条件 - 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)。 - 已开启数据上报。数据上报请参考[开启数据上报](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0005.html#agentarts_14_0005__section1315116302077)。 #### 费用说明 查看调用链数据本身不收取任何费用，但数据上报至其他服务会产生相应的费用。该功能依赖应用性能管理APM服务，费用明细请参考[APM计费说明](https://support.huaweicloud.com/price-apm2/apm_07_0019.html)。 #### 约束与限制 - 仅通过**API调用** 产生的数据才会上报到运营运维模块。控制台调试和编排预览不计入统计。使用API调用智能体，请参考[API调用实践](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0020.html)。 - 调用链详情页的"日志"页签不支持查看第三方托管智能体的日志信息。 如需查看，请在左侧导航栏选择"运营运维 \> 观测 \> 智能体列表"，单击目标智能体名称，在"日志"页签中查看。 #### 查看调用链信息 调用链详情页面除了宏观的调用树还详细展示了每个Span的链路信息、Metadata、人工标注信息，以及性能指标和运行日志。这些多维度的数据能够帮助您快速定位性能瓶颈、进行根因分析。 #### 查看应用调用链信息 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏中选择"运营运维 \> 观测"，进入"调用链分析"页签，查看智能体应用上报的调用链数据。 进入调用链分析页面后，展示调用链数据列表，每条记录包含TraceID、请求状态、响应时间、Tokens等信息。 如果需要自动刷新页面数据，请单击页面右上角的"自动刷新关闭"下拉列表，选择数据刷新的时间间隔。 图2调用链分析 ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002717835623.png) 3. 在数据展示区域，可以使用过滤功能筛选出目标记录。筛选后，列表仅显示符合条件的数据。如果页面无数据或数据未更新，请参见[常见问题]进行排查。 4. 选择一条调用链记录并单击，进入该调用链的详情页面，即可查看该调用链的详细信息（左侧展示调用树，右侧展示选中Span的详细信息面板）。 进入调用链详情页面后，页面顶部展示调用树，下方展示各Tab页签（元数据、标注、指标、日志），可切换查看不同维度的信息。 如果调用过程发生报错，单击左侧调用树中的报错节点，在右侧的"链路信息"页签中查看报错详情，快速定位问题根因。 在调用链详情页面，单击![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002717835627.png)和![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002687916156.png)对输出数据进行点赞和点踩。 图3调用链详情 ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002717835625.png) #### 查看元数据信息 元数据由系统在智能体运行过程中自动采集生成，与当前Span对应，并以JSON格式展示所选Span的所有元数据，并支持一键复制。元数据是以键值对形式存储的补充信息，例如应用程序版本、运行环境和调用的模型等。 适用场景：查看模型版本、运行环境等补充信息。 图4元数据信息 ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002687916154.png) #### 查看标注信息 展示当前数据的详细标注结果，涵盖标签名称、标注内容等信息，便于用户直观核查数据的标注详情。 适用场景：核查数据标注详情，用于数据质量管理。 图5标注信息 ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002717835591.png) #### 查看指标信息 以折线图形式直观展示当前Span的关键性能指标，涵盖Token消耗趋势与平均响应时间变化，帮助您实时监测资源占用与服务耗时情况。 适用场景：监测Token消耗趋势与响应时间变化。如需查看更大时间范围的趋势，请使用运营指标功能。 ![](https://support.huaweicloud.com/ops-agentarts/public_sys-resources/caution_3.0-zh-cn.png) 仅展示当前Span的前后15分钟（最大到当前时间）的指标数据。 图6指标信息 ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002717675727.png) #### 查看日志信息 展示智能体运行的日志信息，支持快速回溯故障现场，定位问题根因。 适用场景：回溯故障现场，定位错误根因。失败状态的Span可在日志中查看具体错误原因。 图7日志信息 ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002687916118.png) #### 调用链信息说明 调用链列表包含以下信息，如[表1]所示。 表1调用链参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | TraceID | 整个调用链的唯一标识符。所有属于同一请求的步骤都共享同一个TraceID，能够关联所有相关的数据信息。 | 4395e80d9a8744d493287ae5db7328d8 | | 请求状态 | 表示当前Span执行的状态。 取值范围：成功、失败。失败时可在日志信息中查看具体错误原因。 | ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002687916152.png)成功 | | 输入 | 请求的原始输入内容。 | ``` 赛里木湖有哪些必游景点和推荐活动？ ``` | | 输出 | 请求的最终输出结果。例如大模型的回答或工具调用返回的信息。 | ``` 以下是赛里木湖最值得体验的**必游景点**和**特色活动**，结合景观精华与文化体验，助你规划不留遗憾的旅程： --- ### **一、 必游核心景点** 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：大模型调用节点，适合聚焦模型调用性能分析。 - Tool Span：工具调用节点，适合排查工具执行情况及错误原因。 | | Trace ID | 支持根据TraceID来筛选调用链数据。 | | 请求状态 | 支持按调用链的执行状态筛选。 | | 输入 | 支持根据输入中包含的特定信息筛选调用链数据。 | | 输出 | 支持根据输出中包含的特定信息筛选调用链数据。 | | 会话ID | 支持根据会话ID来筛选调用链数据。 | | 标注 | 支持根据标注信息筛选调用链数据。 | #### 常见问题 - **为什么看不到我的调用链数据？ 请检查以下原因：** - **数据过期：**调用链数据有保留周期限制。超过保留期限的记录将被系统自动清理。 - **无调用记录：**确认该应用在选定时间段内是否有实际的调用发生。 - **调用方式限制：**目前仅通过API调用产生的数据才会上报到运营运维，对话预览或调试运行产生的数据不会上报。 - **"Root Span"和"ALL Span"有什么区别？** - Root Span：仅展示调用链的入口记录（如用户发起对话的那一步），适合快速统计调用次数。 - ALL Span：展示调用链内部的所有步骤细节（如模型推理、工具调用），适合深入排查具体哪一步出错或耗时过长。 - **为什么指标信息只显示15分钟的数据？** 指标信息展示的是当前Span执行前后15分钟（最大到当前时间）的性能数据，用于聚焦分析该次调用附近的资源占用和耗时变化。如需查看更大时间范围的趋势，请使用运营指标功能。