itzg/logstash

Logstash 镜像文档

镜像概述

本镜像集成最新版本（1.5.x）的Logstash，具备管理自身Elasticsearch索引的能力。Logstash作为开源数据收集引擎，可实现数据的收集、转换与传输，本镜像简化了其部署与使用流程。

核心功能与特性

• 内置Logstash 1.5.x版本，支持完整的数据收集、处理和输出能力
• 具备Elasticsearch索引自管理功能，简化索引维护操作
• 支持外部配置文件挂载，可灵活定制数据处理管道
• 提供日志目录挂载机制，方便收集主机系统日志
• 内置collectd数据接收支持，暴露UDP 25826端口

使用场景

• 服务器与应用程序日志集中收集与分析
• 作为ELK（Elasticsearch, Logstash, Kibana）栈的核心组件部署
• collectd监控数据的接收与处理
• 自定义数据处理管道的快速部署与测试

使用方法

基本用法

启动Logstash容器前，需在主机创建包含Logstash管道配置文件的目录（记为$HOST_CONF），执行以下命令启动容器：

bash
docker run -d -v $HOST_CONF:/conf itzg/logstash

访问主机日志

为使Logstash处理主机日志，需将主机/var/log目录挂载到容器/logs卷：

bash
docker run ... -v /var/log:/logs ...

配置文件中需使用/logs作为基础路径定义文件输入，示例：

file {
  path => ['/logs/syslog']
  type => 'syslog'
}

接收collectd输入

容器暴露UDP 25826端口用于接收collectd数据，通过以下命令映射端口：

bash
docker run ... -p 25826:25826/udp

Logstash输入配置需绑定容器内25826端口，示例：

udp {
  port => 25826
  codec => collectd { }
  buffer_size => 1452
}