Quickstart

First, install logging-ldp using pip:

pip install -U logging-ldp

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

import logging
from logging_ldp.formatters import LDPGELFFormatter
from logging_ldp.handlers import LDPGELFTCPSocketHandler

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

handler = LDPGELFTCPSocketHandler(hostname="gra1.logs.ovh.com")
handler.setFormatter(LDPGELFFormatter(token="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"))
logger.addHandler(handler)
logger.debug("hello !")

Requirements

• Python >= 3.3

Project Links

• Docs: http://logging-ldp.readthedocs.io/

• PyPI: https://pypi.python.org/pypi/logging-ldp

• Issues: https://github.com/ovh/python-logging-ldp/issues

• OVH Logs Data Platform

  • Homepage (FR): https://logs.ovh.com

  • Documentation: https://docs.ovh.com/fr/logs-data-platform/

• Graylog & GELF

  • Documentation: http://docs.graylog.org/en/latest/pages/gelf.html

  • Python logging-gelf: http://logging-gelf.readthedocs.io/

License

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