debian如何调试filebeat

在 Debian 上调试 Filebeat，通常可以从日志、配置校验、调试模式、系统服务状态几个方面入手。下面按实用顺序说明。

一、确认 Filebeat 是否正常运行

1. 查看服务状态

systemctl status filebeat

若未运行：

systemctl start filebeat
systemctl enable filebeat

2. 查看进程

ps aux | grep filebeat

二、查看 Filebeat 日志（最重要）

默认日志位置

journalctl -u filebeat -f

或查看日志文件（取决于配置）：

/var/log/filebeat/filebeat

常见错误：

• no such file or directory（路径错误）
• connection refused（Elasticsearch/Logstash 连不上）
• permission denied（无读权限）

三、使用调试模式运行

1. 测试配置文件

filebeat test config

2. 测试输出连接

filebeat test output

3. 前台调试运行（推荐）

先停止服务：

systemctl stop filebeat

然后：

filebeat -e -d "*" -c /etc/filebeat/filebeat.yml

参数说明：

• -e：输出到终端
• -d "*"：开启所有调试
• -c：指定配置文件

四、开启 Filebeat 内部调试日志

在 filebeat.yml 中：

logging.level: debug
logging.to_files: true
logging.files:
  path: /var/log/filebeat
  name: filebeat
  keepfiles: 7

修改后：

systemctl restart filebeat

五、确认输入是否被采集

1. 查看已注册文件

filebeat registry list /var/lib/filebeat/registry

（旧版本可能是 registry.json）

2. 确认文件路径和权限

ls -l /var/log/xxx.log

Filebeat 用户需有读权限：

getent passwd filebeat

六、验证输出是否成功

Elasticsearch

curl -X GET "localhost:9200/_cat/indices?v"

Logstash

查看 Logstash 日志：

journalctl -u logstash -f

七、常见问题速查

如果你愿意，可以贴出：

• filebeat.yml
• 报错日志
• 使用 ES / Logstash / Kafka 哪一种

我可以帮你精准定位问题。