diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/glossary.rst | 7 | ||||
| -rw-r--r-- | docs/narr/logging.rst | 14 |
2 files changed, 18 insertions, 3 deletions
diff --git a/docs/glossary.rst b/docs/glossary.rst index 6e4ca4b70..911fbff1a 100644 --- a/docs/glossary.rst +++ b/docs/glossary.rst @@ -938,3 +938,10 @@ Glossary application quickly. Scaffolds are usually used via the ``paster create`` command. + pyramid_exclog + A package which logs Pyramid application exception (error) information + to a standard Python logger. This add-on is most useful when + used in production applications, because the logger can be configured to + log to a file, to UNIX syslog, to the Windows Event Log, or even to + email. See its `documentation + <https://docs.pylonsproject.org/projects/pyramid_exclog/dev/>`_. diff --git a/docs/narr/logging.rst b/docs/narr/logging.rst index 120944fac..375ab820c 100644 --- a/docs/narr/logging.rst +++ b/docs/narr/logging.rst @@ -265,7 +265,7 @@ To capture log output to a separate file, use a `FileHandler level = INFO formatter = generic -Before it's recognized, it needs to be added to the list of Handlers: +Before it's recognized, it needs to be added to the list of handlers: .. code-block:: ini @@ -283,7 +283,15 @@ and finally utilized by a logger. These final 3 lines of configuration directs all of the root logger's output to the ``myapp.log`` as well as the console. -Request logging with Paste's TransLogger +Logging Exceptions +------------------ + +To log (or email) exceptions generated by your :app:`Pyramid` application, +use the :term:`pyramid_exclog` package. Details about its configuration are +in its `documentation +<https://docs.pylonsproject.org/projects/pyramid_exclog/dev/>`_. + +Request Logging with Paste's TransLogger ---------------------------------------- Paste provides the `TransLogger @@ -377,7 +385,7 @@ formatter that passes-through the log messages as is: [formatter_accesslog] format = %(message)s -Then wire this new ``accesslog`` Formatter into the FileHandler: +Then wire this new ``accesslog`` formatter into the FileHandler: .. code-block:: ini |