README.rst

Logging GELF

A python logging bundle to send logs using GELF. This is a rewrote of Djehouty

Quickstart

First, install logging-gelf using pip:

pip install -U logging-gelf

The following example shows how to send log in Graylog TCP input

import logging
from logging_gelf.formatters import GELFFormatter
from logging_gelf.handlers import GELFTCPSocketHandler

logger = logging.getLogger("gelf")
logger.setLevel(logging.DEBUG)

handler = GELFTCPSocketHandler(host="127.0.0.1", port=12201)
handler.setFormatter(GELFFormatter(null_character=True))
logger.addHandler(handler)
logger.debug("hello !")

Documentation

Logging adapter, extra, custom schema and many other stuff are available in the full documentation available at http://logging-gelf.readthedocs.io/ .

Requirements

• Python >= 3.3

Project Links

• Docs: http://logging-gelf.readthedocs.io/
• PyPI: https://pypi.python.org/pypi/logging-gelf
• Issues: https://github.com/ovh/python-logging-gelf/issues

License

Licensed under BSD 3-Clause License or https://opensource.org/licenses/BSD-3-Clause.