NAME

App::JsonLogUtils - Command line utilities for dealing with JSON-formatted log files

VERSION

version 0.01

SYNOPSIS

  tail -f /path/to/log/file.log \
    | jgrep -m message="some pattern" \
    | jcut -f "timestamp priority message" \
    | cols -c "timestamp priority message" -s '|' \
    | column -t -s '|'

DESCRIPTION

Writing logs in JSON, one object per line, makes them very easily machine readable. Wonderful. Unfortunately, it also makes it unfuriating to deal with them using the standard unix command line tools. This package provides a few tools to salve the burn.

TOOLS

jgrep

Greps patterns in individual object fields.

jcut

Filter the fields included in objects.

jcols

Display fields in a format suitable for column.

jshell

An interactive shell for monitoring JSON log files.

FUTURE PLANS

None, but will happily consider requests and patches.

AUTHOR

Jeff Ober <sysread@fastmail.fm>

COPYRIGHT AND LICENSE

This software is copyright (c) 2018 by Jeff Ober.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.