Skip to content

winkapp/py-logger

Repository files navigation

Py-Logger

CircleCI

A python logging library that enables logging via stout or syslog over TCP.

This library makes logs that adhere to the Syslog Protocol RFC.

All lines are send with a new line delimiter appended to the end of the line.

Exmaple log line

<14> 2017-05-22 17:53:10,018 f2391b2845ac tcp_test_logger testing the tcp logger info level

Configuration

The py-logger library logs to stdout by default if no method is given or if the TCP_SYSLOG_LOGGING environment varaible is not set.

ENV Description
TCP_SYSLOG_LOGGING Use the TCP Syslogger handler
SYSLOG_HOST Host address to send TCP logs to
SYSLOG_PORT Post to send TCP logs to on SYSLOG_HOST
SYSLOG_LINE_TERMINATOR The end of line terminator. Defaults to \n

Usage

Logger

from py_logger import PyLogger

logger = PyLogger.getPyLogger('my_app_name')

logger.info('Hello World')

Explicit stdout logger

from py_logger import PyLogger

logger = PyLogger.getPyLogger('stdout', 'my_app_name')

logger.info('Hello World')

Explicit TCP logger

from py_logger import PyLogger

logger = PyLogger.getPyLogger('tcp', 'my_app_name')

logger.info('Hello World')

Tests

docker-compose run tests