topochan/logstash-es-aws

Docker Logstash with Amazon ES插件

镜像概述

本镜像运行Logstash并集成AWS ElasticSearch插件，用于将日志数据转发至AWS ElasticSearch服务，支持通过环境变量配置关键参数及自定义配置文件。

核心功能

1. 监听UDP端口5000接收日志输入
2. 通过AWS ES插件将日志发送至指定的AWS ElasticSearch集群
3. 支持环境变量配置AWS认证信息、ES端点及索引名称
4. 允许挂载自定义Logstash配置文件，且配置中可引用环境变量

使用场景

• AWS环境下的应用日志收集与存储
• 多服务日志统一转发至AWS ElasticSearch进行分析
• 需要快速部署Logstash与AWS ES集成的场景

配置说明

环境变量

需设置以下环境变量以启用默认配置：

• ES_HOST: AWS ElasticSearch服务端点
• AWS_REGION: AWS ES所在区域
• ACCESS_KEY: AWS访问密钥ID
• SECRET_KEY: AWS访问密钥秘钥
• ENVIRONMENT: 环境名称（用于生成索引名：{ENVIRONMENT}-logs-{DATE}，DATE为当前日期）

自定义配置

若需使用自定义Logstash配置，可将配置文件挂载至容器内的/config-dir/logstash.tpl.conf路径，配置中可通过$VARIABLE引用环境变量。

部署示例

Docker Run命令

bash
docker run -d \
  -p 5000:5000/udp \
  -e ES_HOST="your-es-endpoint.amazonaws.com" \
  -e AWS_REGION="us-east-1" \
  -e ACCESS_KEY="your-access-key" \
  -e SECRET_KEY="your-secret-key" \
  -e ENVIRONMENT="production" \
  topochan/logstash-es-aws

Docker Compose示例

yaml
version: '3'
services:
  logstash-es-aws:
    image: topochan/logstash-es-aws
    ports:
      - "5000:5000/udp"
    environment:
      ES_HOST: "your-es-endpoint.amazonaws.com"
      AWS_REGION: "us-east-1"
      ACCESS_KEY: "your-access-key"
      SECRET_KEY: "your-secret-key"
      ENVIRONMENT: "production"