Skip to main content

Simple log analysis library

Project description

I wrote loggrok a while back as I needed a simple library

for analyzing logs. I am not actively developing loggrok, but please let me know if you find any bugs etc.

Features include:

  • Simple callback system (loggrok.actions)

  • Seemless iteration over multiple rollover-index based log files - smartly joins broken lines (RollingIndexLogStream)

  • Custom regex-based header and message body matching.

Example usage:

>>> from loggrok.actions import Action
>>> action = Action()
>>> def printError(entry):
...     print 'err!', str(entry)[:-1]
...
>>> action.addLevelCallback('ERROR', printError)
>>> def printWarning(entry):
...     print 'warning!', str(entry)[:-1]
...
>>> action.addLevelCallback('WARN', printWarning)
>>> from loggrok.log import LogStream
>>> stream = LogStream(fname)
>>> stream.action = action
>>> for entry in stream:
...     continue
...
err! blah blah
warning! blah blah
err! blah blah

You can also write your own regexes for matching custom headers:

>>> from loggrok.parse import HeaderParser, MessageParser
>>> header_patt = r'^([a-zA-Z]+) ([a-zA-Z]+) <(\d+)> '
# Entry attributes correspond to groups in regex pattern
>>> header_attrs = ('foo', 'bar', 'baz')
>>> header_parser = HeaderParser(header_patt, header_attrs)
>>> message_patterns = (...) # regexs for message body - after header
>>> message_attrs = (...) # tuple of attribute tuples corresponding to patters
>>> messageParser = MessageParser(message_patterns, message_attrs)
...
>>> stream.messageParser = messageParser

See doctest in tests directory for working examples.

To run unit tests:

python runtests.py

N.B. - loggrok will emit warning related to “broken” CurriedCallable class, though it should not cause issues.

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

loggrok-0.2.1.tar.gz (10.9 kB view details)

Uploaded Source

Built Distributions

loggrok-0.2.1-py2.5.egg (12.6 kB view details)

Uploaded Egg

loggrok-0.2.1-py2.4.egg (12.7 kB view details)

Uploaded Egg

File details

Details for the file loggrok-0.2.1.tar.gz.

File metadata

  • Download URL: loggrok-0.2.1.tar.gz
  • Upload date:
  • Size: 10.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for loggrok-0.2.1.tar.gz
Algorithm Hash digest
SHA256 a92bc52abda416db3389a7d4d00e45535e7fe9700adeb5e80f756a386e33f232
MD5 2059387c68666257cefd8186c89c2fc7
BLAKE2b-256 7dccb118845b0110ed09fec8c77b7023cacc5dccb86332fb778ed03db9afaa36

See more details on using hashes here.

File details

Details for the file loggrok-0.2.1-py2.5.egg.

File metadata

  • Download URL: loggrok-0.2.1-py2.5.egg
  • Upload date:
  • Size: 12.6 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for loggrok-0.2.1-py2.5.egg
Algorithm Hash digest
SHA256 03a580644828d73bc448a08737439466b7f4e27ac79f0e5be75fc34b9526220f
MD5 c3284db4187c67049305844eef5b2e65
BLAKE2b-256 9ca0ee46273386655a240ae81a75f980599e0f935b50734bd8208ff57723defc

See more details on using hashes here.

File details

Details for the file loggrok-0.2.1-py2.4.egg.

File metadata

  • Download URL: loggrok-0.2.1-py2.4.egg
  • Upload date:
  • Size: 12.7 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for loggrok-0.2.1-py2.4.egg
Algorithm Hash digest
SHA256 6b38c085d77c27043600da2f78f9cf5bd5b7b9702bb6bf11b9f9c11dcdec5e35
MD5 2dcbaf520789fe076e82d488ea64df74
BLAKE2b-256 b5bc59e481fbbdab2bbb8e3a65b5c2cb740897a6e11f1bf07984acf1fb85d333

See more details on using hashes here.

Supported by

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