digitalwonderland/logstash

Logstash Docker镜像文档

镜像概述

本Docker镜像基于https://registry.hub.docker.com/u/digitalwonderland/base/%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%9B%86%E6%88%90%E4%BA%86Logstash%E6%97%A5%E5%BF%97%E5%A4%84%E7%90%86%E5%B7%A5%E5%85%B7%EF%BC%8C%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8E%E6%97%A5%E5%BF%97%E7%9A%84%E6%94%B6%E9%9B%86%E3%80%81%E8%BF%87%E6%BB%A4%E3%80%81%E8%BD%AC%E6%8D%A2%E4%B8%8E%E8%BD%AC%E5%8F%91%EF%BC%8C%E6%94%AF%E6%8C%81%E4%B8%8EElasticsearch%E7%AD%89%E5%90%8E%E7%AB%AF%E5%AD%98%E5%82%A8%E7%B3%BB%E7%BB%9F%E9%9B%86%E6%88%90%E3%80%82

核心功能与特性

Elasticsearch连接配置

采用Logstash的elasticsearch_http输出插件实现与Elasticsearch的连接，提供更好的版本兼容性。连接参数可通过环境变量配置：

• ELASTICSEARCH_PORT_9200_TCP_ADDR：Elasticsearch主机地址，默认值为elasticsearch
• ELASTICSEARCH_PORT_9200_TCP_PORT：Elasticsearch端口，默认值为9200

日志输入端口

内置以下日志输入方式：

• logstash-forwarder：监听端口5043，需通过卷挂载证书文件至/mnt/logstash-forwarder目录
• TCP输入：监听端口3333，接收TCP协议日志数据
• Syslog输入：监听端口1514（因Logstash非root用户运行，建议映射至主机514端口以使用标准syslog端口）

使用场景

适用于需要集中化日志收集与处理的场景，如服务器集群日志聚合、应用程序日志分析、网络设备日志集中管理等，可作为日志处理 pipeline 的核心组件。

使用方法与配置说明

基本运行命令

bash
docker run -d \
  -p 5043:5043 \
  -p 3333:3333 \
  -p 514:1514 \  # 映射syslog标准端口
  -v /path/to/certificates:/mnt/logstash-forwarder \  # 挂载logstash-forwarder证书
  -e ELASTICSEARCH_PORT_9200_TCP_ADDR=es-host \  # 自定义Elasticsearch主机
  -e ELASTICSEARCH_PORT_9200_TCP_PORT=9200 \  # 自定义Elasticsearch端口
  digitalwonderland/logstash

参数说明

• 端口映射：必须映射5043（logstash-forwarder）、3333（TCP输入）端口；1514端口建议映射至主机514以支持标准syslog
• 卷挂载：/mnt/logstash-forwarder目录需挂载包含logstash-forwarder所需证书的本地目录
• 环境变量：通过ELASTICSEARCH_PORT_9200_TCP_ADDR和ELASTICSEARCH_PORT_9200_TCP_PORT自定义Elasticsearch连接信息，未指定时使用默认值

docker-compose配置示例

yaml
version: '3'
services:
  logstash:
    image: digitalwonderland/logstash
    ports:
      - "5043:5043"
      - "3333:3333"
      - "514:1514"
    volumes:
      - ./logstash-forwarder-certs:/mnt/logstash-forwarder
    environment:
      - ELASTICSEARCH_PORT_9200_TCP_ADDR=elasticsearch
      - ELASTICSEARCH_PORT_9200_TCP_PORT=9200
    depends_on:
      - elasticsearch

  elasticsearch:
    image: elasticsearch:latest
    ports:
      - "9200:9200"