adopteunops/logspout-logstash

logspout-logstash

镜像概述

这是一个轻量级的Logspout适配器镜像，用于将Docker容器日志通过UDP或TCP协议发送到Logstash服务。它是looplab/logspout-logstash项目的托管可用版本，帮助用户快速实现容器日志的集中收集与处理。

核心功能

1. 支持UDP和TCP两种协议向Logstash转发容器日志
2. 直接读取Docker Socket获取容器日志数据
3. 通过环境变量灵活配置Logstash的连接地址
4. 轻量级设计，资源占用低，适合容器化部署

使用场景

1. Docker容器集群的日志集中管理场景
2. 微服务架构下多容器日志的统一分析需求
3. 需要将容器日志接入Elasticsearch生态系统（Logstash+Elasticsearch+Kibana）的场景

配置说明

• 环境变量：
  ROUTE_URIS：指定Logstash的连接URI，格式为logstash://<host>:<port>（例如logstash://logstash:5000）
• 挂载卷：
  必须挂载/var/run/docker.sock到容器内，以读取Docker容器日志

部署示例

Docker Compose配置

yaml
version: "2"
services:
  logspout:
    image: bekt/logspout-logstash
    restart: on-failure
    environment:
      ROUTE_URIS: logstash://logstash:5000
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

  logstash:
    image: logstash:2.3
    command: -f /opt/logstash/sample.conf
    volumes:
      - ./logstash/:/opt/logstash

  # 示例服务：Redis（实际场景替换为你的业务服务）
  redis:
    image: redis
    restart: always

Logstash配置示例（logstash/sample.conf）

conf
input {
  udp {
    port  => 5000
    codec => json
  }
}

filter {
  # 过滤Logstash自身的日志
  if [docker][image] =~ /^logstash/ {
    drop { }
  }
}

output {
  # 输出到Elasticsearch
  elasticsearch {
    hosts => ["localhost:9200"]
  }
  # 控制台输出（调试用）
  stdout { codec => rubydebug }
}