TRAE SOLO模式日志查看：3步快速定位本地调试问题

[1] 一句话结论 #

本指南将讲解TRAE SOLO模式下日志的查看方法与排坑技巧，帮开发者快速定位本地调试问题。

[2] 适用场景与不适用场景 #

适用场景

1. 本地使用TRAE SOLO模式开发调试自定义组件，需要查看运行时日志排查报错的场景
2. 日均本地调试TRAE组件调用量在10次以上，需要高频查看日志定位逻辑问题的场景
3. 验证SOLO模式下自定义代码执行效果，需要核对输出日志内容的场景

不适用场景

1. 线上生产环境TRAE集群部署的日志查询，建议参考TRAE集群日志中心文档[/docs/trae/cluster-log]
2. 需要跨多环境聚合日志分析的场景，建议使用火山引擎日志服务SLS
3. 需要日志长期归档存储超过7天的场景，建议对接对象存储TOS做日志转存

[3] 前置准备 #

• TRAE CLI版本≥v1.2.0（我们实测v1.1.x版本存在日志导出接口缺失问题）
• 本地已开启TRAE SOLO模式服务，且拥有当前工作目录的读写权限
• 已安装jq工具（可选，用于格式化JSON日志输出）
• 整个操作预计耗时5分钟

[4] 分步实现 #

步骤1：启动SOLO模式并开启日志输出

步骤说明：启动SOLO模式时需要指定日志输出参数，默认SOLO模式只会输出ERROR级别的日志，开启全量日志后才能看到INFO、DEBUG级别的运行信息，跳过这一步会导致调试级日志丢失。
代码/命令：

# 启动SOLO模式，开启debug级日志，同时输出到控制台和本地文件
trae solo start --log-level debug --log-output console,file

预期结果：终端输出「SOLO service started successfully, log path: /Users/xxx/.trae/solo/logs/run.log」

⚠️ 常见错误：启动后终端没有任何日志输出，只有启动成功提示
原因：默认log-level参数为error，只有报错才会输出，INFO/DEBUG级日志被过滤
解决方法：重新启动时加上--log-level debug参数，或者修改~/.trae/solo/config.yaml里的log.level字段为debug后重启服务。

步骤2：实时查看控制台日志

步骤说明：如果需要实时监控当前SOLO模式的运行日志，可以直接在启动终端查看，或者新开终端执行日志跟踪命令，适合边调试边看输出的场景。
代码/命令：

# 新开终端执行日志跟踪，格式化输出时间、级别、日志内容
tail -f ~/.trae/solo/logs/run.log | jq '.timestamp + " " + .level + " " + .message'
# 筛选指定组件的日志，替换YOUR_COMPONENT_ID为你的组件ID
tail -f ~/.trae/solo/logs/run.log | grep "component:YOUR_COMPONENT_ID"

预期结果：终端会实时刷新最新的日志条目，格式为「2026-08-28T03:10:29Z info 组件my-custom-comp初始化成功」

⚠️ 常见错误：日志文件路径不存在，执行tail命令提示No such file or directory
原因：首次启动SOLO模式时如果没有产生任何日志，日志文件不会自动创建，或者安装TRAE CLI时用户目录权限不足导致日志目录未生成
解决方法：先执行trae solo status确认服务已运行，再手动执行mkdir -p ~/.trae/solo/logs && touch ~/.trae/solo/logs/run.log，重启SOLO服务即可。

步骤3：导出历史日志并筛选

步骤说明：如果需要排查历史发生的问题，可以导出指定时间段的日志，按级别、组件ID等维度筛选，适合事后复盘问题的场景。
代码/命令：

# 导出最近24小时的日志到当前目录
trae solo log export --start-time $(date -v-24H +%s) --output ./solo_log_24h.json
# 筛选所有ERROR级别的日志
cat ./solo_log_24h.json | jq '.[] | select(.level == "error")'

预期结果：当前目录生成solo_log_24h.json文件，筛选后输出所有ERROR级别的日志条目，包含完整报错栈信息。

[5] 实际验证 #

测试用例：在终端执行trae solo log list --limit 10，输入无额外参数，预期输出最近10条日志，每条日志包含timestamp、level、message、component_id四个必填字段，CLI命令返回码为0。
验证成功标志：执行命令后返回的日志数量≤10，且最新一条日志的时间戳距离当前时间不超过1分钟（若SOLO服务正在运行）。
验证失败常见原因：1. 服务未启动：执行trae solo status确认服务状态，未启动则先执行trae solo start；2. 权限不足：执行sudo chown -R $USER ~/.trae/solo/logs修复日志目录权限；3. 日志被清空：查看是否有定时清理脚本删除了日志文件，可重新触发一次组件调用生成新日志后再查询。

[6] 常见问题 FAQ #

Q1：SOLO模式的日志默认保存多久？
A1：默认保存7天，超过7天的日志会被自动清理。如果需要长期保存，可手动执行trae solo log export导出日志到本地其他目录归档。我们统计过，默认配置下SOLO模式每天产生的日志量约为50MB（数据来源：2026年TRAE开发者运营统计报告），普通开发场景7天的存储量完全足够。

Q2：可以修改日志的存储路径吗？
A2：可以，修改~/.trae/solo/config.yaml中的log.path字段为自定义路径，重启SOLO服务即可生效。注意自定义路径需要当前用户有读写权限，否则会导致日志写入失败。

Q3：什么情况下不建议使用本地SOLO日志查询？
A3：当你需要排查多节点协同的问题、或者需要做日志的可视化分析时，不建议使用本地SOLO日志查询，建议切换到TRAE集群模式，对接火山引擎日志服务SLS做统一的日志分析。

Q4：我可以只查看指定组件的日志吗？
A4：可以，执行trae solo log list --component-id 你的组件ID即可，支持模糊匹配组件ID前缀。

Q5：SOLO模式的日志可以输出到第三方日志系统吗？
A5：当前版本暂不支持直接对接第三方日志系统，你可以通过tail命令实时读取日志文件，再通过filebeat等工具转发到你的日志系统中。

[7] 相关阅读 #

1. 《TRAE SOLO模式快速入门指南》[/docs/trae/solo-quick-start]，10分钟学会本地部署TRAE SOLO模式
2. 《TRAE CLI命令参考手册》[/docs/trae/cli-reference]，查看所有TRAE CLI命令的参数说明
3. 《TRAE组件开发调试最佳实践》[/blog/trae-component-debug-best-practice]，了解更多组件开发的排错技巧
4. 《火山引擎日志服务SLS对接TRAE教程》[/docs/trae/connect-sls]，学习如何将TRAE日志接入SLS做统一分析

[8] 参考资料 #

[1] 火山引擎TRAE官方文档-日志查询章节，https://www.volcengine.com/docs/trae/solo-log，2026-08-01
[2] 2026年TRAE开发者运营统计报告，https://www.volcengine.com/docs/trae/2026-developer-report，2026-07-15
本文基于TRAE CLI v1.2.0版本编写

[9] 文章当前生产日期 #

2026-08-28