Skip to content

Fake HTTP log generator module, test if your monitor system can survive under the log spikes.

License

Notifications You must be signed in to change notification settings

xuwenyihust/lunaticlog

Repository files navigation

Python PyPI version Travis Coverage Status Percentage of issues still open license

Lunaticlog: Fake Log Generator - Read The Docs

Lunaticlog is a mock HTTP log generator package, use it's fake log workloads to test if your monitor / analyzer can survive various extreme conditions.

Documentation

Lunaticlog's documentation can be found on https://xuwenyihust.github.io/lunaticlog/lunaticlog/html/.

Overview

Lunaticlog can generate logs with customized contents. The log traffic can also be configured.

Supported Log Format

What kinds of log formats does it support now?

  • Apache Access Log

    127.0.0.1 user-identifier frank [10/Oct/2000:13:55:36 -0700] "GET /apache_pb.gif HTTP/1.0" 200 2326

  • [TODO] Nginx Access Log

    123.65.150.10 - - [23/Aug/2010:03:50:59 +0000] "POST /wordpress3/wp-admin/admin-ajax.php HTTP/1.1" 200 2 "http://www.example.com/wordpress3/wp-admin/post-new.php" "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_6_4; en-US) AppleWebKit/534.3 (KHTML, like Gecko) Chrome/6.0.472.25 Safari/534.3"

  • [TODO] Amazon S3 Log

    79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be mybucket [06/Feb/2014:00:00:38 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be 3E57427F3EXAMPLE REST.GET.VERSIONING - "GET /mybucket?versioning HTTP/1.1" 200 - 113 - 7 - "-" "S3Console/0.4" -

Log Rotation

Set attribute rotation_size to rotate logs when current log file achieves the max size.

Log Generation Mode

The fate of lunaticlog is to create chaos to test your system. So it needs to generate various extreme cases, such as sudden traffic spikes.

What traffic modes are supported now?

  • uniform

    Generate logs at a random rate, which is uniformly distributed.

  • push

    Generate logs at highest speed(which can be configured).

  • spike

    Generate logs at sudden very high rates periodically.

The scripts to plot these bandwidth charts can be found under ./scripts.

Output Formats

  • STDOUT

  • .log file

  • .gz file

Install

pip install lunaticlog

Usage Example

apache_gen Class

Instantiation

from lunaticlog import apache_gen

log_gen = apache_gen(out_path='./apache.log', mode='uniform', rotation=True)
log_gen.run()

Arguments

  • out_path: path of output logs

  • out_format: format of output logs

  • mode: log traffic mode

License

See the LICENSE file for license rights and limitations (MIT).

About

Fake HTTP log generator module, test if your monitor system can survive under the log spikes.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages