https://github.com/eht16/python-logstash-async

Python logging handler for sending log events asynchronously to Logstash.
https://github.com/eht16/python-logstash-async

asynchronous logging logstash python

Last synced: 1 day ago
JSON representation

Python logging handler for sending log events asynchronously to Logstash.

• Host: GitHub
• URL: https://github.com/eht16/python-logstash-async
• Owner: eht16
• License: mit
• Created: 2016-04-19T05:45:05.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-04-13T17:32:39.000Z (9 months ago)
• Last Synced: 2024-04-16T07:04:19.669Z (9 months ago)
• Topics: asynchronous, logging, logstash, python
• Language: Python
• Homepage:
• Size: 270 KB
• Stars: 177
• Watchers: 4
• Forks: 53
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
=====================

python-logstash-async

=====================

.. image:: https://img.shields.io/pypi/v/python-logstash-async.svg

    :target: https://pypi.org/project/python-logstash-async/

    :alt: PyPI

.. image:: https://readthedocs.org/projects/python-logstash-async/badge/?version=latest

    :target: https://python-logstash-async.readthedocs.io/en/latest/

    :alt: Documentation Status

.. image:: https://github.com/eht16/python-logstash-async/actions/workflows/tests.yml/badge.svg

    :target: https://github.com/eht16/python-logstash-async/actions/workflows/tests.yml

    :alt: CI Tests

.. image:: https://img.shields.io/pypi/pyversions/python-logstash-async.svg

    :target: https://pypi.org/project/python-logstash-async/

    :alt: Python Versions

.. image:: https://img.shields.io/pypi/l/python-logstash-async.svg

    :target: https://pypi.org/project/python-logstash-async/

    :alt: License

Python Logstash Async is an asynchronous Python logging handler to submit

log events to a remote Logstash instance.

Unlike most other Python Logstash logging handlers, this package works asynchronously

by collecting log events from Python's logging subsystem and then transmitting the

collected events in a separate worker thread to Logstash.

This way, the main application (or thread) where the log event occurred, doesn't need to

wait until the submission to the remote Logstash instance succeeded.

This is especially useful for applications like websites or web services or any kind of

request serving API where response times matter.

For more details, configuration options and usage examples please see the

documentation at http://python-logstash-async.readthedocs.io/en/latest/.

Installation

------------

The easiest method is to install directly from pypi using pip::

    pip install python-logstash-async

If you prefer, you can download python-logstash-async and install it

directly from source::

    python setup.py install

Get the Source

--------------

The source code is available at https://github.com/eht16/python-logstash-async/.

Contributing

------------

Found a bug or got a feature request? Please report it at

https://github.com/eht16/python-logstash-async/issues.

Author

------

Enrico Tröger