Metadata-Version: 2.1
Name: django-requestlogging-redux
Version: 1.2.1
Summary: Adds information about requests to logging records.
Home-page: https://github.com/tarkatronic/django-requestlogging
Author: TrustCentric
Author-email: admin@trustcentric.com
Maintainer: Joey Wilhelm
Maintainer-email: tarkatronic@gmail.com
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
License-File: LICENSE
Requires-Dist: Django>=1.8

django-requestlogging
=====================

.. image:: https://img.shields.io/pypi/v/django-requestlogging-redux.svg
   :target: https://pypi.python.org/pypi/django-requestlogging-redux
   :alt: Latest Version

.. image:: https://travis-ci.org/tarkatronic/django-requestlogging.svg?branch=master
   :target: https://travis-ci.org/tarkatronic/django-requestlogging
   :alt: Test/build status

.. image:: https://codecov.io/gh/tarkatronic/django-requestlogging/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/tarkatronic/django-requestlogging
   :alt: Code coverage

This package provides a logging filter and middleware to add
information about the current request to the logging record.


Installation and Usage
----------------------

Install the package, add ``django_requestlogging`` to
``settings.INSTALLED_APPS``, add
``django_requestlogging.middleware.LogSetupMiddleware`` to
``settings.MIDDLEWARE_CLASSES``, and add
``django_requestlogging.logging_filters.RequestFilter`` as a logging
filter.  See below for an example logging configuration.

The filter adds information about the current request to the logging
record.  The following keys can be substituted in the logging
formatter string:

    ``http_user_agent``
       The user agent string, provided by the client.

    ``path_info``
       The requested HTTP path.

    ``remote_addr``
       The remote IP address.

    ``request_method``
       The HTTP request method (*e.g.* GET, POST, PUT, DELETE, *etc.*)

    ``server_protocol``
       The server protocol (*e.g.* HTTP, HTTPS, *etc.*)

    ``username``
       The username for the logged-in user.

If any of this information cannot be extracted from the current
request (or there is no current request), a hyphen ``'-'`` is
substituted as a placeholder.


Logging Configuration Example
-----------------------------

This logging configuration can be added to your
``DJANGO_SETTINGS_MODULE``.  It adds an unbound RequestFilter,
which will be bound to the current request by the middleware and then
unbound again at response time.
::

  LOGGING = {
      'filters': {
          # Add an unbound RequestFilter.
          'request': {
              '()': 'django_requestlogging.logging_filters.RequestFilter',
          },
      },
      'formatters': {
          'request_format': {
              'format': '%(remote_addr)s %(username)s "%(request_method)s '
              '%(path_info)s %(server_protocol)s" %(http_user_agent)s '
              '%(message)s %(asctime)s',
          },
      },
      'handlers': {
          'console': {
              'class': 'logging.StreamHandler',
              'filters': ['request'],
              'formatter': 'request_format',
          },
      },
      'loggers': {
          'myapp': {
              # Add your handlers that have the unbound request filter
              'handlers': ['console'],
              # Optionally, add the unbound request filter to your
              # application.
              'filters': ['request'],
          },
      },
  }
