kibatic/logstash

Logstash Docker镜像（含额外插件）

镜像概述

本镜像基于Elastic官方Logstash镜像构建，在保留官方镜像核心功能的基础上，集成了额外插件，扩展了日志处理能力。适用于需要通过Logstash进行日志收集、过滤、转换并转发至目标存储或分析系统的场景。

核心功能与特性

• 基于官方镜像：继承Elastic官方Logstash镜像的稳定性与兼容性，确保与Elastic Stack（Elasticsearch、Kibana等）无缝集成
• 额外插件支持：内置额外插件，扩展日志处理能力（具体插件可通过镜像内命令查看）
• 完整功能保留：支持Logstash核心功能，包括输入（Inputs）、过滤（Filters）、输出（Outputs）插件架构
• 灵活配置：支持通过环境变量、配置文件挂载等方式自定义日志处理流程

使用场景与适用范围

• 需要使用官方镜像未包含的额外插件进行日志处理的场景
• 企业级日志集中收集、清洗与转发
• 与Elastic Stack集成的日志分析平台构建
• 自定义日志处理 pipeline（如数据脱敏、格式转换、字段提取等）

使用方法与配置说明

基本运行命令

bash
docker run -d --name logstash-with-plugins \
  -v /path/to/pipeline:/usr/share/logstash/pipeline \
  -e "LS_JAVA_OPTS=-Xms512m -Xmx512m" \
  your-image-name:tag

关键参数说明

Docker Compose示例

yaml
version: '3'
services:
  logstash:
    image: your-image-name:tag
    container_name: logstash-with-plugins
    volumes:
      - ./pipeline:/usr/share/logstash/pipeline
      - ./config:/usr/share/logstash/config
    environment:
      - LS_JAVA_OPTS=-Xms512m -Xmx512m
      - ELASTICSEARCH_HOSTS=http://elasticsearch:9200
    ports:
      - "5044:5044"  # Filebeat输入端口
    depends_on:
      - elasticsearch

查看已安装插件

进入容器后执行以下命令查看所有插件：

bash
docker exec -it logstash-with-plugins bin/logstash-plugin list

自定义配置

1. 创建pipeline配置文件（如./pipeline/logstash.conf），定义输入、过滤、输出逻辑：

   conf
   input {
     beats {
       port => 5044
     }
   }
   
   filter {
     # 添加自定义过滤规则
     grok {
       match => { "message" => "%{COMBINEDAPACHELOG}" }
     }
   }
   
   output {
     elasticsearch {
       hosts => ["elasticsearch:9200"]
       index => "logstash-%{+YYYY.MM.dd}"
     }
     stdout { codec => rubydebug }
   }
   

2. 通过卷挂载配置文件，启动容器即可应用自定义pipeline。