A small command-line tool to view and filter JSON log files with customizable formatting and Lua-based filtering.
fblog is a command-line JSON log viewer that parses structured log files, applies filters, and formats output for easy reading. It solves the problem of inspecting verbose JSON logs by providing colorized, customizable views and Lua-based filtering.
Developers and DevOps engineers working with JSON-based logging systems, especially in containerized environments like Kubernetes.
It offers a lightweight, pipe-friendly alternative to bulky log viewers, with powerful Lua filtering and customization without requiring complex setup.
Small command-line JSON Log viewer
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Enables complex log filtering with Lua expressions, supporting nested fields and arrays, as shown in README examples like filtering by level or process names.
Uses Handlebars-like templates with color helpers (e.g., bold, red, level_style), allowing tailored log displays, demonstrated with the --main-line-format option.
Designed for Unix-style workflows, easily piping from tools like kubectl or tail, making it ideal for containerized environments, as highlighted in the log tailing section.
Supports custom log level mappings via a TOML config file, accommodating various standards like Bunyan levels, as detailed in the configuration section.
Requires external commands for real-time log following, as admitted in the README: 'fblog does not support native log tailing but this is easily achievable' with pipes.
Filtering capabilities depend on Lua knowledge, which may be a barrier for users unfamiliar with the language, despite the provided examples and --print-lua helper.
Only parses structured JSON logs; non-JSON logs need preprocessing or aren't handled, restricting its use case to applications with JSON-based logging.