semvec/pypi-packages huggingface dataset:
daiquiri-rollbar 0.2.1
Easy way to integrate Rollbar into daiquiri
License: MIT
Keywords: daiquiri logging rollbar

daiquiri-rollbar
=================

Easy way to use `Rollbar <http://rollbar.com/>`__ with `daiquiri <http://daiquiri.readthedocs.io/en/latest/>`__.

The level of the messages is preserved. So ``logger.info('smth')`` will be registered as ``info`` in Rollbar. If you configure daiquiri to log messages above a certain level, only those messages will be sent to Rollbar. You can also configure the ``RollbarOutput`` to only log messages for a level that is different from the global configuration.

Exception should be logged with ``logger.exception``. The stacktrace will then be sent to Rollbar with ``report_exc_info``.

To use it, just add ``RollbarOutput`` to the list of daiquiri outputs and use daiquiri normally:

.. code:: python

    import logging
    from daiquiri_rollbar import RollbarOutput

    rollbar_output = RollbarOutput(access_token='access_token')
    daiquiri.setup(
        level=logging.INFO,
        outputs=(rollbar_output,)
    )
    logger = daiquiri.getLogger(__name__)

    logger.info('Test')

To log message of a certain level:

.. code:: python

    import logging
    from daiquiri_rollbar import RollbarOutput

    rollbar_output = RollbarOutput(access_token='access_token', level=logging.WARNING)
    daiquiri.setup(
        level=logging.INFO,
        outputs=(rollbar_output,)
    )
    logger = daiquiri.getLogger(__name__)

    logger.info('Test')

By default, log messages will be logged for production. To change the environment, build ``RollbarOutput`` like this:

.. code:: python

    rollbar_output = RollbarOutput(access_token='access_token', environment='development')

If you don't pass an access token, ``RollbarOutput`` will not log anything.

Error messages from the ``rollbar`` module are not sent into Rollbar to prevent an infinite loop. They are sent to stderr instead. They will be logged by other outputs if you have any.


Changelog
=========

0.2.1 (2017-08-15)
------------------

- Improve documentation


0.2.0 (2017-08-15)
------------------

- Log messages into rollbar