stakater/filebeat-with-consul-template

Filebeat with Consul Template

镜像概述和主要用途

一个集成Consul Template的Filebeat Docker容器，用于通过Consul动态生成Filebeat配置文件，实现灵活的日志收集与配置管理。该镜像结合Filebeat的日志收集能力与Consul Template的动态配置生成功能，适用于需要根据Consul Key-Value存储动态调整日志收集规则的环境。

支持的标签

• 5.2-0.18.0、latest - Filebeat v5.2 与 Consul Template v0.18.0 (https://github.com/stakater/dockerfile-filebeat-with-consul-template/blob/master/5.2/Dockerfile)
• 1.2-0.18.0 - Filebeat v1.2 与 Consul Template v0.18.0 (https://github.com/stakater/dockerfile-filebeat-with-consul-template/blob/master/1.2/Dockerfile)

核心功能和特性

• 动态配置生成：通过Consul Template从Consul实例查询配置，自动更新Filebeat配置文件
• 灵活日志路径配置：支持通过Consul Key-Value条目自定义日志路径
• 多版本支持：提供Filebeat v1.2和v5.2版本，适配不同需求
• 自动重启Filebeat：配置更新后自动重启Filebeat以应用新配置

使用场景和适用范围

• 需要动态调整日志收集路径的微服务环境
• 基于Consul进行配置管理的系统
• 日志路径或收集规则频繁变化的场景
• 需要集中化管理日志收集配置的环境

使用方法和配置说明

基本运行命令

bash
docker run stakater/filebeat-with-consul-template

指定模板文件

挂载本地模板目录到容器的/templates目录：

bash
docker run -d -v $(PWD)/templates:/templates stakater/filebeat-with-consul-template

工作原理

Consul Template守护进程查询Consul实例，更新指定的模板文件，并在更新完成后可选执行命令。默认执行以下命令：

bash
consul-template -consul-addr=$CONSUL_URL -template="/templates/filebeat.ctmpl:/etc/filebeat/filebeat.yml:/usr/bin/filebeat -c /etc/filebeat/filebeat.yml"

其中，CONSUL_URL环境变量需指定Consul实例地址（格式：host:port）。

示例模板

镜像提供了示例模板（位于templates目录），使用前需满足以下前置条件：

前置条件

Consul Key-Value条目

• 默认情况下，Filebeat配置为从/var/log/app/*.log读取日志（/var/log/app为容器内映射目录）。若日志位于子目录或不同路径，可通过Consul Key-Value条目/filebeat/logsPath定义路径。

示例：/var/log/app/*/*.log