amouat/logspout-logstash

logspout

这是gliderlabs/logspout的分叉版本，基于Alpine 3.4镜像构建，并集成Logstash插件。Logspout是运行在Docker内部的日志路由器，可附着到主机所有容器，将日志路由到指定位置，支持可扩展模块系统。

核心功能

• 收集Docker容器的stdout和stderr日志
• 支持将日志路由到Logstash等目标
• 提供HTTP流接口实时查看聚合日志
• 通过API管理自定义日志路由规则
• 支持忽略特定容器日志（环境变量或标签方式）

使用场景

• 集中化管理Docker容器日志
• 将日志发送到Logstash进行分析存储
• 实时监控容器运行日志
• 自定义日志过滤与路由规则

配置说明

1. 挂载Docker Socket：必须将主机/var/run/docker.sock挂载到容器内对应路径
2. 忽略容器：通过LOGSPOUT=ignore环境变量或logspout.exclude标签排除特定容器
3. 自定义路由：通过HTTP API创建过滤（如容器名称、日志类型）和目标（如Logstash地址）的路由规则

Docker部署示例

路由到Logstash

bash
docker run --name logspout-logstash \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  amouat/logspout-logstash \
  logstash://your-logstash-host:5044

忽略特定容器

bash
# 启动logspout指定排除标签
docker run --name logspout-logstash \
  -e EXCLUDE_LABEL=logspout.exclude \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  amouat/logspout-logstash \
  logstash://your-logstash-host:5044

# 启动需忽略的容器添加标签
docker run -d --label logspout.exclude=true your-app-image

实时查看日志流

bash
docker run -d --name logspout-logstash \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  --publish=127.0.0.1:8000:80 \
  amouat/logspout-logstash

# 通过curl获取实时日志
curl [***]