https://github.com/bouke/django-airbrake

Django Airbrake provides a logging handler to push exceptions and other errors to airbrakeapp or other airbrake-compatible exception handler services (e.g. aTech Media's Codebase).
https://github.com/bouke/django-airbrake

airbrake codebasehq django logging

Last synced: 16 days ago
JSON representation

Django Airbrake provides a logging handler to push exceptions and other errors to airbrakeapp or other airbrake-compatible exception handler services (e.g. aTech Media's Codebase).

• Host: GitHub
• URL: https://github.com/bouke/django-airbrake
• Owner: Bouke
• License: other
• Created: 2012-08-27T15:19:42.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2018-05-27T08:48:41.000Z (over 6 years ago)
• Last Synced: 2024-10-12T07:28:49.143Z (about 1 month ago)
• Topics: airbrake, codebasehq, django, logging
• Language: Python
• Homepage: https://pypi.python.org/pypi/django-airbrake
• Size: 40 KB
• Stars: 17
• Watchers: 4
• Forks: 9
• Open Issues: 1
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
===============

Django Airbrake

===============

.. image:: https://travis-ci.org/Bouke/django-airbrake.png?branch=master

    :alt: Build Status

    :target: https://travis-ci.org/Bouke/django-airbrake

.. image:: https://coveralls.io/repos/Bouke/django-airbrake/badge.png?branch=master

    :alt: Test Coverage

    :target: https://coveralls.io/r/Bouke/django-airbrake?branch=master

.. image:: https://badge.fury.io/py/django-airbrake.png

    :alt: PyPI

    :target: https://pypi.python.org/pypi/django-airbrake

Django Airbrake provides a logging handler to push exceptions and other errors

to airbrakeapp or other airbrake-compatible exception handler services (e.g.

aTech Media's Codebase).

Compatible with all supported Django (LTS) versions. At the moment of writing

that's including 1.11 and 2.0 on Python 2.7(only django1.11), 3.4, 3.5 and 3.6.

Installation

============

Installation with ``pip``:

::

    $ pip install django-airbrake

Add ``'airbrake.handlers.AirbrakeHandler'`` as a logging handler:

::

    LOGGING = {

        'version': 1,

        'disable_existing_loggers': False,

        'filters': {

            'require_debug_false': {

                '()': 'django.utils.log.RequireDebugFalse'

            }

        },

        'handlers': {

            'airbrake': {

                'level': 'WARNING',

                'class': 'airbrake.handlers.AirbrakeHandler',

                'filters': ['require_debug_false'],

                'api_key': '[your-api-key]',

                'env_name': 'develop',

            }

        },

        'loggers': {

            'django.request': {

                'handlers': ['airbrake'],

                'level': 'WARNING',

                'propagate': True,

            },

        }

    }

Settings

========

``level`` (built-in setting)

Change the ``level`` to ``'ERROR'`` to disable logging of 404 error messages.

``api_key`` (required)

    API key provided by the exception handler system.

``env_name`` (required)

    Name of the environment (e.g. production, develop, testing)

``api_url``

    To use aTech Media's Codebase exception system, provide an extra setting

    ``api_url`` with the value

    ``'https://exceptions.codebasehq.com/notifier_api/v2/notices'``.

``env_variables``

    List of environment variables that should be included in the error message,

    defaults to ``['DJANGO_SETTINGS_MODULE']``.

``meta_variables``

    List of ``request.META`` variables that should be included in the error

    message, defaults to ``['HTTP_USER_AGENT', 'HTTP_COOKIE', 'REMOTE_ADDR',

    'SERVER_NAME', 'SERVER_SOFTWARE']``.

``timeout``

    Timeout in seconds to send the error report, defaults to 30 seconds.

Contributing

============

* Fork the repository on GitHub and start hacking.

* Run the tests.

* Send a pull request with your changes.

Releasing

---------

The following actions are required to push a new version::

    bumpversion [major|minor|patch]

    python setup.py sdist bdist_wheel upload

    git push && git push --tags