denibertovic/logstash

Logstash Docker镜像文档

镜像概述和主要用途

本镜像包含Logstash 1.4.2，用于日志的收集、处理和转发，是ELK（Elasticsearch, Logstash, Kibana）栈的重要组成部分。需配合Elasticsearch运行，支持通过OpenSSL证书实现与logstash-forwarder的安全通信。

核心功能和特性

• 支持日志收集、处理和转发
• 需OpenSSL证书进行安全通信（构建时若无证书将失败）
• 提供多端口服务：514(syslog)、5043(lumberjack)、9292(logstash ui)
• 支持挂载配置文件和证书卷，方便自定义配置

使用场景和适用范围

适用于需要集中收集、处理和分析各类日志的场景，如服务器日志、应用程序日志等，需配合ELK栈使用以实现完整的日志分析功能。

使用方法和配置说明

1. 创建OpenSSL证书

为确保与logstash-forwarder的安全通信，需先创建证书：

bash
mkdir certs && cd certs
openssl req -x509 -batch -nodes -newkey rsa:2048 -keyout logstash-forwarder.key -out logstash-forwarder.crt

2. 拉取镜像

从Docker Hub拉取镜像：

bash
docker pull docker.xuanyuan.run/denibertovic/logstash

3. 运行Elasticsearch

Logstash需依赖Elasticsearch，先启动Elasticsearch容器：

bash
docker run --name elasticsearch -d -t docker.xuanyuan.run/denibertovic/elasticsearch

4. 运行Logstash

启动Logstash容器，挂载证书和配置卷，并链接Elasticsearch：

bash
docker run --name logstash -p 5043:5043 -p 514:514 -v `pwd`/certs:/opt/certs \
    -v `pwd`/conf-example:/opt/conf --link elasticsearch:elasticsearch -i -t docker.xuanyuan.run/denibertovic/logstash

5. 测试数据发送

服务运行后，可使用netcat发送测试数据：

bash
netcat localhost 514
    > test
    > test
    > CTRL+C

发送后应能在Logstash中看到相应消息。

端口说明

• 514：syslog协议端口
• 5043：lumberjack协议端口
• 9292：logstash Web UI端口

卷说明

• /opt/conf：包含logstash.conf配置文件
• /opt/certs：包含logstash-forwarder证书（logstash-forwarder.key和logstash-forwarder.crt）