Skip to main content
Archived

This project has been archived by its maintainers, and is no longer receiving any updates.

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.

tl;dr

  • 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

Installation

There are several options to install this app.

Normal Usage

pip install logria

Development

See Advanced Installation.

Usage

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

Features

Here are some of the ways you can leverage Logria:

Live stream of log data

logria

Interactive, live, editable grep

regex

Live log message parsing

parser

Live analytics/statistics tracking

analytics

User-defined saved sessions

See session docs.

User-defined saved log parsing methods

See patterns docs.

Metadata

Release files for Logria 0.9.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Logria 0.9.14
File Size Uploaded
Logria-0.9.14.tar.gz 37.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for Logria 0.9.14
File Interpreter ABI Platform
Logria-0.9.14-py3-none-any.whl Python 3 none any Details

Total release size: 101.0 kB

Release files / Logria-0.9.14.tar.gz

Download URL Logria-0.9.14.tar.gz
Size 37.5 kB
Tags Source
SHA-256 checksum
How to use checksums
96e47e420d8039e617b43c0ce987755535e12c9004264e4f6a9da60c9530f404
BLAKE2b-256 checksum
How to use checksums
0fa1a7ff1fd8aaddb631b077c87f8b707da2ba97496cf9c5d68dd33232245d4f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.9.0

Release files / Logria-0.9.14-py3-none-any.whl

Download URL Logria-0.9.14-py3-none-any.whl
Size 63.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b6cc6ad56bf4a868c2bf567478281917717488537ce6fbc4362443f5abc62a7a
BLAKE2b-256 checksum
How to use checksums
87d046b3d32b65b0408f49dba1bf1b77a7068e883f842ee3bdd9f1718a8c1d8e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.9.0
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page