Logstash 5.4.0持久化队列未生成Tail文件问题求助

刚上手Logstash持久化队列就遇到这个问题确实头疼，我来帮你梳理下可能的原因和对应的排查、解决步骤：

一、队列滚动的触发条件没满足 #

Logstash的持久化队列滚动到新page文件，核心是两个触发条件：要么单个page文件达到queue.page_capacity的上限，要么整个队列的总大小达到queue.max_bytes的阈值。从你给出的文件来看，page.1刚好是1GB（1048576000字节），这正好是默认的page_capacity和max_bytes值。

• 排查与测试：
  1. 先确认你的logstash.yml里是不是保留了默认的队列配置，没有调小阈值。如果输入的日志量还没填满这1GB的page文件，自然不会触发滚动。
  2. 快速测试：临时把queue.max_bytes和queue.page_capacity改成更小的值（比如50MB），重启Logstash后发送足够多的日志（比如用filebeat批量推送，或者用curl往输入端口发测试数据），观察队列目录是否生成page.2，同时checkpoint.head是否滚动为checkpoint.tail。

二、输出端阻塞或处理过慢 #

持久化队列的滚动逻辑依赖于输出插件成功处理并确认消息。如果输出端（比如Elasticsearch）卡住、超时或者处理速度跟不上输入速度，Logstash会暂停写入新的page文件，避免消息丢失，这时候队列就会一直停留在head状态。

• 排查与测试：
  1. 查看Logstash的运行日志（默认路径logs/logstash-plain.log），搜索输出插件相关的关键字（比如elasticsearch），看是否有连接失败、批量写入超时、索引不存在这类WARN或ERROR日志。
  2. 临时验证：把输出改成stdout插件，发送大量日志，看队列是否能正常滚动。如果切换后正常，那问题肯定出在原输出端，针对性修复即可（比如调整Elasticsearch的batch_size、timeout参数，或者确保ES集群健康）。

三、持久化队列配置未正确加载 #

有时候修改了logstash.yml但Logstash没读到正确配置，也会导致队列行为不符合预期。

• 排查与验证：
  1. 检查配置文件里的核心配置是否正确：

     queue.type: persisted  # 必须设置为persisted才会启用持久化队列
     queue.max_bytes: 1024mb
     queue.page_capacity: 1024mb
     

  2. 启动Logstash时加上--config.test_and_exit参数，验证配置是否有效。同时查看启动日志，确认是否有类似Using persisted queue with path ...的日志，以及队列参数是否和你配置的一致。

四、磁盘权限或空间问题 #

虽然你的初始文件已经生成，但如果后续磁盘空间不足，或者Logstash进程对队列目录没有写入权限，也会无法创建新的page文件。

• 排查与修复：
  1. 用df -h命令查看队列目录（默认是data/queue）所在磁盘的剩余空间，确保有足够空间容纳新的page文件。
  2. 检查队列目录及文件的权限：你当前的文件是root:root权限，如果Logstash是用logstash系统用户运行的，那它可能没有写入权限。可以用chown -R logstash:logstash /path/to/logstash/data/queue修改权限，之后重启Logstash测试。

内容的提问来源于stack exchange，提问作者SimonDawe