Forza/logparse
Forza/logparse
1
1
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Logparse is a shell script that parses Caddy's JSON log files and outputs them as formatted text. https://wiki.tnonline.net/w/Linux/logparse
4 Commits 1 Branch 0 Tags 54 KiB
Shell 100%
main
Go to file
Forza 40dc4c2e3c Add missing identity position for Common and Combined formats
2024-10-08 20:50:37 +02:00
examples Initial release 2024-05-27 22:09:15 +02:00
LICENSE Initial commit 2024-05-26 22:57:15 +02:00
logparse Add missing identity position for Common and Combined formats 2024-10-08 20:50:37 +02:00
README.md Update README.md 2024-05-27 22:15:45 +02:00

README.md

logparse

Logparse is a shell script that parses Caddy JSON log files and outputs them as formatted text. It supports the Common Log Format and Combined Log Format, usually used by traditional HTTP servers like Apache, however it is easy to customise the output using the --selector option.

The config file allows for changing default output format, add additional selectors and adapt logparse to other JSON sources. Logparse uses the powerful jq tool to process the JSON files.

Requirements

  • Bash 5.1: Logparse is using associative arrays which is not available in plain POSIX shell scripts.
  • jq 1.7: Tested with jq 1.7.1.

Usage

Usage: /usr/bin/logparse [-c | -C | -s "selectors"] [-F <config_file>] filename
Options:
  -c, --common       Apache Common Log Format (default)
  -C, --combined     Apache Combined Log Format
  -s, --selector     Use a space separated list of selectors
  -F, --config-file  Use a configuration file
  -h, --help         Show this help message and exit

Examples

Example usage and descriptions is available on the wiki https://wiki.tnonline.net/w/Linux/logparse