Aioli Logger Docker镜像文档

1. 镜像概述

Aioli Logger是一款轻量级日志管理工具的Docker镜像，旨在简化应用程序日志的收集、处理与分析流程。该镜像封装了日志采集、格式转换、过滤分析等核心功能，适用于各类应用场景的日志管理需求，尤其适合资源受限环境或需要快速集成日志功能的系统。

2. 核心功能和特性

2.1 多格式日志支持

• 兼容常见日志格式：JSON、CSV、纯文本、Apache日志格式、Nginx日志格式等
• 支持自定义日志格式解析规则，适配特定业务场景的日志格式

2.2 高效日志处理

• 实时日志收集：支持从文件、标准输出（stdout/stderr）、网络端口等多源采集日志
• 日志过滤与分析：可按关键词、级别（INFO/WARN/ERROR等）、时间范围等条件过滤日志
• 日志聚合：支持多应用实例日志集中汇总，便于全局分析

2.3 轻量级设计

• 低资源占用：镜像体积小（<50MB），运行时CPU/内存消耗低，适合边缘设备及轻量环境
• 无依赖部署：无需额外组件，通过Docker容器即可独立运行

2.4 易集成与扩展

• 支持与监控工具集成（如Prometheus、Grafana），提供日志指标可视化
• 可通过配置文件自定义输出目标（本地文件、远程服务器、消息队列等）

3. 使用场景和适用范围

3.1 开发环境

• 应用程序日志实时调试，快速定位开发阶段的代码问题
• 多服务本地联调时，集中查看各服务日志流

3.2 生产环境

• 小型应用日志监控：替代复杂日志系统（如ELK Stack），降低运维成本
• 边缘计算场景：在资源受限的边缘设备上实现基础日志管理

3.3 多应用日志管理

• 微服务架构中，集中收集各微服务实例日志，简化跨服务问题排查
• 容器集群环境（如Kubernetes）中，作为Sidecar容器采集应用日志

4. 使用方法和配置说明

4.1 基本使用（Docker Run）

通过以下命令快速启动Aioli Logger容器，采集本地文件日志：

docker run -d \
  --name aioli-logger \
  -v /path/to/local/logs:/app/logs:ro \  # 挂载本地日志目录（只读）
  -e LOG_SOURCE=/app/logs \             # 指定日志源路径
  -e OUTPUT_FORMAT=json \               # 设置输出格式（支持json/text/csv）
  -e LOG_LEVEL=info \                   # 设置日志级别过滤（info/warn/error）
  aioli-logger:latest

4.2 环境变量配置

Aioli Logger支持通过环境变量自定义配置，常用参数如下：

4.3 Docker Compose配置示例

以下是与应用服务联动的docker-compose.yml示例，实现应用日志自动采集：

version: '3'
services:
  app:
    image: your-app:latest
    volumes:
      - app-logs:/app/logs  # 应用日志挂载到命名卷
    # 应用其他配置...

  aioli-logger:
    image: aioli-logger:latest
    volumes:
      - app-logs:/app/logs:ro  # 共享应用日志卷（只读）
    environment:
      - LOG_SOURCE=/app/logs
      - OUTPUT_FORMAT=json
      - LOG_LEVEL=warn
      - OUTPUT_DEST=tcp://monitoring-server:5000  # 输出到远程监控服务器
    depends_on:
      - app

volumes:
  app-logs:  # 命名卷用于共享日志

4.4 自定义配置文件

若需更复杂的配置（如自定义日志解析规则），可通过挂载配置文件覆盖默认配置：

1. 本地创建配置文件logger-config.yaml：

logSources:
  - path: /app/logs/app.log
    format: json  # 指定该路径日志格式为JSON
  - path: /app/logs/access.log
    format: apache  # 指定为Apache日志格式
output:
  format: csv
  destination: file:///app/output/logs.csv
filter:
  levels: [warn, error]
  keywords: ["timeout", "error"]

2. 通过Docker Run挂载配置文件：

docker run -d \
  --name aioli-logger \
  -v /path/to/local/logs:/app/logs:ro \
  -v /path/to/logger-config.yaml:/app/config.yaml \
  aioli-logger:latest --config /app/config.yaml

5. 注意事项

• 挂载日志目录时建议设置为只读（:ro），避免容器意外修改源日志文件
• 生产环境中建议通过OUTPUT_DEST将日志输出到持久化存储或监控系统，避免容器销毁导致日志丢失
• 对于高并发日志场景，可适当调整POLL_INTERVAL参数（如设为1秒）以提高采集实时性