https://github.com/afriemann/mdc

Mapped Diagnostic Context style logging for Python
https://github.com/afriemann/mdc

logging mdc python

Last synced: about 1 year ago
JSON representation

Mapped Diagnostic Context style logging for Python

• Host: GitHub
• URL: https://github.com/afriemann/mdc
• Owner: AFriemann
• License: bsd-3-clause
• Created: 2018-02-16T21:06:46.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-02-08T12:49:01.000Z (over 2 years ago)
• Last Synced: 2025-04-12T05:47:11.691Z (about 1 year ago)
• Topics: logging, mdc, python
• Language: Python
• Homepage:
• Size: 40 KB
• Stars: 9
• Watchers: 2
• Forks: 8
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
MDC

===

.. image:: https://travis-ci.org/AFriemann/mdc.svg?branch=master

    :target: https://travis-ci.org/AFriemann/mdc

This is thought to be an easy to use, import and go, library for Mapped Diagnostic Context style logging.

Logs should include all necessary fields collected by the python logging library.

Helper methods are provided to add context fields where required.

**NOTE** `1.2.0`: recent changes will result in changed json output if using the `MDCHandler` class:

.. code:: python

  >>> with MDC(foobar="baz"):

  ...   logging.warning("test") 

  { "message": "test", "foobar": "baz" }

this is a temporary solution to avoid breaking existing APIs. Please excuse any issues this might cause. In the future output handling should be done on the client side to avoid any possible breakage. The MDCHandler class will eventually be removed.

Installation

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

PyPi:

.. code:: bash

  $ pip install --user mdc

From source:

.. code:: bash

  $ pip install --user .

Usage

-----

Add a handler to the root logger or set the base handler with *logging.basicConfig*:

.. code:: python

  >>> import logging

  >>> from mdc import MDCHandler

  >>> # use the MDCHandler only

  >>> logging.basicConfig(level=logging.DEBUG, handlers=[MDCHandler()])

  >>> # the MDC contextmanager

  >>> with MDC(foo='bar'):

  ...     logging.warning('foobar')

  { ..., "mdc": { "foo": "bar" }, "extra": {}, ... }

  >>> # the with_mdc decorator

  >>> @with_mdc(test='123')

  ... def foobar(ctx):

  ...   logging.warning('some warning')

  >>> foobar()

  { ..., "mdc": { "test": "123" }, "extra": {}, ... }

  >>> # logging with extra fields

  >>> logging.error('some error', extra=dict(foo='bar'))

  { ..., "mdc": {}, "extra": { "foo": "bar" }, ... }

By default log messages will include the following fields:

.. code:: json

  {

    "message": "deleting context b8321b4f-19ff-4c98-b011-5a97178e7ad6",

    "logger": "mdc",

    "timestamp": "2018-03-07T21:39:12.010851",

    "level": "DEBUG",

    "mdc": {

      "foo": "bar",

      "index": 76

    },

    "extra": {},

    "python": {

      "module": "__init__",

      "function": "MDC",

      "path": "/home/user/git/mdc/mdc/__init__.py",

      "file": "__init__.py",

      "line": 56,

      "process": {

        "name": "MainProcess",

        "id": 31678

      },

      "thread": {

        "name": "MainThread",

        "id": 140433289192768

      }

    }

  }

Running tests:

.. code:: bash

  $ tox