ai-memory日志与只读沙箱运维可观测性配置指南【免费下载链接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors项目地址: https://gitcode.com/GitHub_Trending/ai/ai-memoryai-memory 是一款面向编码 Agent CLI 的长期记忆方案支持自动采集会话观察、跨厂商 Agent 交接并自带可观测性设施。本文带你快速掌握它的日志系统、只读沙箱降级机制与运维监控配置帮助你在 ai-jail 等沙箱环境中稳定运行 ai-memory 服务。1. 日志在哪里位置与轮转规则ai-memory 的 CLI 与服务端共用同一套结构化日志体系核心实现位于 logging.rs。默认行为很简单日志目录data_dir/logs/默认~/.local/share/ai-memory/logs/轮转策略按天滚动文件名前缀ai-memory.log双通道输出stderr 实时输出 文件持久化异步写入不阻塞命令相关配置项在默认模板 config.default.toml 中有完整注释参考 install.md 的 Logs and read-only sandboxes 章节。2. 只读沙箱的三级降级链为什么命令不会崩很多用户会在 ai-jail、bwrap 等只读沙箱中运行 Agent——这些沙箱通常把$HOME挂载为只读。此时有个隐蔽陷阱日志目录可能已存在目录创建成功但日志文件创建失败。早期版本会直接 panic 崩溃对应 issue #158。现在 ai-memory 采用三级降级链任何一级不可写就平滑降级命令永远能跑完data_dir/logs → 系统临时目录 → 仅 stderr降级层级触发条件行为第 1 级数据目录只读日志改写到 OS 临时目录并打印失败的确切路径第 2 级临时目录也只读降级为纯 stderr 日志长驻 vs 短命服务器 vs 一次性命令服务器大声提示降级短命令保持安静避免误导issue #188运维要点沙箱中希望保留持久日志时只需把数据目录映射为可写例如ai-jail --rw-map ~/.local/share/ai-memory …。降级提示会精确指出哪个路径不可写方便你定位该--rw-map的目录。3. 日志级别怎么调RUST_LOG 与 log_level调级别只需两选一环境变量优先临时调级设置环境变量RUST_LOGdebug或info/warn持久调级修改配置文件中的log_level info一个值得注意的细节日志收集器自身的模块被强制为warn级别以切断警告被自身订阅器捕获→再产生警告的反馈死循环——同类工具的 #519 事故就是因为这个循环写爆了 137 GB 磁盘。这是 ai-memory 在日志设计上吸取的教训对自建 Agent 服务的同学很有参考价值。4. 用 status 命令做日常巡检除日志外ai-memory 提供了一条最轻量的可观测入口——ai-memory status实现见 status.rs。它直接调用服务端的GET /admin/status一次返回服务器版本、bind 地址、SQLite 路径页面 / 会话 / 观察的累计计数派生索引诊断FTS 漂移、嵌入缺失、失效链接Hook 摄入计数器接受数、按策略丢弃数、限流丢弃数LLM Provider 健康快照巡检建议把ai-memory status --json挂到定时任务里重点盯derived段——FTS 行数与 pages 行数漂移、嵌入缺失数突增都是索引失修的早期信号。5. 只读 Web 视图可视化观测记忆库开启 Web 端后--enable-web你可以用浏览器实时查看工作区、项目树与检索结果。整个/api/v1与 Web 界面只读由构造保证零写调用详见 frontend-api.md因此放心开放给团队只读访问也很安全。6. 配置速查表配置项位置说明log_level配置文件 /AI_MEMORY_LOG_LEVEL默认 tracing 过滤级别RUST_LOG优先bind/allowed_hosts配置文件本地回环绑定 主机白名单防 DNS 重绑定--rw-map沙箱侧ai-jail 启动参数数据目录映射为可写保住持久日志/webserve --enable-web只读浏览 检索观测界面status命令CLI计数、索引诊断、Provider 健康一站巡检总结ai-memory 的可观测性设计可以概括为一句话日志永不阻塞命令降级永远有提示。只读沙箱里它自动降级不崩溃巡检靠status一条命令完成可视化交给只读 Web 视图。掌握三级降级链 status 巡检 Web 只读视图这三件套你的 ai-memory 运维就有了完整抓手。【免费下载链接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors项目地址: https://gitcode.com/GitHub_Trending/ai/ai-memory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考