rtoma/logspout-redis-logstash

镜像概述

本镜像基于Logspout扩展，集成Redis适配器，可将Docker容器的标准输出/错误日志收集后，通过Redis推送至Logstash，支持解析结构化JSON日志，适用于日志集中化管理场景。

核心功能

• 收集Docker容器的stdout/stderr日志
• 通过Redis适配器将日志发送至指定Redis实例
• 支持结构化JSON日志解析，保留日志原有字段与结构
• 可通过环境变量灵活配置参数（如Redis键名、调试模式等）

使用场景

• Docker容器集群的日志集中收集与分析
• 与ELK（Elasticsearch、Logstash、Kibana）栈配合构建完整日志管理系统
• 需要对应用日志进行结构化处理的场景

配置说明

通过环境变量指定参数，关键参数如下：

• REDIS_KEY: Redis列表键名（默认值：logspout），日志将被RPUSH至该键
• DEBUG: 是否开启调试日志（值为true时启用）
• REDIS_DOCKER_HOST: 添加Docker主机名至所有日志事件（如myhost）

更多参数详见https://github.com/rtoma/logspout-redis-logstash/blob/master/README.md

快速开始

执行以下命令启动镜像：

bash
docker run -d -v /var/run/docker.sock:/var/run/docker.sock:ro \
  rtoma/logspout-redis-logstash:latest redis://<你的Redis主机地址>

JSON输入支持

v0.1.4及以上版本支持结构化JSON日志输入。若应用输出JSON格式日志，镜像会保留其结构并添加额外元数据（如时间戳、容器信息等）。

输入示例：

json
{"message":"something went bOOm!","level":"ERROR","logtype":"applog","line":42,"file":"source.go"}

发送至Redis的日志结构：

json
{
  "@timestamp": "2016-03-30T10:03:00.016733514Z",
  "host": "16cecd099d78",
  "message": "something went bOOm!",
  "docker": { ... }, 
  "logtype": "applog",
  "applog": {
    "file": "source.go",
    "level": "ERROR",
    "line": 42
  }
}

完整示例

若需体验镜像在ELK栈中的使用，可参考项目提供的docker-compose示例：https://github.com/rtoma/logspout-redis-logstash/tree/master/example