sitch/logstash

SITCH的Logstash容器

概述与主要用途

该容器为SITCH项目提供Logstash运行环境，旨在简化日志处理流程。通过集成必要插件，实现日志的收集、处理与分发，并支持与Elasticsearch、InfluxDB、Slack通知服务及Vault密钥管理工具的无缝对接。

核心功能与特性

• 集成Logstash及所需插件，开箱即用
• 支持与Elasticsearch交互，实现日志存储与检索
• 对接InfluxDB，支持时序数据存储
• 集成Slack通知功能，可配置消息发送
• 支持通过Vault进行安全的密钥管理与访问

使用场景与适用范围

适用于SITCH项目的日志处理流程，包括但不限于：

• 系统日志的收集、过滤与转换
• 日志数据向Elasticsearch的索引存储
• 时序数据向InfluxDB的写入
• 关键事件的Slack通知推送
• 通过Vault安全获取敏感配置信息

使用方法与配置说明

环境变量配置

运行容器前需设置以下环境变量：

启动容器

基本运行方式

设置好环境变量后，使用以下命令启动容器（后台运行模式）：

bash
docker run -d \
  -p 5000:5000 \
  -p 5001:5001 \
  -e ES_URL=$ES_URL \
  -e INFLUXDB_HOST=$INFLUXDB_HOST \
  -e INFLUXDB_PORT=$INFLUXDB_PORT \
  -e SLACK_WEBHOOK=$SLACK_WEBHOOK \
  -e SLACK_USERNAME=$SLACK_USERNAME \
  -e SLACK_ICON=$SLACK_ICON \
  -e VAULT_URL=$VAULT_URL \
  -e VAULT_TOKEN=$VAULT_TOKEN  \
  --name sitch_logstash \
  sitch/logstash

详细输出模式

如需查看详细日志输出，可在启动命令后添加debug参数：

bash
docker run -d \
  -p 5000:5000 \
  -p 5001:5001 \
  -e ES_URL=$ES_URL \
  -e INFLUXDB_HOST=$INFLUXDB_HOST \
  -e INFLUXDB_PORT=$INFLUXDB_PORT \
  -e SLACK_WEBHOOK=$SLACK_WEBHOOK \
  -e SLACK_USERNAME=$SLACK_USERNAME \
  -e SLACK_ICON=$SLACK_ICON \
  -e VAULT_URL=$VAULT_URL \
  -e VAULT_TOKEN=$VAULT_TOKEN  \
  --name sitch_logstash \
  sitch/logstash \
  debug

验证与调试

容器启动后，建议等待几分钟，然后通过以下命令查看日志，确认配置是否正确：

bash
docker logs sitch_logstash

Logstash会在配置错误时输出详细的错误信息，可根据日志提示调整环境变量或配置。