aptible/joecool

Docker容器日志转发至Logstash的代理镜像

镜像概述

该镜像提供一个轻量级代理服务，专门用于捕获Docker容器生成的日志，并将其实时转发至Logstash实例。通过该代理，用户可实现Docker环境中容器日志的集中化收集、标准化处理和后续分析，是构建ELK（Elasticsearch, Logstash, Kibana）日志管理栈的关键组件之一。

核心功能与特性

• 实时日志转发：持续监控Docker容器日志输出，实时推送至Logstash
• 原生Docker集成：通过Docker API或日志驱动捕获容器日志，支持标准Docker日志格式
• Logstash兼容：支持Logstash常用输入协议（如TCP、UDP、Beats），可无缝对接Logstash管道
• 轻量级设计：镜像体积小，资源占用低，适合在容器化环境中部署
• 配置灵活：支持通过环境变量或配置文件自定义日志格式、转发目标和过滤规则

使用场景

• Docker容器集群的日志集中管理
• ELK栈中容器日志的前置收集环节
• 需要实时日志分析的微服务架构
• 容器化应用的故障排查与审计日志收集

使用方法

基本运行命令

bash
docker run -d \
  --name logstash-forwarder \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e LOGSTASH_HOST=logstash.example.com \
  -e LOGSTASH_PORT=5044 \
  -e LOG_FORMAT=json \
  your-image-name:latest

Docker Compose配置示例

yaml
version: '3'
services:
  log-forwarder:
    image: your-image-name:latest
    container_name: logstash-forwarder
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - LOGSTASH_HOST=logstash
      - LOGSTASH_PORT=5044
      - LOG_FORMAT=json
      - FILTER_LABEL=log-collect=true  # 仅转发带有该标签的容器日志
    depends_on:
      - logstash

  logstash:
    image: docker.elastic.co/logstash/logstash:8.11.3
    # Logstash配置省略...

环境变量配置说明

注意事项

1. 需挂载Docker socket（/var/run/docker.sock）以获取容器日志权限
2. 确保Logstash实例已配置相应的输入插件（如beats或tcp）接收日志
3. 对于大规模容器环境，建议配置日志过滤规则（通过FILTER_LABEL或FILTER_NAME）减少不必要的日志传输
4. 生产环境中建议设置资源限制，避免代理服务占用过多主机资源

高级配置

如需自定义日志过滤规则或输出格式，可通过挂载配置文件实现：

bash
docker run -d \
  --name logstash-forwarder \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /path/to/custom/config.yml:/etc/forwarder/config.yml \
  your-image-name:latest

配置文件格式及参数说明请参考镜像官方文档。