summaryrefslogtreecommitdiff
path: root/docs/narr/logging.rst
diff options
context:
space:
mode:
authorMichael Merickel <michael@merickel.org>2015-02-06 01:12:24 -0600
committerMichael Merickel <michael@merickel.org>2015-02-06 01:12:24 -0600
commitb63f0c5f6e2f322bd9183d194b4aa774f9f4e93f (patch)
tree695d4b5e5ae974d0770acfbe9b8231ea1c71288a /docs/narr/logging.rst
parentd35a916095943b020f30acb90e878abe9bfd4fb1 (diff)
parent4b13e0dfcdf47b3ef9befd529c0d78af8a2712d5 (diff)
downloadpyramid-b63f0c5f6e2f322bd9183d194b4aa774f9f4e93f.tar.gz
pyramid-b63f0c5f6e2f322bd9183d194b4aa774f9f4e93f.tar.bz2
pyramid-b63f0c5f6e2f322bd9183d194b4aa774f9f4e93f.zip
Merge branch 'master' into feature.re-entrant-config
Diffstat (limited to 'docs/narr/logging.rst')
-rw-r--r--docs/narr/logging.rst18
1 files changed, 9 insertions, 9 deletions
diff --git a/docs/narr/logging.rst b/docs/narr/logging.rst
index c16673ae6..921883091 100644
--- a/docs/narr/logging.rst
+++ b/docs/narr/logging.rst
@@ -254,16 +254,15 @@ level unless they're explicitly set differently. Meaning the ``myapp.views``,
``myapp.models`` (and all your app's modules') loggers by default have an
effective level of ``DEBUG`` too.
-For more advanced filtering, the logging module provides a `Filter
-<http://docs.python.org/lib/node423.html>`_ object; however it cannot be used
-directly from the configuration file.
+For more advanced filtering, the logging module provides a
+:class:`logging.Filter` object; however it cannot be used directly from the
+configuration file.
-Advanced Configuration
+Advanced Configuration
----------------------
-To capture log output to a separate file, use a `FileHandler
-<http://docs.python.org/lib/node412.html>`_ (or a `RotatingFileHandler
-<http://docs.python.org/lib/node413.html>`_):
+To capture log output to a separate file, use :class:`logging.FileHandler` (or
+:class:`logging.handlers.RotatingFileHandler`):
.. code-block:: ini
@@ -317,8 +316,9 @@ output, etc., but not web traffic. For web traffic logging Paste provides the
:term:`middleware`. TransLogger produces logs in the `Apache Combined Log
Format <http://httpd.apache.org/docs/2.2/logs.html#combined>`_. But
TransLogger does not write to files, the Python logging system must be
-configured to do this. The Python FileHandler_ logging handler can be used
-alongside TransLogger to create an ``access.log`` file similar to Apache's.
+configured to do this. The Python :class:`logging.FileHandler` logging
+handler can be used alongside TransLogger to create an ``access.log`` file
+similar to Apache's.
Like any standard :term:`middleware` with a Paste entry point, TransLogger can
be configured to wrap your application using ``.ini`` file syntax. First,