fblog
cargo install fblog

fblog

Small command-line JSON Log viewer

by brocode

2.3.0 (see all)License:WTFPL
cargo install fblog
Readme

[[./logo/fblog_small.png]]

* fblog

[[https://crates.io/crates/fblog\]\[file:https://img.shields.io/crates/v/fblog.svg\]\]
[[https://travis-ci.org/brocode/fblog\]\[file:https://travis-ci.org/brocode/fblog.svg?branch=master\]\]

A small tool to view json log files.

[[file:demo.png]]

** Filter
To filter log messages it is possible to use lua

#+BEGIN_SRC shell-script
fblog -f 'level ~= "info"' # will print all message where the level is not info
fblog -f 'process == "play"' # will print all message where the process is play
fblog -f 'string.find(fu, "bow.*") ~= nil' # will print all messages where fu starts with bow
fblog -f 'process == "play"' # will print all message where the process is play
fblog -f 'process == "rust" and fu == "bower"'
fblog --no-implicit-filter-return-statement -f 'if 3 > 2 then return true else return false end'

# not valid lua identifiers
fblog -d -f '_G["log.level"] == "WARN"' sample_elastic.log
#+END_SRC

** Customize
~fblog~ tries to detect the message, severity and timestamp of a log
entry. This behavior can be customized. See ~--help~ for more
information.

You can customize fblog messages:
Format output:
#+BEGIN_SRC shell-script
fblog -p --main-line-format "{{#if short_message}}{{ red short_message }}{{/if}}" sample.json.log
#+END_SRC

The following sanitized variables are provided by fblog:

* fblog_timestamp
* fblog_level
* fblog_message
* fblog_prefix

For the default formatting see ~--help~

handlebar helpers:

* bold
* yellow
* red
* blue
* purple
* green
* color_rgb 0 0 0
* uppercase
* level_style
* fixed_size 10

** NO_COLOR
~fblog~ disables color output if the ~NO_COLOR~ environment variable is present.

[[https://no-color.org/\]\[no-color\]\]

** Installation
#+BEGIN_SRC bash
cargo install fblog
#+END_SRC

If you need a deb or rpm package have a look at [[https://github.com/brocode/fblog/releases\]\[fblog releases]]

If you're lucky enough to be an arch linux user: [[https://aur.archlinux.org/packages/fblog/\]\[AUR\]\]

GitHub Stars

170

LAST COMMIT

8mos ago

MAINTAINERS

1

CONTRIBUTORS

10

OPEN ISSUES

2

OPEN PRs

0
VersionTagPublished
2.3.0
2yrs ago
2.2.0
2yrs ago
2.1.0
2yrs ago
2.0.1
2yrs ago
No alternatives found
No tutorials found
Add a tutorial