> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

在扣子编程，你可以查看已发布的 AI 编程项目后端运行日志、运行指标、Trace 详情，以便在出现问题时进行故障排查和分析。本文介绍在扣子编程中查看线上数据和 Trace 信息的详细步骤。
## **功能简介** {#d5034f91}
对于已经完成部署的 AI 编程项目，你可以进入部署模块查看以下三类线上运行相关信息：

* **日志**：所有 AI 编程项目都会实时记录并输出线上运行日志，支持你开展问题排查、故障追溯，满足等级保护和安全合规等相关要求。
* **分析数据**：针对智能体和工作流类项目，扣子编程会自动记录 `错误 QPS`、`执行 QPS` 和延迟时间等关键指标，帮助你直观掌握项目的线上运行状况。
* **Trace 详情**：针对智能体和工作流类项目，扣子编程会保留线上 Trace 数据，你可以查看每个节点的完整输入输出信息，快速定位和排查故障。同时，你还可以将 Trace 数据导出为 Excel 文件保存到本地。
   <!-- @cols-width: 137,104,112,104,112,100,104,112,100,128,120 -->
   | | | | | | | | | | | | \
   |**订阅套餐** |**个人免费版** |**个人进阶版** |**个人高阶版** |**个人旗舰版** |**个人尊享版** |**团队高阶版** |**团队旗舰版** |**团队尊享版** |**企业标准版** |**企业旗舰版** |
   |---|---|---|---|---|---|---|---|---|---|---|
   | | | | | | | | | | | | \
   |Trace 默认存储时长 |3 天  |7 天  |7 天  |7 天  |7 天 |7 天  |7 天  |7 天 |90 天  |180 天  |


## **使用限制** {#0642c7c4}
日志保存时间、Trace 数据导出量、部署运维日志查询量等均存在限制。详情请参见[配额与限制](/guides/vibe_coding_limit)。
## 费用说明 {#80d18245}
Trace 日志的费用根据上报的日志存储量和存储时长计算。系统会自行在一段时间内上报一次 Trace 数据，并在上报时一次性收取费用。更多信息，请参考[Trace 日志费用（即将收费）](/coze_pro/trace_fee)。
:::notice 注意
自2026年7月1日起，扣子将对你上报的 Trace 日志收取相应费用。
:::
## 查看数据 {#88c1e508}
1. 在[扣子编程](https://code.coze.cn/home)左侧导航栏选择**项目管理**，筛选带有 **New** 标签的项目，单击目标项目。
   ![Image=500x212](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/cf3f91f97b1e4d9094d25b7627b5ce50~tplv-goo7wpa0wc-image.image)


2. 在项目搭建页面，在右侧单击➕打开新的标签页，在弹出的标签页中单击**日志**。
   ![Image=500x325](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/beb40527b30a43d2a8e7d7fedf53e204~tplv-goo7wpa0wc-image.image)
3. 查看日志、分析和 Trace 数据。
   ![Image=1409x609](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b7907783a8244442975eb79113c2232c~tplv-goo7wpa0wc-image.image)

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

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

![Image=386x258](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/fe74ee3ae61d44ffa6e0805ac87fe517~tplv-goo7wpa0wc-image.image)
### 分析 {#9a1c49aa}
在 **部署** >**分析**页面右上角选择时间范围。
目前支持查看以下数据：
<!-- @cols-width: 100,529 -->
| | | \
|**指标** |**说明** |
|---|---|
| | | \
|错误 QPS |AI 编程项目在一秒钟内处理请求时，产生的错误请求数量。例如错误 QPS 为 50，表示平均每秒有 50 个请求处理失败。 |
| | | \
|执行 QPS |AI 编程项目每秒实际响应的请求数量。 |
| | | \
| 延迟 |线上响应的平均延迟时间，单位为毫秒（ms）。 |

### Trace {#c30c3414}
Trace 详细记录了智能体和工作流每次请求的执行过程、各个节点的输入输出等信息，借助 Trace 看板，你能够全面跟踪和分析 AI 编程项目线上运行状况，以便针对性分析和优化。
在 **部署** > **Trace** 页面即可查看智能体和工作流的消息日志。页面左上角可选择时间范围、页面右上角可批量下载 Trace 数据。
![Image=683x375](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a0636cf3d05a42dda6edd7bc9486a20b~tplv-goo7wpa0wc-image.image)
Trace 看板各指标说明如下：
<!-- @cols-width: 165,518 -->
| | | \
|**指标** |**说明** |
|---|---|
| | | \
|Trace ID |Trace 记录的主键，用来定位一条唯一的 Trace。 |
| | | \
|Log ID |扣子编程的日志 ID，在故障场景下可提供给扣子团队进行问题排查。 |
| | | \
|Hash Version |部署版本的哈希值。 |
| | | \
|输入 |用户输入的消息内容。 |
| | | \
|输出 |智能体或工作流输出的消息内容。 |
| | | \
|Input Tokens |用户输入的总 Token 长度，估算值，仅用于参考。 |
| | | \
|Output Tokens |智能体或工作流输出内容的总 Token 长度，估算值，仅用于参考。 |
| | | \
|Latency |请求从开始到结束的总耗时，单位为秒（s）。 |
| | | \
|LatencyFirstResp |智能体或工作流首次响应的处理耗时，单位为毫秒（ms）。从用户发起请求开始计算，到智能体或工作流返回第一个 Token 为止。 |\
| |如果希望工作流尽早返回首个 Token，可配置输出节点。 |

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

1. 在 AI 编程项目的**部署** > **Trace** 页面，单击**成员 Trace 设置**。
   ![Image=505x181](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ca434fecba7c4c97b71b36b88c68476d~tplv-goo7wpa0wc-image.image)
2. 关闭**允许全部成员上报 Trace** 开关。
   ![Image=502x132](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/85dd2f219d08495498fb27890c2a1d63~tplv-goo7wpa0wc-image.image)

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

1. 在 AI 编程项目的**部署** > **Trace** 页面，单击**成员 Trace 设置**。
   ![Image=505x181](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ca434fecba7c4c97b71b36b88c68476d~tplv-goo7wpa0wc-image.image)
2. 设置**Trace最大存储时长**。
   ![Image=509x285](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/939445c862484d33bac0bc42e3e8bbc1~tplv-goo7wpa0wc-image.image)