mclogs

mclogs

mclogs is a fake log generator, heavily inspired on flog ❤️, with a wink to McDonald's, and support for common log formats json and logfmt.

It is useful for testing some tasks which require log data like amazon kinesis log stream test.

Thanks to gofakeit and weightedrand 😘

Installation

Using go get

go get -u github.com/joanlopez/mclogs

Using .tar.gz archive

Download gzip file from Github Releases according to your OS. Then, copy the unzipped executable to under system path.

Using Docker

docker run -it --rm ghcr.io/joanlopez/mclogs

Usage

There are useful options. (mclogs --help)

Options:
  -f, --format string      log format - available formats:
                           - json (default)
                           - logfmt
  -o, --output string      output filename (default "stdout") - path-like is allowed 
  -n, --number integer     number of lines to generate (default "100")
  -b, --bytes integer      size of logs to generate (in bytes)
                           "bytes" will be ignored when "number" is set
  -s, --sleep duration     fix creation time interval for each log (default unit "seconds") - it does not actually sleep
                           examples: 10, 20ms, 5s, 1m
  -d, --delay duration     delay log generation speed (default unit "seconds")
                           examples: 10, 20ms, 5s, 1m
  -a, --at date            date and time -RFC3339- the log generation starts at (default "now")
                           examples: 2023-01-01T15:00:00+02:00
  -w, --overwrite          overwrite the existing log files
  -l, --loop               loop output forever until killed

# Generate 100 lines of logs to stdout
$ mclogs

# Generate 200 lines of logs with a time interval of 10s for each log. It doesn't actually sleep while generating
$ mclogs -s 10s -n 200 

# Generate a log file with 1000 lines of logs, then overwrite existing log file
$ mclogs -n 1000 -o generated.log -w

Supported Formats

• JSON
• Logfmt

Supported Outputs

• Stdout
• File

License

MIT