amaysim/logspout

logspout

Docker Hub上的自动构建镜像gliderlabs/logspout:latest和progrium/logspout:latest当前指向release分支。若需使用master分支，请拉取gliderlabs/logspout:master。各版本镜像可在https://github.com/gliderlabs/logspout/releases获取。

Logspout是一个运行在Docker内部的容器日志路由器，连接主机上所有容器并转发日志至指定位置，支持可扩展模块系统。它是无状态日志工具，仅用于导出日志至外部存储，目前捕获容器stdout和stderr输出。

获取logspout

Logspout基于Alpine（15.2MB虚拟大小），拉取最新版本：

bash
docker pull docker.xuanyuan.run/gliderlabs/logspout:latest

或加载特定版本：

bash
curl -s dl.gliderlabs.com/logspout/v2.tgz | docker load

使用logspout

转发至远程syslog

挂载Docker套接字并指定syslog URI（支持tls加密）：

bash
docker run --name="logspout" \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/gliderlabs/logspout \
  syslog+tls://logs.papertrailapp.com:55555

忽略/包含特定容器

• 忽略：启动容器时加-e LOGSPOUT=ignore；或通过标签过滤（logspout启动时设EXCLUDE_LABEL=logspout.exclude，容器加--label logspout.exclude=true）。
• 包含：URI中加过滤参数（如filter.name=*_db匹配以_db结尾的容器）。

多目的地转发

逗号分隔多个URI：

bash
docker run \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/gliderlabs/logspout \
  raw://192.168.10.10:5000?filter.name=*_db,syslog+tls://logs.papertrailapp.com:55555?filter.name=*_app

实时查看日志流

通过HTTP流查看：

bash
docker run -d --name="logspout" \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  --publish=127.0.0.1:8000:80 \
  docker.xuanyuan.run/gliderlabs/logspout
curl http://127.0.0.1:8000/logs

自定义路由

通过HTTP API创建路由：

bash
curl $(docker port `docker ps -lq` 8000)/routes \
  -X POST \
  -d '{"source": {"filter": "db", "types": ["stderr"]}, "target": {"type": "syslog", "addr": "logs.papertrailapp.com:55555"}}'

超时检测

设置INACTIVITY_TIMEOUT检测日志流超时：

bash
docker run --name="logspout" \
  -e INACTIVITY_TIMEOUT=1m \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/gliderlabs/logspout

模块

• 内置模块：raw/syslog适配器、tcp/tls/udp传输、httpstream、routesapi。
• 第三方模块：logspout-kafka、logspout-logstash等。

Loggly支持

转发至Loggly：

bash
docker run --name logspout -d --volume=/var/run/docker.sock:/var/run/docker.sock \
  -e SYSLOG_STRUCTURED_DATA="<Loggly API Key>@41058 tag=\"some tag name\"" \
  docker.xuanyuan.run/gliderlabs/logspout \
  syslog+tcp://logs-01.loggly.com:514

许可证

BSD