Skip to main content

aiologfields: inject Task-context-fields into loggers

Project description

https://travis-ci.org/cjrh/aiologfields.svg?branch=master https://coveralls.io/repos/github/cjrh/aiologfields/badge.svg?branch=master https://img.shields.io/pypi/pyversions/aiologfields.svg https://img.shields.io/github/tag/cjrh/aiologfields.svg https://img.shields.io/badge/install-pip%20install%20aiologfields-ff69b4.svg https://img.shields.io/pypi/v/aiologfields.svg https://img.shields.io/badge/calver-YYYY.MM.MINOR-22bfda.svg

aiologfields

aiologfields makes it easy to include correlation IDs, as well as other contextual information into log messages, across await calls and loop.create_task() calls. Correlation IDs are critically important for accurate telemetry in monitoring and debugging distributed microservices.

Instructions

It couldn’t be easier:

aiologfields.install()

After this, every single task created will have a logging_fields attribute. To add a field to a LogRecord, simply apply it to any task:

t = loop.create_task(coro)
t.logging_fields.correlation_id = '12345'

If you’re using a logging handler that produces JSON output (like logjson!), or some other formatter that produces output with all fields in the LogRecord, you will find that each record within the context of the task will include an additional field called correlation_id with a value of 12345.

Demo

This is adapted from one of the tests:

aiologfields.install()
correlation_id = str(uuid4())
logger = logging.getLogger('blah')

async def cf2():
    logger.info('blah blah')

async def cf1():
    ct = asyncio.Task.current_task()
    ct.logging_fields.correlation_id = correlation_id
    await cf2()

loop.run_until_complete(cf1())

In the LogRecord produced inside cf2(), an additional field correlation_id is included, even though the field was set in coroutine function cf1().

It would also have worked if cf2() had been executed in a separate task itself, since the logging_fields namespace is copied between nested tasks.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
aiologfields-2018.9.1-py2.py3-none-any.whl (18.2 kB) Copy SHA256 hash SHA256 Wheel py2.py3
aiologfields-2018.9.1.tar.gz (9.0 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page