stefanprodan/swarm-logspout-logstash

swarm-logspout-logstash

镜像概述

本镜像为Logspout的专用适配器，针对Docker Swarm环境设计，实现容器日志从Swarm集群到Logstash的高效转发，支持日志的集中管理与标准化处理。

核心功能

1. 实时采集Docker Swarm集群内所有容器的日志数据
2. 通过TCP/UDP协议将日志发送至指定Logstash服务
3. 支持解析Docker容器标签，便于日志分类与过滤
4. 可配置资源限制与重启策略，保障服务稳定运行

使用场景

适用于Docker Swarm集群的日志集中管理场景，例如：

• 分散节点容器日志的统一收集需求
• 需通过Logstash将日志转发至Elasticsearch等存储系统进行分析
• 容器日志的标准化处理与监控场景

配置说明

环境变量

• ROUTE_URIS: 指定Logstash接收地址（格式：logstash+tcp://<主机>:<端口> 或 logstash+udp://...）
• LOGSPOUT=ignore: 避免采集镜像自身日志
• HTTP_PORT: 设置HTTP服务端口（默认55444）
• DOCKER_LABELS=on: 开启Docker标签解析功能

卷挂载

• /var/run/docker.sock: 访问Docker API获取日志
• /etc/hostname: 挂载主机名用于日志标识

部署示例（Docker Stack）

yaml
version: "3.3"

services:
  logspout:
    image: stefanprodan/swarm-logspout-logstash
    environment:
      - "ROUTE_URIS=logstash+tcp://localhost:50005"
      - "LOGSPOUT=ignore"
      - "HTTP_PORT=55444"
      - "DOCKER_LABELS=on"
    volumes:
      - /etc/hostname:/etc/host_hostname:ro
      - /var/run/docker.sock:/var/run/docker.sock
    networks:
      - host-net
    deploy:
      mode: global
      restart_policy:
        condition: on-failure
        delay: 10s
        window:5s
      resources:
        limits:
          cpus: '0.10'
          memory:256M
        reservations:
          memory:64M

networks:
  host-net:
    external:
      name: "host"

Logstash Pipeline配置示例

input {
  udp {
    port  =>50005
    codec => json
  }
  tcp {
    port  =>50005
    codec => json
  }
}

output {
  elasticsearch {
    hosts => ["es1:9200", "es2:9200", "es3:9200"]
  }
}