gyrt/logflooder

logflooder

镜像概述和主要用途

logflooder是一个轻量级日志生成工具，专为测试场景设计。它能够模拟日志输出，帮助用户测试日志收集、处理和分析系统的功能与性能。通过灵活的参数配置，可控制日志生成的频率、格式和内容，适用于各类日志相关系统的验证场景。

核心功能和特性

• 可配置日志输出频率：支持设置固定延迟（DELAY）和随机延迟（RND），控制日志生成间隔
• 多日志格式支持：提供纯文本（plain）和JSON（json）两种日志格式，满足不同系统需求
• 自定义日志内容：允许指定日志消息（LOG_STRING），未指定时自动生成随机字符串
• 装饰器功能：对纯文本日志可启用装饰器（DECORATE），添加额外上下文信息
• 时区设置：支持自定义时区（TIMEZONE），默认使用UTC时区
• 命名空间支持：可指定Kubernetes命名空间（KUBERNETES_NAMESPACE），默认使用default

使用场景和适用范围

• 测试日志收集系统（如ELK Stack、Promtail+Loki、Fluentd等）的数据接收能力
• 验证日志处理管道的稳定性和容错性
• 模拟高日志量场景，评估系统在负载下的性能表现
• 开发环境中快速生成测试日志，辅助调试日志相关功能模块

使用方法和配置说明

环境变量配置

通过环境变量控制日志生成行为，支持以下配置参数：

Docker部署示例

基本使用（默认配置）

bash
# 每10秒生成一条带装饰器的纯文本随机日志，使用UTC时区和default命名空间
docker run docker.xuanyuan.run/logflooder

自定义配置示例

bash
# 每5秒生成一条JSON格式日志，指定日志内容为"test log"，使用上海时区
docker run -e DELAY=5 -e LOG_TYPE=json -e LOG_STRING="test log" -e TIMEZONE=Asia/Shanghai docker.xuanyuan.run/logflooder

# 固定延迟8秒，随机波动±3秒，禁用装饰器，使用test命名空间
docker run -e DELAY=8 -e RND=3 -e DECORATE=0 -e KUBERNETES_NAMESPACE=test docker.xuanyuan.run/logflooder

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  logflooder:
    image: docker.xuanyuan.run/logflooder
    environment:
      - KUBERNETES_NAMESPACE=monitoring
      - TIMEZONE=Europe/London
      - DELAY=15
      - RND=2
      - LOG_TYPE=plain
      - LOG_STRING="monitoring system test log"
      - DECORATE=1

启动服务：

bash
docker-compose up