From bfdbcf4c25e28216060834b648a022045d88146b Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Sat, 13 Aug 2011 01:55:45 -0400 Subject: mention pyramid_exclog --- docs/glossary.rst | 7 +++++++ 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 + `_. 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 +`_. + +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 -- cgit v1.2.3