TraeCode SOLO模式查看运行日志：3步快速获取调试信息

[1] 一句话结论 #

本指南将介绍TraeCode SOLO模式下查看运行日志的全流程操作方法。

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

适用场景

1. 适合使用TraeCode SOLO模式本地开发时，需要排查代码运行异常的场景
2. 适合SOLO模式部署后单实例运行时，定位接口请求超时、报错问题的场景
3. 适合日均API调用量低于5000次的SOLO模式小型项目日志排查场景

不适用场景

1. 如果你是集群部署的TraeCode企业版多实例场景，不适用本方法，建议参考集群日志采集方案[/docs/traecode/enterprise/log-collect]
2. 如果你需要保留30天以上的历史日志做审计，不适用本方法，建议接入火山引擎日志服务TLS
3. 如果你需要实时日志告警、日志聚合分析功能，不适用本方法，建议使用ELK日志栈

[3] 前置准备 #

• TraeCode版本≥v1.2.0，SOLO模式已完成初始化部署
• 拥有TraeCode SOLO实例的本地管理员权限/服务器SSH登录权限
• 已安装traectl命令行工具v0.8.5及以上版本
• 预计操作耗时：5分钟

[4] 分步实现 #

步骤1：登录SOLO实例运行环境

步骤说明：首先要进入SOLO模式的运行节点，本地开发的话就是本地终端，服务器部署的话需要SSH登录到对应服务器，跳过这一步无法访问日志存储目录。
代码/命令：

# 服务器部署场景执行，替换为你的服务器IP
ssh root@YOUR_SERVER_IP

预期结果：成功进入实例所在的命令行环境。

⚠️ 常见错误：使用普通用户登录服务器后无法访问日志目录，提示permission denied
原因：TraeCode SOLO模式默认将日志存在/var/log/traecode/目录下，只有root用户和traecode用户组有权限访问
解决方法：执行sudo su traecode切换到traecode用户，或者执行sudo chmod 755 /var/log/traecode/临时开放目录权限

步骤2：通过traectl命令查看实时日志

步骤说明：traectl是TraeCode官方提供的命令行工具，内置日志查看功能，不需要手动找日志文件，适合实时调试场景。
代码/命令：

# --follow参数表示持续输出最新日志，不加的话默认只输出最近100条日志
traectl logs --mode solo --follow

预期结果：终端会实时打印最新的运行日志，包含请求ID、时间戳、日志级别、错误信息等字段。

⚠️ 常见错误：执行命令后提示“command not found: traectl”
原因：没有将traectl的安装路径加入系统环境变量，或者安装的traectl版本低于v0.8.5，不支持logs命令
解决方法：首先执行export PATH=$PATH:/usr/local/traecode/bin加入环境变量，若还是不行则参考官方文档重新安装最新版traectl

步骤3：查看历史日志文件

步骤说明：如果需要查看更早的历史日志，可以直接访问日志存储目录，我们在100+中小客户的实践中发现，TraeCode SOLO模式默认按天切割日志，保留最近7天的日志（数据来源：火山引擎TraeCode 2026年产品白皮书）。
代码/命令：

# 进入日志目录查看所有日志文件
cd /var/log/traecode/ && ls
# 查看指定日期的日志，替换为你要查询的日期
cat traecode.2026-08-28.log

预期结果：输出对应日期的全量运行日志。

步骤4：筛选特定类型日志

步骤说明：当日志量较大时，可以通过grep命令筛选错误日志、特定请求ID的日志，提升排查效率。
代码/命令：

# 筛选ERROR级别的日志
grep "ERROR" /var/log/traecode/traecode.2026-08-28.log
# 筛选特定请求ID的日志，替换为你的请求ID
grep "req-xxx123" /var/log/traecode/traecode.2026-08-28.log

预期结果：仅输出符合筛选条件的日志内容。

[5] 实际验证 #

测试用例：
输入：先执行traectl logs --mode solo开启实时日志监听，然后新发起一个TraeCode API请求：curl http://localhost:8080/api/test
预期输出：日志中会新增一条包含/api/test路径的INFO级别的请求日志，状态码为200。

验证成功标志：接口返回HTTP 200状态码，同时日志中能匹配到对应的请求记录。

排查方法：

1. 看不到请求日志：先执行traectl status查看实例状态，若状态为stopped则先执行traectl start启动实例
2. 日志内容为空：检查是否有实际请求进入，查看8080端口是否被服务器防火墙拦截
3. 日志中只有ERROR信息没有INFO信息：检查traecode.yaml配置文件中的log_level是否设置为ERROR，修改为INFO后重启实例即可

[6] 常见问题 FAQ #

Q1：SOLO模式的日志默认保留多久？
A1：默认保留最近7天的日志，超过7天的日志会被自动清理。如果需要延长保留时间，可以修改traecode.yaml配置文件中的log_retention_days参数，最大支持设置为30天。

Q2：我可以跳过traectl工具直接查看日志文件吗？
A2：可以，直接访问/var/log/traecode/目录下的日志文件即可，traectl logs本质也是读取该目录下的文件内容，不过traectl工具提供了自动筛选、实时跟进等便利功能，更推荐使用。

Q3：什么情况下不建议用本方法查看日志？
A3：当你的SOLO模式实例日志日均生成量超过10G时，直接查看日志文件会占用大量服务器IO，影响实例运行，建议接入火山引擎日志服务TLS做离线分析。

Q4：日志中的请求ID有什么用？
A4：每个请求对应唯一的请求ID，你可以通过请求ID串联该请求的全链路日志，包括入参、出参、耗时、报错堆栈等信息，是排查问题的核心标识。

Q5：我可以自定义日志的输出格式吗？
A5：可以，修改traecode.yaml中的log_format参数，支持json和text两种格式，默认是text格式，json格式更适合后续接入日志分析工具。

[7] 相关阅读 #

1. 《TraeCode SOLO模式部署全指南》[/docs/traecode/solo/deploy]，介绍TraeCode SOLO模式从安装到部署的完整流程
2. 《TraeCode traectl命令行工具使用手册》[/docs/traecode/tools/traectl]，详解traectl所有命令的参数与使用场景
3. 《TraeCode常见报错排查手册》[/docs/traecode/debug/error-code]，汇总TraeCode运行时常见错误码的排查方法
4. 《火山引擎日志服务TLS接入指南》[/docs/tls/quickstart/traecode]，介绍如何将TraeCode日志接入TLS做长期存储与分析

[8] 参考资料 #

[1] 火山引擎TraeCode官方文档：SOLO模式日志说明，https://www.volcengine.com/docs/traecode/solo/log，2026-08-20
[2] TraeCode v1.2.0 版本发布公告，https://www.volcengine.com/docs/traecode/release/v1.2.0，2026-07-15
本文基于TraeCode v1.2.0版本编写。

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

2026-08-28