> ## 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.

在智能体、应用或工作流中，每条消息回复都会生成一条消息日志，这个消息日志详细记录了其回复问题的编排步骤和详细过程。消息日志帮助你了解低代码智能体、应用或工作流的推理过程，以便你进行针对性的分析和优化。
## 功能说明 {#08547928}
**日志**页面主要展示低代码智能体、应用和工作流的消息日志，单击日志可查看全流程处理链路。
消息日志功能通常用于以下场景：

* **日志分析**：查看的详细消息日志，即 trace 数据。
* **故障排查**：在扣子编程中，一个对话请求通常会经由多个环节处理，例如调用 LLM 节点回复问题。消息日志功能提供智能体调用技能的输入、查询的知识库等信息，你可以识别智能体出现异常或不符合预期行为的步骤。
   ![Image=800x491](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ebdf4c9d0e7e4f68b232be720682686f~tplv-goo7wpa0wc-image.image)

## 费用说明 {#ef343045}
Trace 日志的费用根据上报的日志存储量和存储时长计算。系统会自行在一段时间内上报一次 Trace，并在上报时一次性收取费用。更多信息，请参考[Trace 日志费用（即将收费）](/coze_pro/trace_fee)。
:::notice 注意
自2026年7月1日起，扣子将对你上报的 Trace 日志收取相应费用。
:::
## 使用限制 {#d47bc878}
不同扣子套餐支持的消息日志相关权益如下表。
<!-- @cols-width: 136,132,138,112,104,112,104,112,100,139,133 -->
| | | | | | | | | | | | \
|**功能** |**个人免费版** |**个人进阶版** |**个人高阶版** |**个人旗舰版** |**个人尊享版** |**团队高阶版** |**团队旗舰版** |**团队尊享版** |**企业标准版** |**企业旗舰版** |
|---|---|---|---|---|---|---|---|---|---|---|
| | | | | | | | | | | | \
|消息日志存储最长天数 |3天 |7天 |7 天  |7 天  |7 天 |7 天  |7 天  |7 天 |90天 |180天 |
| | | ||||||||| \
|消息导出 |不支持 |每个智能体单次最多可导出 5000 条消息记录。 | | | | | | | | |

消息日志的使用限制如下表所示。
<!-- @cols-width: 111,727 -->
| | | \
|**限制类** |**限制说明** |
|---|---|
| | | \
|权限 |* 空间成员仅能查看你作为所有者或协作者的应用、智能体和工作流的消息日志。添加智能体协作者的操作可参考[协同管理低代码智能体](/guides/collaborate_agent)。 |\
| |* 空间所有者和管理员支持查看所有应用、智能体和工作流的消息日志。 |
| | | \
|记录范围 |* **渠道**：暂不支持豆包  的智能体消息日志。 |\
| |* **内容**：消息日志页面暂不支持展示多模态用户输入，例如语音、图片、文件等类型的消息。 |
| | | \
|延时 |消息在各个渠道中的延时不同，部分渠道可能长达数分钟，对话后建议间隔一段时间再查看消息。 |
| | | \
|数据准确性 |**日志**页面显示的**用户输入 Token**、**模型输出 Token**仅用于参考。企业标准版、企业旗舰版和[旧版付费套餐用户](https://docs.coze.cn/guides/20260119_coze_premium_upgraded)实际使用的 Token 数量可查看[火山引擎账单](https://console.volcengine.com/finance/bill/detail/)。 |

## 查看消息日志 {#b3343fa8}
借助分析看板，你能够全面跟踪和分析已发布的低代码智能体、应用和工作流的运行状况，包括 Token 消耗、积分消耗、用户数、对话数等基础运营数据、用户参与度、性能评估以及渠道运营洞察等，帮助你优化用户体验、提升运营效率、解决技术问题。
1. 登录[扣子编程](https://code.coze.cn/home)。
2. 在左下角单击个人头像，选择企业账号，然后单击对应组织的**设置**图标。
   ![Image=312x298](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0289d64534cd4d8182c8444725bbecd5~tplv-goo7wpa0wc-image.image)
3. 在**组织管理**页面的顶部选择**空间管理**，然后单击目标工作空间对应的**设置**。
   ![Image=386x197](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5f86215a64a043d58c92b8d8b9d4bcbc~tplv-goo7wpa0wc-image.image)


3. 在顶部选择**发布管理**页签。
4. 单击对应的低代码智能体、应用或工作流，在**日志**页面，在顶部选择时间段，查看对话记录。
   ![Image=3422x727](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/79a2a3e575434dc5b96f873c12d97df8~tplv-goo7wpa0wc-image.image)

### 查看消息列表 {#cefc2b61}
页面默认展示过去 3 天内的消息列表。列表标题行各字段说明如下：
:::tip 说明
对于 API 渠道，会话、消息和用户 ID 均由 API 的调用方自定义设置，对话状态也取决于[发起对话](/developer_guides/chat_v3) API 的执行状态。
:::
<!-- @cols-width: 178,398,252 -->
| | | | \
|**字段** |**说明** |**筛选示例** |
|---|---|---|
| | | | \
|状态 |本次对话的状态。如果智能体由于系统限流或其他技术因素未能提供有效回复，或者对话中触发的工作流中任意节点运行异常，则视为对话状态异常。 |支持根据对话状态筛选消息。 |\
| | |![Image=400x74](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d8a20116218a41d1bd427089f7069901~tplv-goo7wpa0wc-image.image) |
| | | | \
|消息 ID |用户向智能体发送的消息的 ID。 |\
| | |支持根据对话 ID 筛选消息。 |\
| | |![Image=400x118](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/92422bfc29f64c598b157a4c0cf1bed0~tplv-goo7wpa0wc-image.image) |
| | | | \
|会话 ID |会话 ID 即 Conversation ID，是会话的唯一标识。会话是用户和智能体之间围绕某个主题的一段问答交互。一个会话包含一条或多条消息。 |支持根据会话 ID 筛选消息。 |\
| | |![Image=400x125](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3e9f7fdc740e4b0eba6970ed096f89eb~tplv-goo7wpa0wc-image.image) |
| | | | \
|用户 ID |和智能体对话的用户 ID。用户 ID 的类型取决于对话发生的渠道。 |\
| | |\
| |* 智能体商店&调试区：扣子用户的 UID。查看 UID 的方式可参考[查看 UID](/guides/setting_up_your_profile#4f6c2b9d)。 |\
| |* API&SDK：调用[发起对话](/developer_guides/chat_v3) API 时设置的 user_id 参数。 |\
| |* 飞书等第三方渠道：展示第三方渠道中的用户 ID。详细说明可参考[消息列表中的用户 IDUser ID是什么？](/guides/queries#982455dd) |支持根据用户 ID 筛选消息。 |\
| | |![Image=400x120](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6097ef84f08a4004bad78ead0cb1141d~tplv-goo7wpa0wc-image.image) |
| | | | \
|用户输入 |对话中用户输入的消息内容。 |支持根据关键词筛选消息。 |\
| | |![Image=400x116](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/021537f1a5cb4361b417f3c511164c04~tplv-goo7wpa0wc-image.image) |
| | | | \
|输出 |智能体或工作流的输出内容。 |支持根据关键词筛选消息。 |\
| | |![Image=400x128](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/acdfb46659f34e5b8811854146da90ee~tplv-goo7wpa0wc-image.image) |
| | | | \
|模型输入 Token |用户输入内容的 Token 长度，估算值，仅用于参考。 |不支持筛选 |\
| | | |
| | | | \
|模型输出 Token |模型输出内容的 Token 长度，估算值，仅用于参考。 | |\
| | |不支持筛选 |
| | | | \
|请求发起时间 |请求的发起时间。 |不支持筛选。 |
| | | | \
|整体耗时 |对话的总时长，单位为毫秒（ms）。从用户发起请求开始计算，到智能体最终回复完成为止。 |支持根据整体耗时筛选消息。 |\
| | |![Image=400x139](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/27028962e2ac4c8c8948b99afcde48af~tplv-goo7wpa0wc-image.image) |
| | | | \
|首次响应耗时 |智能体首次响应的处理耗时，单位为毫秒（ms）。从用户发起请求开始计算，到智能体或工作流返回第一个 Token 为止。 |\
| |如果希望工作流尽早返回首个 Token，可配置输出节点。 |支持根据首次响应耗时筛选消息。 |\
| | |![Image=400x116](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f762fb8d17cd465b86546bc0b025f961~tplv-goo7wpa0wc-image.image) |
| | | | \
|渠道 |用户和智能体的对话发生的渠道。 |\
| |在**日志**页面不支持查看**豆包**渠道的智能体消息日志。 |支持筛选指定渠道的消息列表。只能筛选并查看智能体发布过的渠道。 |\
| | |![Image=400x184](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/8e684132fed5453aa3e517319fd2362c~tplv-goo7wpa0wc-image.image) |

在消息列表中，你可以执行以下操作：
<!-- @cols-width: 187,650 -->
| | | \
|**操作** |**说明** |
|---|---|
| | | \
|隐藏或显示指定列 |列表中默认展示请求状态、名称、输入等部分信息，你也可以在页面右上角自定义设置展示哪些列。 |
| | | \
|刷新 |单击刷新图标，即可刷新当前页签。 |
| | | \
|根据时间段筛选 |支持根据以下方式指定时间： |\
| | |\
| |* 指定时区：选择时区进行筛选，例如选择 `UTC-12:00`。 |\
| |* 指定相对时间：例如过去 1 天、过去 3 天、过去 7 天等。 |\
| |* 自定义时间范围：单击 Custom，设置开始时间与结束时间。 |
| | | \
|下载 |在**日志**页面右上角单击下载图标，即可将筛选后的消息导出到 `.csv`  文件中，并保存到本地。 |

### 查看数据统计 {#d0d3b9c7}
页面右侧的**统计**区域展示筛选范围内消息日志的相关统计数据，包括：
<!-- @cols-width: 187,598 -->
| | | \
|**字段** |**说明** |
|---|---|
| | | \
|**消息数** |筛选范围内的消息总数。 |
| | | \
|**错误率** |筛选范围内，错误消息数量在所有消息中的占比。 |
| | | \
|**整体耗时** |筛选范围内所有消息的平均整体耗时。 |
| | | \
|**首次响应耗时** |筛选范围内所有消息平均首次响应耗时。 |

![Image=521x385](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b276df277f3443338f80a30fc39d9c60~tplv-goo7wpa0wc-image.image)
### 查看消息请求全链路 {#8489c68c}
在**日志**页面的消息列表中单击指定消息，即可查看此消息的详细请求链路。调用树下选择具体节点，可查看：

* **节点详情**：指定节点的详细信息，包括节点类型、状态、整体耗时等信息。
* **输入和输出**：指定节点的输入和输出信息，JSON 格式展示扣子编程在此节点发起请求时的完整输入信息、完整输出信息。
* **链路拓扑**：扣子编程在此节点的请求拓扑，对于工作流等节点，拓扑中会展示本次工作流的完整执行链路，你可以在此查看执行的节点名称与顺序。在左侧调用树中也可以单击工作流子节点名称右侧的图标，跳转到工作流试运行页面，查看本次请求的工作流运行过程与结果。

关于消息请求的全链路信息详细说明，可参考[预览与调试](/guides/preview_debug)。
![Image=800x491](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ebdf4c9d0e7e4f68b232be720682686f~tplv-goo7wpa0wc-image.image)
## 管理 Trace 上报 {#a37e9ce8}
### 关闭 Trace 上报 {#aebe7176}
Trace 日志上报开关默认开启，**工作空间所有者或者管理员**可以按需关闭。关闭后，当前工作空间内所有成员的 Trace 数据将停止上报，历史数据不受影响。

1. 在**空间管理**的**发布管理**页签下，单击对应的低代码智能体、应用或工作流。
2. 在**日志**页面的右上角，单击**成员 Trace 设置**。
3. 关闭**允许全部成员上报 Trace** 开关。
   ![Image=502x132](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/85dd2f219d08495498fb27890c2a1d63~tplv-goo7wpa0wc-image.image)

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

1. 在**空间管理**的**发布管理**页签下，单击对应的低代码智能体、应用或工作流。
2. 在**日志**页面的右上角，单击**成员 Trace 设置**。
3. 设置**Trace最大存储时长**。
   ![Image=509x285](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/939445c862484d33bac0bc42e3e8bbc1~tplv-goo7wpa0wc-image.image)

## 常见问题 {#74c2c18c}
### 扣子的消息最多保存多久？ {#35c795c5}
仅智能体的所有者和协作者才能访问消息页面，不同扣子套餐支持的消息日志存储天数不一样，具体如下表所示。
<!-- @cols-width: 136,132,138,112,104,112,104,112,100,139,133 -->
| | | | | | | | | | | | \
|**功能** |**个人免费版** |**个人进阶版** |**个人高阶版** |**个人旗舰版** |**个人尊享版** |**团队高阶版** |**团队旗舰版** |**团队尊享版** |**企业标准版** |**企业旗舰版** |
|---|---|---|---|---|---|---|---|---|---|---|
| | | | | | | | | | | | \
|消息日志存储最长天数 |3天 |7天 |7 天  |7 天  |7 天 |7 天  |7 天  |7 天 |90天 |180天 |

### 升级套餐后，消息保存天数如何生效？ {#bebab72f}
升级套餐后，新的消息保存天数规则将从升级当天开始计算，不会追溯之前的消息保存天数。例如，你当前是个人免费版，消息仅能保存 3 天。如果 5 月 1 日订阅了个人进阶版，此时你仍然只能查看 4 月 28 日~ 4 月30 日 这三天的消息。但从 5 月 1 日开始，消息保存天数变更为 7 天，到了 5 月 7 日，你就能看到 5 月 1 日~5 月 7 日的消息。
### 可以导出消息吗？ {#9b0e8be7}
扣子付费套餐支持导出消息，个人免费版不支持导出消息。在**日志**页面右上角单击下载图标，即可将筛选后的消息导出到 `.csv` 格式的 Excel 文件中，并保存到本地。
![Image=500x145](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/9663072f2e014b1a9357bd10c16d52a4~tplv-goo7wpa0wc-image.image)
### 消息列表中的用户 ID是什么？ {#982455dd}
消息列表中的用户 ID是和智能体对话的用户 ID。用户 ID 的类型取决于对话发生的渠道。详细说明如下：
<!-- @cols-width: 105,341,341 -->
| | | | \
|**渠道** |**用户 ID 示例** |**说明** |
|---|---|---|
| | | | \
|智能体商店&调试区 |737618761376343**** |扣子用户的 UID。查看 UID 的方式可参考[查看 UID](/guides/setting_up_your_profile#4f6c2b9d)。 |
| | | | \
|API&SDK |12345**** |调用[发起对话](/developer_guides/chat_v3) API 时设置的 user_id 参数。 |
| | | | \
|飞书 |736588c9260f****#93f8**** |飞书的租户 Key 及 OpenID，格式为 `TenantKey#open_id`。 |
| | | | \
|抖音 |_000qxLv3hSueysm05WV925wziQRlFfx**** |用户在 Coze 应用上的 open_id。 |\
| | |抖音渠道包括抖音小程序、抖音企业号。 |
| | | | \
|微信服务号、微信订阅号 |gh_63a996234fa3_o0A3K6cqH****-2-cC_0jZrS**** |微信 origin_id 和 user_id的拼接，格式为 `{{originalID}}_{{userID}}`。 |\
| | |微信渠道包括微信客服、微信小程序、微信服务号、微信订阅号。 |
| | | | \
|微信客服 |wmpyqxdwaacyi1zouwwpjrppgrcr**** |external_userid |
| | | | \
|微信小程序 |ouao3618yko28my12carsrho**** |微信小程序用户的 openid。 |

### 如何查看用户与智能体的对话记录？ {#1144bdfa}
智能体的开发者可通过消息日志功能查看对话记录，具体请参见[查看消息日志](/guides/queries#b3343fa8)。但需注意目前豆包侧的消息记录暂不支持展示。