chenulu/node-tinyapp

随机日志生成器镜像文档

镜像概述和主要用途

本镜像包含一个轻量级应用，核心功能是随机生成并打印日志行。它旨在模拟实际应用的日志输出场景，帮助用户测试日志收集工具、验证日志分析平台功能或演示日志处理流程。镜像体积小巧，部署简单，支持灵活配置以满足不同测试需求。

核心功能和特性

• 随机日志内容：自动生成多样化的日志文本，模拟真实应用的日志输出特点
• 可配置日志频率：支持自定义日志生成间隔，控制日志输出速度
• 多日志级别支持：可生成不同级别（INFO、WARN、ERROR、DEBUG等）的日志
• 轻量级设计：基于精简基础镜像构建，资源占用低，启动速度快
• 灵活配置：通过环境变量轻松调整日志生成参数，无需修改代码

使用场景和适用范围

• 日志收集工具测试：验证ELK Stack、Fluentd、Logstash等日志收集系统的采集能力
• 日志分析平台验证：测试日志分析工具对不同日志格式、频率的处理能力
• 日志处理流程演示：在培训或演示中模拟日志生成，展示日志从产生到分析的完整流程
• 开发环境日志模拟：在缺少真实应用日志时，为开发环境提供模拟日志数据
• 性能测试辅助：通过调整日志生成频率，测试日志系统在高负载下的表现

使用方法和配置说明

基本使用（Docker Run）

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

bash
docker run --name random-logger [镜像名称]

自定义配置示例

可通过环境变量调整日志生成参数，例如：

bash
docker run --name random-logger \
  -e LOG_INTERVAL=2 \          # 日志生成间隔（秒），默认1秒
  -e LOG_LEVEL=INFO,WARN,ERROR \ # 日志级别，多个级别用逗号分隔，默认INFO
  -e LOG_COUNT=100 \           # 生成日志总行数，默认无限
  -e LOG_TEMPLATE="[{LEVEL}] {TIMESTAMP} - {MESSAGE}" \ # 日志模板，默认内置模板
  [镜像名称]

Docker Compose 配置示例

在docker-compose.yml中集成：

yaml
version: '3'
services:
  random-logger:
    image: docker.xuanyuan.run/[镜像名称]
    environment:
      - LOG_INTERVAL=3
      - LOG_LEVEL=DEBUG,INFO,WARN
      - LOG_TEMPLATE="[{LEVEL}] {DATE} {TIME} - User {RANDOM_ID}: {MESSAGE}"
    restart: unless-stopped

环境变量配置说明

查看日志

容器运行后，可通过以下命令查看生成的日志：

bash
docker logs -f random-logger

注意事项

• 若未指定LOG_COUNT，容器将持续生成日志直至手动停止
• 日志模板中的变量需使用大括号{}包裹，不支持自定义未列出的变量
• 高频率日志生成（如LOG_INTERVAL小于0.1秒）可能会增加容器资源占用，建议根据测试需求合理配置