Skip to main content

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

Project description

Logria Logo

Logria

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

tl;dr

  • Live filtering of stream or streams from other executed processes, replacing grep
  • Replace regex/filter without killing the process or losing the stream's history
  • Parse logs using user-defined rules, apply analytics methods on top
  • No dependencies

Installation

There are several options to install this app.

Normal Usage

pip install logria

Development

Installing as a standalone app

  • clone the repository
  • cd to the repository
  • (Optional) Create a virtual environment (3.6+)
    • python -m venv venv
    • source venv/bin/activate
  • (Optional) install requirements
    • These are only for some development tools and are not needed to run the app
    • pip install -r requirements.txt
  • Install self
    • deactivate if we want to install globally, otherwise leave your venv active
    • python setup.py develop or python setup.py install depending on whether you are actively developing this app

Installing as part of another app

  • clone the repository to your venv folder
    • Be sure your virtual environment is active
  • Install Logria
    • python setup.py install

Usage

There are a few main ways to invoke Logria:

  • Directly:
    • logria
  • With args:
    • logria -e 'tail -f log.txt'
  • As a pipe:

It may also be imported and invoked programmatically as part of other software:

from logria.communication.input_handler import CommandInputStream
from logria.communication.shell_output import Logria


process_to_read = ['python', 'sample_streams/generate_test_logs.py']
stream = CommandInputStream(process_to_read)
app = Logria(stream)  # Capture output from `process_to_read`
app.start()

Key Commands

Key Command
: command mode
/ regex search
h if regex active, toggle highlighting of matches
i toggle insert mode (default off)
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 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.6.1.tar.gz (25.2 kB view hashes)

Uploaded Source

Built Distribution

logria-0.6.1-py3-none-any.whl (42.3 kB view hashes)

Uploaded Python 3

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