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.

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.

Project details


Download files

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

Source Distribution

Logria-0.9.14.tar.gz (37.5 kB view details)

Uploaded Source

Built Distribution

Logria-0.9.14-py3-none-any.whl (63.5 kB view details)

Uploaded Python 3

File details

Details for the file Logria-0.9.14.tar.gz.

File metadata

  • Download URL: Logria-0.9.14.tar.gz
  • Upload date:
  • Size: 37.5 kB
  • Tags: Source
  • Uploaded using 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

File hashes

Hashes for Logria-0.9.14.tar.gz
Algorithm Hash digest
SHA256 96e47e420d8039e617b43c0ce987755535e12c9004264e4f6a9da60c9530f404
MD5 1900035376ca996daa9c15ab77d4626e
BLAKE2b-256 0fa1a7ff1fd8aaddb631b077c87f8b707da2ba97496cf9c5d68dd33232245d4f

See more details on using hashes here.

File details

Details for the file Logria-0.9.14-py3-none-any.whl.

File metadata

  • Download URL: Logria-0.9.14-py3-none-any.whl
  • Upload date:
  • Size: 63.5 kB
  • Tags: Python 3
  • Uploaded using 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

File hashes

Hashes for Logria-0.9.14-py3-none-any.whl
Algorithm Hash digest
SHA256 b6cc6ad56bf4a868c2bf567478281917717488537ce6fbc4362443f5abc62a7a
MD5 490cc6b5ea1a6a4e308fd58e5e65c447
BLAKE2b-256 87d046b3d32b65b0408f49dba1bf1b77a7068e883f842ee3bdd9f1718a8c1d8e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page