文档中心

应用性能监控全链路版

使用指南

Span 导出

Span 导出

针对 AI 相关应用提供 Span 导出功能，可将 Span 信息导出用于其他深度分析，本文为您介绍如何导出 Span 数据。

前提条件

AI 相关应用已经接入应用性能监控，并正常上报观测数据。更多详细说明参见：AI 场景监控概述。

（可选）若需要将数据导出到 CozeLoop 评测集，确保已经创建工作空间，更多详细说明参见：创建并管理空间。

使用限制

目前仅对 AI 相关应用提供 Span 导出功能，例如：VeADK、AI Agent 等 AI 相关应用。

此方式仅支持导出历史数据，若需要导出新数据，可参考：在线 Trace 导出。

操作步骤

方式一：导出数据到 CozeLoop 评测集

方式二：导出数据到本地文件

方式三：导出数据到智能评测平台

步骤一：添加个人访问令牌

登录 CozeLoop 控制台，在左侧导航栏选择授权。

在顶部切换到个人访问令牌页签，单击右上角添加。

配置个人访问令牌相关参数，完成后单击确定，并将令牌保存到安全且可获取的地方。

注意

令牌仅显示一次，请将此密钥保存在安全且可获取的地方。不要与他人共享，也不要在浏览器或其他客户端代码中暴露它。

配置项	说明
名称	自定义个人访问令牌名称。
过期时间	配置个人访问令牌的有效期。注意请谨慎选择过期时间，个人访问令牌生成后，将不支持修改。
权限	配置当前令牌允许的操作权限和生效层级。其中，工作空间层级，权限的生效范围在您所拥有的工作空间内；账号层级，权限的生效范围在您的个人账号内。说明将数据导出到 CozeLoop 评测集的最小权限包括：罗盘分类中的所有权限、团队空间管理中的 listWorkspace。
访问工作空间	选择允许访问的工作空间。指定工作空间：指定部分工作空间，仅选择的工作空间允许被访问，支持多选。所有工作空间：所有工作空间，包括未来新建的工作空间，均允许被访问。注意转移空间所有权会导致该空间已申请的个人访问令牌失效，请慎重转移所有权。

步骤二：导出 Span 数据到 CozeLoop 评测集

登录应用性能监控控制台。

单击点击进入服务列表，进入服务管理页面。

在左侧导航栏选择服务监控 > Trace 分析，前往 Trace 分析页面，开启 AI 应用 Trace 分析。

根据涉及实际情况筛选数据后，勾选需要导出的 Span 列表，单击 Span 导出。

根据实际需求配置 Span 导出相关参数，完成后单击预览，可查看导出效果；单击确认导出，可按配置导出 Span 数据。

配置项	说明
导出地址	Span 数据的导出地址，本方式选择 CozeLoop，将 Span 数据导出到 CozeLoop 评测集。
CozeLoop Token	CozeLoop 的个人访问令牌，用以推送 Trace 数据到对应 CozeLoop 工作空间的测评集中。使用步骤一中创建的个人访问令牌或其他可用个人访问令牌。注意确保您的 Token 仅包含必要的权限，避免授予过大的权限范围，以减少安全风险。
工作空间	选择 CozeLoop 的工作空间。
目标评测集	选择 CozeLoop 的已有评测集，或新增评测集。其中，新增评测集需要自定义目标评测集名称。说明也可前往 CozeLoop 创建评测集，更多详细说明参见：管理评测集。
导入方式	Span 数据的导入方式。追加数据：在已有数据基础上追加导入数据。全量覆盖：导入数据将覆盖现有所有数据，确保已有数据不再使用选择此方式，以免数据丢失。
字段映射	数据导入时的字段映射关系，依次选择 Trace Span 字段和数据将流入的评测集列。
样本 Span	样本 Span，仅供参考。

后续操作

若将数据导出到 CozeLoop 评测集，可前往 CozeLoop 控制台，在目标评测集详情中查看导入的 Span 数据。

若将数据导出到本地文件，可前往本地下载管理中，查看已经下载的 csv 文件。

若将数据导出到智能体评测平台，可前往 AgentKit 控制台的评测集菜单，在目标评测集详情中查看导入的 Span 数据。

最近更新时间：2026.10.13 17:20:38

这个页面对您有帮助吗？

有用

有用

无用

无用