Skip to main content

A powerful CLI tool that puts log analytics at your fingertips.

Project description

Logria Logo

Logria Python Proof of Concept

A powerful CLI tool that puts log analytics at your fingertips. This is the Python Proof of Concept repository; the main version is written in Rust.


  • Live filtering of data from other processes, replacing grep
  • Use shell commands or files as input, save sessions and come back later
  • Replace regex/filter without killing the process or losing the stream's history
  • Parse logs using user-defined rules, apply analytics methods on top
  • Pure Python, fully type hinted, zero dependencies


There are several options to install this app.

Normal Usage

pip install logria


See Advanced Installation.


There are a few main ways to invoke Logria:

  • Directly:
    • logria
    • Opens to the setup screen
  • With args:
    • logria -e 'tail -f log.txt'
    • Opens a pipe to tail -f log.txt and skips setup
    • logria -h will show the help page with all possible options

For more details, see Sample Usage Session.

Key Commands

Key Command
: command mode
/ regex search
h if regex active, toggle highlighting of matches
i toggle insert mode (default off)
s swap reading stdin and stdout
p activate parser
a toggle analytics mode when parser is active
z deactivate parser
scroll buffer up one line
scroll buffer down one line
skip and stick to end of buffer
skip and stick to beginning of buffer


Here are some of the ways you can leverage Logria:

Live stream of log data


Interactive, live, editable grep


Live log message parsing


Live analytics/statistics tracking


User-defined saved sessions

See session docs.

User-defined saved log parsing methods

See patterns docs.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for Logria, version 0.9.14
Filename, size File type Python version Upload date Hashes
Filename, size Logria-0.9.14-py3-none-any.whl (63.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size Logria-0.9.14.tar.gz (37.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page