mesoscloud/logstash

Logstash Docker镜像文档

镜像概述和主要用途

Logstash是Elastic Stack（ELK Stack）的核心组件之一，是一个开源的数据收集、处理和转发引擎。本镜像提供基于CentOS和Ubuntu系统的Logstash运行环境，用于集中收集分布式系统中的日志数据，进行过滤、转换后发送至目标存储（如Elasticsearch）。注意：该镜像已停止维护。

核心功能和特性

• 多源数据收集：支持文件、网络、数据库等多种输入源
• 数据处理能力：提供丰富的过滤器插件，支持数据清洗、转换和 enrichment
• 多目标输出：可将处理后的数据发送至Elasticsearch、文件、消息队列等目标
• 跨平台支持：提供基于CentOS和Ubuntu两种基础系统的镜像版本

使用场景和适用范围

• 分布式系统日志集中管理
• 应用程序日志实时处理与分析
• 服务器和容器日志收集与存储
• 需要对日志数据进行过滤、转换和标准化的场景

使用方法和配置说明

镜像标签说明

• mesoscloud/logstash:1.5.4-centos-7：基于CentOS 7系统的Logstash 1.5.4版本
• mesoscloud/logstash:1.5.4-ubuntu-14.04：基于Ubuntu 14.04系统的Logstash 1.5.4版本

部署示例

CentOS版本

bash
docker run -d \
  -v /srv/events:/srv/events \  # 挂载日志文件目录
  -v /srv/logstash:/srv/logstash \  # 挂载Logstash数据目录（含sincedb）
  --name=logstash \  # 容器名称
  --restart=always \  # 设置自动重启
  mesoscloud/logstash:1.5.4-centos-7 \  # 镜像名称和标签
  logstash -e 'input { file { path => "/srv/events/containers.log-*" codec => json sincedb_path => "/srv/logstash/sincedb" } } output { elasticsearch { } }'  # Logstash配置：从指定路径读取JSON格式日志并输出到Elasticsearch

Ubuntu版本

bash
docker run -d \
  -v /srv/events:/srv/events \  # 挂载日志文件目录
  -v /srv/logstash:/srv/logstash \  # 挂载Logstash数据目录（含sincedb）
  --name=logstash \  # 容器名称
  --restart=always \  # 设置自动重启
  mesoscloud/logstash:1.5.4-ubuntu-14.04 \  # 镜像名称和标签
  logstash -e 'input { file { path => "/srv/events/containers.log-*" codec => json sincedb_path => "/srv/logstash/sincedb" } } output { elasticsearch { } }'  # Logstash配置：从指定路径读取JSON格式日志并输出到Elasticsearch

配置说明

• 挂载卷说明：
  • /srv/events：存放待收集的日志文件
  • /srv/logstash：存放Logstash运行数据（如sincedb文件，用于记录日志读取位置）
• Logstash配置参数：
  • input { file { ... } }：定义输入源为文件，path指定日志文件路径，codec => json指定日志格式为JSON，sincedb_path指定记录读取位置的文件路径
  • output { elasticsearch { } }：定义输出目标为Elasticsearch（默认连接本地Elasticsearch实例，可通过参数指定远程地址）