zappi/filebeat

docker-filebeat

镜像概述

docker-filebeat是基于Alpine Linux的Filebeat Docker镜像。Filebeat是一款轻量级日志数据传输工具，主要用于收集、解析服务器或应用程序产生的日志数据，并将其传输到Elasticsearch、Logstash、Kafka等目标系统，实现日志集中管理与分析。

核心功能与特性

• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低，适合在资源受限环境中部署
• 日志收集能力：支持从文件、标准输入等多种来源收集日志数据
• 灵活输出配置：可配置多种输出目标（如Elasticsearch、Logstash、Kafka等）
• 配置验证：提供配置文件语法及有效性验证功能，确保部署前配置正确

使用场景

适用于需要集中收集、传输日志数据的各类场景，包括但不限于：

• 服务器集群日志集中管理
• 应用程序日志实时监控与分析
• 多节点日志数据聚合与存储
• 日志数据预处理与转发

使用方法

配置验证

使用以下命令验证Filebeat配置文件的正确性：

bash
docker run -it zappi/filebeat -e -c /etc/filebeat/filebeat.yml -configtest

命令参数说明：

• -it：以交互模式运行容器，便于查看输出信息
• -e：启用日志输出到标准错误流
• -c /etc/filebeat/filebeat.yml：指定Filebeat配置文件路径
• -configtest：执行配置文件验证，检查语法及配置有效性

示例输出：

2017/01/16 03:35:58.581352 beat.go:267: INFO Home path: [/] Config path: [/] Data path: [//data] Logs path: [//logs]
2017/01/16 03:35:58.581395 beat.go:177: INFO Setup Beat: filebeat; Version: 5.1.2
2017/01/16 03:35:58.581419 publish.go:271: INFO No outputs are defined. Please define one under the output section.
2017/01/16 03:35:58.581433 beat.go:288: CRIT Exiting: error initializing publisher: No outputs are defined. Please define one under the output section.
Exiting: error initializing publisher: No outputs are defined. Please define one under the output section.

注：上述输出提示未定义日志输出目标，需在filebeat.yml配置文件的output部分添加具体目标配置（如Elasticsearch地址、Logstash主机等）。