首页/云/可观测性速查/Filebeat 注册表与文件状态
日志平台52 条

Filebeat 注册表与文件状态

注册表记录每个文件的读取偏移,是“重启后从哪里继续”的依据;轮转、inode 复用、清理策略都围绕它工作。

可观测性速查云更新于 2026-10-12

状态与清理相关配置

状态与清理相关配置
# 注册表位置(默认 data/registry)
filebeat.registry.path: /var/lib/filebeat/registry

# 长期不更新的文件停止监控
ignore_older: 168h

# 清理已删除文件的状态(默认 true)
# clean_removed: true
持久化目录不可放在临时空间:注册表丢失会导致全量重采或漏采。

易错点

  • copytruncate 式轮转存在竞态窗口可能丢行,条件允许优先用 rename 式轮转让采集器跟随
  • inode 被系统复用后旧状态可能匹配到新文件,出现漏采时结合注册表状态排查

数据来源与参考

  • Elastic 官方文档 · Registry file
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌