infrabuilder/log-to-stdout

docker-log-to-stdout 镜像文档

镜像概述

docker-log-to-stdout是一个基于Filebeat的Docker镜像，主要功能是监控容器内/var/log目录下的日志文件，并将日志内容输出到标准输出(stdout)。该镜像旨在简化容器日志收集流程，符合Docker日志最佳实践，便于与各类日志管理系统集成。

核心功能与特性

• 日志收集：使用Filebeat作为日志收集引擎，可靠监控/var/log目录下的日志文件
• 标准输出：将收集到的日志统一输出到stdout，符合Docker日志收集规范
• 轻量级：基于精简基础镜像构建，资源占用低
• 易于集成：可直接与Docker日志驱动、ELK Stack、Promtail等日志系统配合使用
• 自动发现：支持对/var/log目录下新增日志文件的自动监控

使用场景与适用范围

• 容器化应用需要集中收集系统日志或应用日志的场景
• 需符合Docker日志最佳实践，将日志输出到stdout的环境
• 与日志聚合工具（如ELK、Grafana Loki）配合构建日志监控系统
• 容器内应用日志默认输出到/var/log目录而未直接输出到stdout的场景

使用方法与配置说明

基本使用（docker run）

通过挂载主机或容器内的/var/log目录，启动镜像即可开始日志收集：

bash
docker run -v /path/to/host/logs:/var/log docker-log-to-stdout

参数说明：

• -v /path/to/host/logs:/var/log：将主机日志目录挂载到容器内的/var/log，实现日志文件共享

Docker Compose配置

在docker-compose.yml中集成该镜像：

yaml
version: '3'
services:
  log-collector:
    image: docker-log-to-stdout
    volumes:
      - /var/log:/var/log  # 挂载主机日志目录
    restart: always  # 确保服务持续运行

自定义配置

环境变量

可通过环境变量调整日志收集行为：

示例：自定义日志路径

监控/var/log/app目录下的所有.log文件：

bash
docker run -v /var/log/app:/var/log/app -e LOG_PATH="/var/log/app/*.log" docker-log-to-stdout

示例：使用自定义Filebeat配置

将自定义Filebeat配置文件编码为Base64后通过环境变量传入：

bash
# 将本地配置文件转换为Base64
ENCODED_CONFIG=$(cat custom-filebeat.yml | base64 -w 0)

# 启动容器
docker run -v /var/log:/var/log -e FILEBEAT_CONFIG="$ENCODED_CONFIG" docker-log-to-stdout

注意事项

• 确保挂载的日志目录具有可读权限，避免Filebeat无法访问日志文件
• 对于轮转日志文件，Filebeat会自动跟踪文件变化，无需额外配置
• 如需收集容器内应用日志而非主机日志，应确保应用日志输出到容器内的/var/log目录