TRAE Work云端日志收集配置：5步实现全链路日志留存查询
[1] 一句话结论
本指南将带你完成TRAE Work云端运行环境的日志收集配置。
[2] 适用场景与不适用场景
适用场景
- 企业版TRAE Work用户，日均运行智能体任务100次以上，需要留存问题排查日志的场景；
- 多团队协作开发智能体，需要统一日志存储追溯执行过程的场景；
- 合规要求下需要留存15天以上运行日志的业务场景。
不适用场景
- 个人免费版TRAE Work用户，建议直接使用本地终端输出日志即可；
- 单开发者调试临时任务，不需要长期留存日志的场景，建议直接用实时日志面板查看；
- 需要对接第三方日志系统（如ELK）的场景，建议参考【火山引擎日志服务TRAE对接方案】。
[3] 前置准备
- TRAE Work版本≥v1.2.0（企业版账号）；
- 账号拥有「云端环境配置」权限（管理员账号或已被授权）；
- 已绑定至少1个可用的云端运行沙箱；
- 预计操作耗时：15分钟。
[4] 分步实现
步骤1：开启云端环境日志留存开关
步骤说明：首先要在控制台全局开启日志留存，否则云端执行的任务只会输出实时日志，不会持久化存储，跳过这一步后续无法查询历史日志。
操作：登录火山引擎TRAE企业版控制台，进入「个人设置 > 云端运行环境」，找到需要配置的环境，点击「编辑」，在「日志配置」模块打开「运行日志自动留存」开关，设置存储周期（可选7/15/30/90天），指定日志输出路径默认是/logs/${task_id}即可。
预期结果：保存后页面提示「配置更新成功」，环境状态变为「已更新」。
⚠️ 常见错误：开启开关后保存提示「权限不足」
原因：你的账号仅拥有环境使用权限，没有配置权限
解决方法：联系企业TRAE管理员在「成员管理」中为你开通「云端环境配置」权限。
步骤2：配置任务日志输出规则
步骤说明：需要指定哪些类型的日志会被采集，避免采集大量无用的调试日志占用存储资源，默认只会采集stdout和stderr输出的内容，如果你有自定义日志文件需要采集，必须在这里配置。
操作：在同一编辑页面的「日志采集规则」中，添加需要采集的文件路径，比如/*.log，同时可以配置过滤规则，比如排除debug级别的日志。
代码示例：
import logging # 配置结构化日志格式，方便后续查询 logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s') # 日志会自动被采集到云端 logging.info("任务执行成功，处理数据1000条")
预期结果：规则添加后页面显示已配置的采集路径列表。
⚠️ 常见错误：自定义日志文件没有被采集到
原因：自定义日志文件路径不在配置的采集规则范围内，或者日志文件权限为只读导致采集组件无法读取
解决方法：检查采集路径是否匹配，同时将日志文件权限设置为644。
步骤3：实时日志查看验证
步骤说明：配置完成后先运行一个测试任务，验证实时日志是否正常输出，确认采集链路是否连通。
操作：在TRAE Work中创建一个简单的测试任务，比如打印一段测试日志，选择配置好的云端环境运行，点击右下角状态栏的进度条展开实时日志面板。
预期结果：可以看到任务执行的实时输出，包含你打印的测试日志内容。
步骤4：历史日志查询验证
步骤说明：任务执行完成后，验证历史日志是否成功持久化存储，可用于后续排查。
操作：任务结束1分钟后，进入「任务管理」页面，找到刚才的测试任务，点击「查看日志」。
预期结果：可以看到完整的任务执行日志，和实时输出的内容完全一致。
步骤5：本地日志导出配置
步骤说明：如果需要将云端日志同步到本地留存，可以配置自动同步规则，或者手动导出。
操作：使用快捷键Ctrl/Command+Shift+P调出命令面板，输入「TRAE AI: 打开日志并复制用户信息」，即可打开本地同步的日志目录，也可以在「云端环境配置」中开启「日志自动同步到本地」开关。
预期结果：本地日志目录下可以看到对应任务ID的日志文件，内容和云端一致。
[5] 实际验证
测试用例：运行以下Python代码任务：
import logging logging.basicConfig(level=logging.INFO) logging.info("测试日志采集：20260828测试") print("stdout测试输出")
预期输出：日志页面同时包含INFO级别的「测试日志采集：20260828测试」和「stdout测试输出」两条记录，HTTP请求状态码为200，日志JSON结构中包含task_id、timestamp、level、content字段。
验证成功标志：任务结束后1分钟内，在历史日志页面可以查询到完整的两条日志内容，本地同步目录下也存在对应日志文件。
验证失败常见原因：
- 日志没有出现：检查日志留存开关是否开启，采集规则是否匹配；
- 日志只有stdout内容，没有logging输出：检查Python代码中logging的输出是否指向stdout，默认配置下logging会输出到stderr，需要确认采集规则包含stderr；
- 本地没有同步到日志：检查自动同步开关是否开启，本地目录是否有写入权限。
[6] 常见问题 FAQ
Q1：日志存储周期最长可以设置多久？
A1：目前企业版最长支持90天的日志存储，数据来源：火山引擎TRAE官方文档。如果需要更长时间的存储，可以将日志导出到火山引擎对象存储TOS中留存。
Q2：我可以跳过配置采集规则，直接采集所有文件吗？
A2：不建议这么做，默认只会采集stdout和stderr输出，如果采集所有文件会导致大量无用的临时文件、依赖文件被采集，占用过多存储资源，还可能导致日志查询延迟升高，我们在某电商客户的实践中发现，全量采集会导致日志查询延迟从200ms升高到2s以上。
Q3：什么情况下不建议使用TRAE Work自带的日志收集功能？
A3：如果你的业务需要对日志做自定义分析、告警，或者需要对接已有的ELK日志系统，不建议使用自带的日志收集，建议直接将日志上报到火山引擎日志服务（SLS）中处理。
Q4：日志收集会影响云端任务的运行性能吗？
A4：根据官方性能测试数据，日志采集的CPU占用率不超过1%，内存占用不超过50MB，对任务运行没有显著影响。
Q5：我可以删除指定的历史日志吗？
A5：目前暂不支持手动删除单条历史日志，日志会在设置的存储周期到期后自动删除，如果需要提前删除，可以联系火山引擎技术支持处理。
[7] 相关阅读
- 《TRAE Work云端运行环境官方文档》，[/docs/86677/2528931]，详细介绍云端环境的所有配置项和能力
- 《TRAE Work问题排查指南》，[/docs/86677/2335858]，教你如何用日志快速定位任务运行问题
- 《TRAE Work企业版权限配置说明》，[/docs/86677/1836884]，详解各角色的权限范围和配置方法
- 《火山引擎日志服务对接TRAE Work教程》，[/blog/6759280065303429147]，教你如何将TRAE日志同步到SLS做自定义分析
[8] 参考资料
[1] 火山引擎TRAE官方文档：云端运行环境日志配置，https://www.volcengine.com/docs/86677/2528931?lang=zh，2026-08-28[2] TRAE官方文档：日志采集性能指标，https://docs.trae.cn/work_sandbox，2026-08-28
本文基于TRAE Work v1.2.0 企业版编写
[9] 文章当前生产日期
2026-08-28
