philipgough/rsyslog

rsyslog-container 镜像文档

镜像概述

rsyslog-container是一个轻量级的日志收集镜像，基于Red Hat UBI 8构建，集成了rsyslog服务。该镜像的核心设计目标是将收集到的日志统一输出到标准输出(stdout)，符合容器化环境下日志管理的最佳实践，便于与Docker日志驱动（如json-file、journald）或集中式日志系统（如ELK、Promtail）集成。

核心功能与特性

• 轻量级基础：基于UBI 8最小化镜像构建，体积小，资源占用低
• 标准输出日志：默认配置将所有日志输出到stdout，简化容器日志收集流程
• rsyslog核心功能：支持日志过滤、转发、格式转换等rsyslog原生功能
• 容器友好：适配容器化部署模式，支持通过挂载配置文件自定义日志处理规则

使用场景

• 容器化应用的日志集中收集与转发
• 微服务架构中多实例日志的统一管理
• 需要将应用日志接入Docker日志驱动或外部日志系统的场景
• 开发环境中快速搭建日志收集测试环境

使用方法

基本使用

通过以下命令启动默认配置的rsyslog容器：

bash
docker run -d --name rsyslog philipgough/rsyslog-container:latest

查看日志

容器日志默认输出到stdout，可通过Docker日志命令查看：

bash
docker logs rsyslog

自定义配置

如需自定义rsyslog配置，可通过挂载本地配置文件覆盖容器内默认配置：

bash
docker run -d --name rsyslog \
  -v /path/to/your/rsyslog.conf:/etc/rsyslog.conf \
  philipgough/rsyslog-container:latest

Docker Compose 示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  rsyslog:
    image: philipgough/rsyslog-container:latest
    container_name: rsyslog
    volumes:
      - ./rsyslog.conf:/etc/rsyslog.conf  # 可选：挂载自定义配置
    restart: unless-stopped
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

启动服务：

bash
docker-compose up -d

配置说明

默认配置

容器默认使用以下rsyslog配置（/etc/rsyslog.conf）：

module(load="imuxsock")  # 接收本地系统日志
module(load="imjournal" StateFile="imjournal.state")  # 接收journal日志

*.info;mail.none;authpriv.none;cron.none                action(type="omfile" file="/dev/stdout")

该配置将info级别及以上的日志（排除mail、authpriv、cron）输出到stdout。

自定义配置建议

如需扩展功能，可在自定义配置中添加：

• 日志转发：通过action(type="omfwd")配置将日志转发到远程日志服务器
• 日志过滤：使用if条件语句实现复杂的日志过滤规则
• 格式转换：通过template定义日志输出格式

详细配置可参考rsyslog官方文档。