jfusterm/logstash

标签与Dockerfile

• 2.4.0, 2.4, latest https://github.com/jfusterm/dockerfiles/blob/master/logstash/Dockerfile

什么是Logstash？

Logstash 是一款用于收集、处理和转发事件与日志消息的工具。其数据收集通过可配置的输入插件实现，包括原始 socket/数据包通信、文件尾随和多种消息总线客户端。输入插件收集数据后，可由多个过滤器插件进行处理，对事件数据进行修改和注释。最终，Logstash 将事件路由至输出插件，转发至多种外部程序，包括 Elasticsearch、本地文件及多种消息总线实现。

核心功能与特性

• 灵活的数据收集：支持多种输入插件，适应不同数据源（如文件、网络、消息队列等）
• 强大的数据处理：可通过过滤器插件对数据进行转换、丰富和清洗
• 多目标数据输出：支持将处理后的数据转发至Elasticsearch、文件、消息总线等多种目标
• 轻量级基础：基于Alpine系统，镜像体积小，资源占用低

使用场景与适用范围

• 日志集中管理：收集分散在多个服务器或应用的日志，实现统一管理
• 数据预处理：在数据存储或分析前进行过滤、转换和 enrichment
• 与Elasticsearch集成：作为ELK（Elasticsearch, Logstash, Kibana）栈的核心组件，实现日志的收集与处理
• 事件流处理：实时处理和转发系统事件、应用事件等

使用方法与配置说明

环境变量

• ELASTICSEARCH：指定Elasticsearch服务地址，用于配置输出插件连接Elasticsearch

Docker运行示例

通过以下命令启动Logstash容器，指定Elasticsearch服务地址并映射端口：

bash
docker run -d --name logstash -p 5044:5044 -e ELASTICSEARCH="elasticsearch-ip" jfusterm/logstash

参数说明：

• -d：后台运行容器
• --name logstash：指定容器名称为logstash
• -p 5044:5044：映射容器的5044端口到主机，用于接收日志数据
• -e ELASTICSEARCH="elasticsearch-ip"：设置环境变量，指定Elasticsearch服务的IP地址或主机名

自定义配置

如需使用自定义Logstash配置文件，可通过挂载卷的方式替换默认配置：

bash
docker run -d --name logstash -p 5044:5044 -v /path/to/custom/logstash.conf:/etc/logstash/conf.d/logstash.conf jfusterm/logstash

其中/path/to/custom/logstash.conf为本地自定义配置文件路径，容器将使用该配置文件启动Logstash。