Gluster Rsyslog Docker容器文档

镜像概述和主要用途

本Docker容器基于Alpine Linux构建，运行rsyslog服务并集成特定配置与规则库，专门用于解析Gluster生态系统中的日志文件。其核心用途是对Gluster特定日志（尤其是GD2日志）进行标准化处理，随后将标准化后的日志数据馈送到Elasticsearch服务，以实现日志的集中搜索、分析及可视化。该容器设计为轻量级，适用于作为gcs（Gluster Container Storage）集群中的sidecar容器，与运行GD2（Glusterd2）的容器协同工作。

核心功能和特性

• rsyslog服务运行：提供稳定的日志收集与处理能力，支持Gluster日志的实时解析。
• 专用日志解析规则：内置针对Gluster日志文件的定制化配置和规则库，实现日志结构化解析。
• 日志标准化处理：将非结构化的Gluster日志转换为标准化格式，便于后续对接Elasticsearch等分析平台。
• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低，适合容器化部署环境。
• Sidecar容器适配：可无缝集成到gcs集群中，作为辅助容器与GD2容器协同运行，实现日志处理与业务容器解耦。
• GD2日志支持：当前已实现对GD2（Glusterd2）日志文件的标准化处理。

使用场景和适用范围

使用场景

• 部署于gcs（Gluster Container Storage）集群环境，作为sidecar容器与GD2容器配合运行，负责Gluster日志的收集、解析与标准化。
• 需将Gluster日志数据馈送到Elasticsearch，以实现日志集中搜索、实时分析及可视化展示的场景。

适用范围

• 基于容器化部署的Gluster存储系统（如gcs集群）。
• 需要对Gluster日志进行结构化处理和集中管理的运维或开发场景。

使用方法和配置说明

基本运行方式

需通过挂载Gluster日志目录到容器内，并配置Elasticsearch连接参数，确保rsyslog服务能正常访问日志文件并将处理后的数据发送至目标服务。

示例docker run命令（需根据实际环境调整参数）

docker run -d \
  --name gluster-rsyslog \
  -v /path/to/gluster/logs:/var/log/gluster \  # 挂载宿主机Gluster日志目录到容器内
  -e ELASTICSEARCH_HOST=es.example.com \       # Elasticsearch主机地址
  -e ELASTICSEARCH_PORT=9200 \                 # Elasticsearch服务端口
  gluster-rsyslog:latest                       # 镜像名称及标签

配置说明

关键挂载点

• /var/log/gluster：容器内默认的Gluster日志文件路径，需将宿主机的Gluster日志目录挂载至此，确保rsyslog能读取日志文件。

环境变量（示例）

• ELASTICSEARCH_HOST：目标Elasticsearch服务的主机地址，用于指定日志数据发送的目标地址。
• ELASTICSEARCH_PORT：Elasticsearch服务的端口号（默认9200）。

自定义配置

如需调整rsyslog解析规则或Elasticsearch对接参数，可通过挂载自定义rsyslog配置文件覆盖容器内默认配置（默认配置路径通常为/etc/rsyslog.d/）。例如：

docker run -d \
  --name gluster-rsyslog \
  -v /path/to/custom/rsyslog.conf:/etc/rsyslog.d/gluster.conf \  # 挂载自定义规则文件
  -v /path/to/gluster/logs:/var/log/gluster \
  -e ELASTICSEARCH_HOST=es.example.com \
  gluster-rsyslog:latest