diff options
Diffstat (limited to 'docs/integrations/pyramid.rst')
| -rw-r--r-- | docs/integrations/pyramid.rst | 79 |
1 files changed, 0 insertions, 79 deletions
diff --git a/docs/integrations/pyramid.rst b/docs/integrations/pyramid.rst deleted file mode 100644 index 41d247e..0000000 --- a/docs/integrations/pyramid.rst +++ /dev/null @@ -1,79 +0,0 @@ -Pyramid -======= - -Installation ------------- - -If you haven't already, start by downloading Raven. The easiest way is -with *pip*:: - - pip install raven --upgrade - -PasteDeploy Filter ------------------- - -A filter factory for `PasteDeploy <https://pastedeploy.readthedocs.io/en/latest/>`_ exists to allow easily inserting Raven into a WSGI pipeline: - -.. code-block:: ini - - [pipeline:main] - pipeline = - raven - tm - MyApp - - [filter:raven] - use = egg:raven#raven - dsn = ___DSN___ - include_paths = my.package, my.other.package - exclude_paths = my.package.crud - -In the ``[filter:raven]`` section, you must specify the entry-point for raven with the ``use =`` key. All other raven client parameters can be included in this section as well. - -See the `Pyramid PasteDeploy Configuration Documentation <http://docs.pylonsproject.org/projects/pyramid/en/latest/narr/paste.html>`_ for more information. - -Logger setup ------------- - -Add the following lines to your project's `.ini` file to setup `SentryHandler`: - -.. code-block:: ini - - [loggers] - keys = root, sentry - - [handlers] - keys = console, sentry - - [formatters] - keys = generic - - [logger_root] - level = INFO - handlers = console, sentry - - [logger_sentry] - level = WARN - handlers = console - qualname = sentry.errors - propagate = 0 - - [handler_console] - class = StreamHandler - args = (sys.stderr,) - level = NOTSET - formatter = generic - - [handler_sentry] - class = raven.handlers.logging.SentryHandler - args = ('___DSN___',) - level = WARNING - formatter = generic - - [formatter_generic] - format = %(asctime)s,%(msecs)03d %(levelname)-5.5s [%(name)s] %(message)s - datefmt = %H:%M:%S - -.. note:: You may want to setup other loggers as well. See the `Pyramid Logging Documentation <http://docs.pylonsproject.org/projects/pyramid/en/latest/narr/logging.html>`_ for more information. - -Instead of defining the DSN in the `.ini` file you can also use the environment variable ``SENTRY_DSN`` which overwrites the setting in this file. Because of a syntax check you cannot remove the ``args`` setting completely, as workaround you can define an empty list of arguments ``args = ()``. |