ubnt/unms-fluentd

Fluentd for UNMS 镜像文档

镜像概述

本镜像为Ubiquiti网络管理系统(UNMS)提供专用的Fluentd日志收集解决方案，旨在简化UNMS环境中的日志管理流程。通过预配置的日志收集规则，实现对UNMS系统日志、设备监控数据及网络事件日志的集中采集、过滤与转发，助力网络管理员高效进行日志分析与故障排查。

核心功能与特性

• UNMS日志适配：针对UNMS系统架构优化的日志解析规则，支持收集UNMS服务器日志、网络设备事件日志及性能指标数据
• 灵活的日志处理：内置日志过滤、格式化与转换功能，可根据需求自定义日志处理逻辑
• 多目标输出支持：兼容主流日志存储与分析平台（如Elasticsearch、Amazon S3、Splunk、Syslog服务器等）
• 轻量级部署：基于官方Fluentd镜像构建，体积小巧，资源占用低，适合与UNMS容器化环境集成
• 配置持久化：支持通过外部挂载自定义Fluentd配置文件，实现配置复用与动态更新

使用场景

• UNMS单机或集群部署环境的集中式日志管理
• 网络设备状态监控与异常事件告警
• 网络运行数据分析与性能优化
• 合规性日志留存与审计（满足网络运营合规要求）
• 与SIEM系统联动构建网络安全监控体系

使用方法

基础部署（Docker Run）

bash
docker run -d \
  --name unms-fluentd \
  --restart always \
  --network unms-network \  # 需与UNMS容器在同一网络
  -v /path/to/unms/logs:/var/log/unms:ro \  # 挂载UNMS日志目录（只读）
  -v /path/to/fluentd/config:/fluentd/etc \  # 挂载自定义配置文件
  -e FLB_LOG_LEVEL=info \  # 日志级别：debug/info/warn/error
  ubnt/fluentd-unms:latest

Docker Compose配置示例

yaml
version: '3'
services:
  unms-fluentd:
    image: ubnt/fluentd-unms:latest
    container_name: unms-fluentd
    restart: always
    networks:
      - unms-net
    volumes:
      - /opt/unms/logs:/var/log/unms:ro
      - ./fluentd/conf:/fluentd/etc
    environment:
      - FLB_LOG_LEVEL=info
      - OUTPUT_ELASTICSEARCH_HOST=elasticsearch
      - OUTPUT_ELASTICSEARCH_PORT=9200

networks:
  unms-net:
    external: true  # 假设已存在UNMS主网络

核心配置说明

1. 日志源配置（fluent.conf示例）

conf
# 收集UNMS系统日志
<source>
  @type tail
  path /var/log/unms/unms.log
  tag unms.system
  <parse>
    @type regexp
    expression /^(?<time>\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}) \[(?<level>\w+)\] (?<message>.+)$/
  </parse>
</source>

# 收集网络设备事件日志
<source>
  @type tail
  path /var/log/unms/devices/*.log
  tag unms.device
  <parse>
    @type json  # UNMS设备日志默认JSON格式
  </parse>
</source>

2. 日志输出配置示例（输出到Elasticsearch）

conf
<match unms.**>
  @type elasticsearch
  host "#{ENV['OUTPUT_ELASTICSEARCH_HOST']}"
  port "#{ENV['OUTPUT_ELASTICSEARCH_PORT']}"
  index_name "unms-logs-%Y%m%d"
  <buffer>
    @type memory
    flush_interval 5s
  </buffer>
</match>

环境变量说明

注意事项

• 确保容器与UNMS服务处于同一网络，或能访问UNMS日志文件路径
• 生产环境建议通过--user参数指定非root用户运行容器，增强安全性
• 大规模部署时建议配置日志缓冲机制（如buffer插件）避免数据丢失
• 自定义配置文件需遵循Fluentd配置语法，详细规则参考Fluentd官方文档