日志中心与故障排查
“日志中心”用于查看面板、Agent 和任务运行过程中的诊断信息。排查时优先找到同一时间的第一条错误；后续错误往往只是它的连锁结果。
- 01记录记下出错现场记录准确时间、操作入口和错误文字。
- 02入口打开日志中心点击左侧“日志中心”。
- 03筛选缩小范围按时间、级别、模块或关键词筛选。
- 04定位找第一条错误从操作前几秒读到第一条 error 或 failed。
- 05展开查看关联信息记录关联的 Agent、实例或任务标识。
- 06复测修复后重测一次只改一个原因，验证后再继续。
查看一次错误
- 先在出错页面记录准确时间、操作入口和错误文字。
- 点击左侧“日志中心”。
- 使用当前版本提供的时间、级别、模块或关键词筛选。
- 从操作发生前几秒开始阅读，找到第一条 error、failed、timeout 或 denied 记录。
- 展开上下文，记录关联的 Agent、实例或任务标识。
- 修复一个原因后重新测试，不要同时改多项配置。
如果当前版本没有筛选或导出按钮，使用页面搜索和截图记录；不要假定旧版本中的控件仍然存在。
常见关键词
| 关键词 | 常见方向 |
|---|---|
401 / 403 | 凭据、授权范围、账号或额度 |
404 | Base URL、接口路径、模型 ID 或远程资源 |
429 | 速率限制、余额或并发量 |
timeout / ECONN | 网络、代理、端口、服务状态 |
ENOENT | 文件、命令或运行环境路径不存在 |
EACCES / denied | 文件系统、账号或安全防护权限 |
spawn | 外部命令无法启动、PATH 或安全软件拦截 |
按模块排查
- 安装失败：检查下载、解压、磁盘、权限和子进程错误。
- 模型失败：检查 HTTP 状态码、接口格式和模型 ID。
- 实例离线：检查连接时间、端口、SSH 和远程服务日志。
- Skill/MCP 失败：检查依赖命令、环境变量、工具初始化和权限。
- 文件问题：检查工作目录、路径、ACL、加密和敏感文件夹规则。
- 定时任务：检查计划时间、触发记录、实例和最终状态。
提交前清理敏感信息
日志可能包含 Token、API Key、账号、IP、文件路径、任务内容和客户数据。提交前只保留定位问题需要的时间段，遮住或移除完整凭据；不要直接上传整个日志目录。
形成可复现记录
一份有效记录应包括：软件/系统版本、复现步骤、预期结果、实际结果、发生时间、第一条错误和已经尝试的操作。准备完成后按 技术支持 选择官方渠道。
日志无法打开
- 重启面板后再次进入日志中心。
- 确认磁盘空间和当前账号对数据目录有读写权限。
- 不要在未知目录中批量删除日志。
- 如果面板无法启动，保留现场并通过官网联系技术支持获取对应版本的数据目录说明。