查看日志和 Trace

在扣子编程，你可以查看已发布的 AI 编程项目后端运行日志、运行指标、Trace 详情，以便在出现问题时进行故障排查和分析。本文介绍在扣子编程中查看线上数据和 Trace 信息的详细步骤。

功能简介

对于已经完成部署的 AI 编程项目，你可以进入部署模块查看以下三类线上运行相关信息：

• 日志：所有 AI 编程项目都会实时记录并输出线上运行日志，支持你开展问题排查、故障追溯，满足等级保护和安全合规等相关要求。
• 分析数据：针对智能体和工作流类项目，扣子编程会自动记录 错误 QPS、执行 QPS 和延迟时间等关键指标，帮助你直观掌握项目的线上运行状况。
• Trace 详情：针对智能体和工作流类项目，扣子编程会保留线上 Trace 数据，你可以查看每个节点的完整输入输出信息，快速定位和排查故障。同时，你还可以将 Trace 数据导出为 Excel 文件保存到本地。

  订阅套餐	个人免费版	个人进阶版	个人高阶版	个人旗舰版	个人尊享版	团队高阶版	团队旗舰版	团队尊享版	企业标准版	企业旗舰版
  Trace 默认存储时长	3 天	7 天	7 天	7 天	7 天	7 天	7 天	7 天	90 天	180 天

使用限制

日志保存时间、Trace 数据导出量、部署运维日志查询量等均存在限制。详情请参见配额与限制。

费用说明

Trace 日志的费用根据上报的日志存储量和存储时长计算。系统会自行在一段时间内上报一次 Trace 数据，并在上报时一次性收取费用。更多信息，请参考Trace 日志费用（即将收费）。

查看数据

1. 在扣子编程左侧导航栏选择项目管理，筛选带有 New 标签的项目，单击目标项目。
   

2. 在项目搭建页面，在右侧单击➕打开新的标签页，在弹出的标签页中单击日志。
   

3. 查看日志、分析和 Trace 数据。
   

看板和指标说明

日志

在 部署 >日志页面左上角选择时间范围。扣子编程默认展示最近 3 天的日志数据。
支持根据关键词筛选日志。
当项目运行失败或出现异常时，开发者可以按如下步骤进行故障处理：

1. 搜索并查看运行日志中包含 error 的错误信息。
2. 复制错误信息，在项目搭建页面，通过对话，让扣子 AI 帮忙自动修复问题。

分析

在 部署 >分析页面右上角选择时间范围。
目前支持查看以下数据：

Trace

Trace 详细记录了智能体和工作流每次请求的执行过程、各个节点的输入输出等信息，借助 Trace 看板，你能够全面跟踪和分析 AI 编程项目线上运行状况，以便针对性分析和优化。
在 部署 > Trace 页面即可查看智能体和工作流的消息日志。页面左上角可选择时间范围、页面右上角可批量下载 Trace 数据。

Trace 看板各指标说明如下：

管理 Trace 上报

关闭 Trace 上报

Trace 日志上报开关默认开启，工作空间所有者或者管理员可以按需关闭。关闭后，当前工作空间内所有成员的 Trace 数据将停止上报，历史数据不受影响。

1. 在 AI 编程项目的部署 > Trace 页面，单击成员 Trace 设置。
   
2. 关闭允许全部成员上报 Trace 开关。
   

设置 Trace 存储时长

Trace 存储时长默认为当前订阅套餐支持的最大默认时长，例如企业旗舰版为 180 天。工作空间所有者或者管理员可以修改其存储时长。设置后，当前工作空间内所有 Trace 数据的存储时长均以此为准。

1. 在 AI 编程项目的部署 > Trace 页面，单击成员 Trace 设置。
   
2. 设置Trace最大存储时长。