MemeMeow/docs/executor-failure-diagnostics.md

Executor 失败诊断日志

Executor 把失败 attempt 的诊断写入 /runtime/executor-logs/agent-diagnostics.log。 该目录使用现有 mememeow-agent-runtime-data volume，容器重建后日志仍然保留。 宿主机运行 Executor 时，可以通过 MEMEMEOW_EXECUTOR_DIAGNOSTICS_ROOT 指定目录。

在部署使用的 .env 中设置文件轮转容量：

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 表示过滤的行数。

插件检查失败、进程异常退出、超时、取消和结果文件校验失败均使用同一诊断入口。 日志包含内部故障信息，应通过服务器运维权限读取。