nginxlib 0.1.0a0

Parse nginx logs.

Python nginx Log Parser

Parse nginx logs with Python.

• Free software: MIT license

<! – Docs not yet published * Documentation: https://nginxlib.readthedocs.io. –>

This package parses nginx logs and provides a Python object representing each log. It also has some procedures to aggregate log data.

Installation

With pip:

$ pip install nginxlib

For development:

$ python setup.py develop

Run the tests:

$ make test

Features

• Parse a discrete nginx log entry to a Python object

• Aggregate log data

Usage

Given this nginx log entry:

` 96.49.212.83 - - [16/Jun/2019:22:52:21 +0000] "GET /vs/editor/editor.main.nls.js HTTP/1.1" 200 34027 "https://3000-98358490.staging-avl.appsembler.com/" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.13; rv:67.0) Gecko/20100101 Firefox/67.0" "-" # noqa E503 `

the entryparse object will behave as follows:

>>> from nginxparser import entryparse

>>> entry = entryparse(log_string)
>>> entry.timestamp
datetime.datetime(2019, 6, 16, 23, 54, 5, 624139)
>>> entry.url
ParseResult(scheme='https', netloc='3000-98358490.staging-avl.appsembler.com', path='', params='', query='', fragment='')
>>> entry.deploy_id
'98358490'

Credits

• This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

• Inspired by and forked from: https://code.richard.do/explore/projects.

History

0.1.0-alpha (2019-06-17)

• First release on PyPI.

• Port the original repo

• Add procedures to parse discrete logs