jbenninghoff/rsyslog-forwarder

rsyslog-forwarder

镜像概述和主要用途

rsyslog-forwarder是一个轻量级的rsyslog Docker镜像，专门优化用于日志的接收、解析和转发。它基于rsyslog构建，提供简单易用的日志处理功能，可帮助用户标准化和集中管理来自不同来源的日志数据。

核心功能和特性

• 轻量级设计：镜像体积小，资源占用低，适合在容器环境中快速部署
• 日志解析能力：支持标准syslog解析，可对日志进行结构化处理
• 多协议支持：默认支持UDP（514端口）和TCP（***端口）接收日志
• 灵活配置：允许通过挂载自定义rsyslog配置文件实现个性化日志处理需求
• 日志转发：可将解析后的日志转发到 stdout 或其他日志系统

使用场景和适用范围

• 作为集中式日志收集点，接收来自多个应用或设备的syslog日志
• 对非标准格式的syslog日志进行标准化处理
• 在容器化环境中构建简单的日志转发层
• 开发或测试环境中的日志调试和查看

使用方法和配置说明

快速启动（docker run）

通过以下命令启动容器，将接收到的syslog日志（514/udp）输出到stdout：

bash
docker run --rm -it -p 514:514/udp --name forwarder jbenninghoff/rsyslog-forwarder

使用docker-compose部署

如需使用自定义配置进行日志解析和转发，可通过docker-compose实现：

1. 创建工作目录并获取默认配置文件：

bash
mkdir ~/forwarder
cd ~/forwarder
wget https://raw.githubusercontent.com/jabenninghoff/rsyslog-forwarder/master/etc/rsyslog.conf

2. 创建docker-compose.yml文件：

yaml
version: '3'
services:
  forwarder:
    image: jbenninghoff/rsyslog-forwarder
    volumes:
      - ~/forwarder/rsyslog.conf:/etc/rsyslog.conf  # 挂载自定义配置文件
    ports:
      - 514:514/udp    # UDP syslog端口
      - 10514:10514/tcp  # TCP syslog端口

3. 启动服务：

bash
docker-compose up -d

配置说明

• 端口映射：默认使用514/udp和***/tcp端口接收日志，可根据需求调整端口映射
• 配置文件：通过挂载/etc/rsyslog.conf文件自定义日志解析规则和转发目标，具体配置语法可参考rsyslog官方文档
• 日志输出：默认配置将日志输出到stdout，可通过修改配置文件实现转发到其他日志系统（如ELK、Splunk等）