singhgursharan34/logs-generator

Python随机日志生成器镜像文档

镜像概述

本镜像是一个基于Python的轻量级测试应用，核心功能为生成可配置的随机日志数据。通过模拟真实应用的日志输出行为，帮助开发和测试人员验证日志收集、存储、分析及监控告警系统的有效性。

核心功能与特性

• 多级别日志生成：支持生成INFO、WARNING、ERROR三种常见日志级别，模拟不同严重程度的系统事件
• 可配置输出频率：通过参数调整日志生成间隔，支持从高频（毫秒级）到低频（分钟级）的灵活控制
• 自定义日志格式：支持通过环境变量定义日志输出格式，兼容Python logging模块标准格式字符串
• 可控日志总量：可设置生成固定条数的日志或持续无限输出，满足不同测试场景需求
• 轻量部署：基于Python官方 slim镜像构建，镜像体积小，启动速度快，资源占用低

使用场景与适用范围

• 日志收集系统测试：验证ELK Stack（Elasticsearch, Logstash, Kibana）、Promtail+Loki、Fluentd等日志收集管道的完整性
• 日志分析工具验证：测试日志聚合、过滤、检索功能，如Splunk、Graylog等平台的查询性能
• 监控告警规则测试：模拟异常日志（ERROR级别）触发监控系统告警，验证告警阈值与通知机制
• 日志存储容量规划：通过控制日志生成速率和总量，评估日志存储系统的容量需求与性能瓶颈

使用方法与配置说明

快速启动

通过以下命令快速启动默认配置的日志生成器：

bash
docker run -d --name random-logger python-random-log-app

默认行为：生成INFO级别日志，每1秒输出1条，持续无限生成，日志格式为%(asctime)s - %(levelname)s - %(message)s

自定义配置示例

1. 基础参数配置（docker run）

bash
docker run -d --name custom-logger \
  -e LOG_LEVEL=WARNING \          # 日志级别：INFO/WARNING/ERROR（默认INFO）
  -e LOG_INTERVAL=3 \             # 生成间隔：秒（默认1）
  -e LOG_COUNT=100 \              # 日志总量：0为无限（默认0）
  -e LOG_FORMAT="%(asctime)s [%(levelname)s] %(message)s" \  # 自定义格式
  python-random-log-app

2. Docker Compose配置

yaml
version: '3.8'
services:
  log-generator:
    image: python-random-log-app
    container_name: test-logger
    environment:
      - LOG_LEVEL=ERROR
      - LOG_INTERVAL=5
      - LOG_COUNT=0  # 无限生成ERROR级别日志，每5秒1条
    restart: unless-stopped

配置参数说明

日志格式说明

默认日志格式示例：

2023-10-26 15:30:45,123 - INFO - User login attempt from 192.168.1.102
2023-10-26 15:30:46,125 - WARNING - Disk usage exceeds 80% on /var partition
2023-10-26 15:30:47,127 - ERROR - Database connection timeout after 30s

可通过LOG_FORMAT自定义格式，例如：

• 添加进程ID："%(asctime)s [%(process)d] %(levelname)s: %(message)s"
• 简化时间格式："%Y-%m-%d %H:%M:%S %(levelname)s - %(message)s"