Files
MemeMeow/docs/executor-failure-diagnostics.md

29 lines
1.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Executor 失败诊断日志
Executor 把失败 attempt 的诊断写入 `/runtime/executor-logs/agent-diagnostics.log`。
该目录使用现有 `mememeow-agent-runtime-data` volume,容器重建后日志仍然保留。
宿主机运行 Executor 时,可以通过 `MEMEMEOW_EXECUTOR_DIAGNOSTICS_ROOT` 指定目录。
在部署使用的 `.env` 中设置文件轮转容量:
```dotenv
MEMEMEOW_AGENT_DIAGNOSTICS_ROTATION=200 MB
```
默认容量为 `200 MB`。Loguru 在单个文件达到容量时开始写入新文件,轮转时清理超过
14 天的日志。容量与保留期限共同决定占用空间;`200 MB` 是单个文件的轮转容量。
配置在 Executor 启动时读取,部署更新后生效。
每条 `executor_attempt_failure` 记录包含 Task 与 attempt 标识、恢复执行标志、最终状态、
错误码、失败阶段、执行耗时、进程退出码与回收状态,以及插件就绪状态和初始化错误。
signal 导致的负数退出码保持原值。
进程输出在临时文件关闭前采集。stdout 读取头尾各至多 256 KiB,stderr 读取头尾各至多
16 KiB;写入日志前移除已知凭据和本地路径,每行至多 500 个字符,每种输出摘要至多
16 KiB。stdout 仅保留 error 事件中的原因与状态码,普通消息正文不进入日志。
`stdout_bytes`、`stderr_bytes` 保存原始字节数,`*_truncated` 表示内容被截断,
`stdout_omitted_lines` 表示过滤的行数。
插件检查失败、进程异常退出、超时、取消和结果文件校验失败均使用同一诊断入口。
日志包含内部故障信息,应通过服务器运维权限读取。