aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source')
-rw-r--r--docs/source/conf.py3
-rw-r--r--docs/source/siteadmin/production-deployments.rst46
2 files changed, 48 insertions, 1 deletions
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 8113e247..0b2bccac 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -26,7 +26,8 @@ sys.path.insert(0, os.path.abspath(os.path.join('..', '..')))
# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc']
+extensions = ['sphinx.ext.autodoc', 'sphinx.ext.intersphinx']
+intersphinx_mapping = {'python': ('http://docs.python.org/2.7', None)}
# Add any paths that contain templates here, relative to this directory.
templates_path = ['source/_templates']
diff --git a/docs/source/siteadmin/production-deployments.rst b/docs/source/siteadmin/production-deployments.rst
index 356fab7f..0ed5ac6a 100644
--- a/docs/source/siteadmin/production-deployments.rst
+++ b/docs/source/siteadmin/production-deployments.rst
@@ -77,6 +77,52 @@ Modify your existing MediaGoblin and application init scripts, if
necessary, to prevent them from starting their own ``celeryd``
processes.
+Monitor exceptions
+------------------
+
+This is an example config using raven_ to report exceptions and
+:py:mod:`logging` messages to a sentry_ instance
+
+.. _raven: http://raven.readthedocs.org/
+.. _sentry: https://github.com/getsentry
+
+.. code-block:: ini
+
+ [pipeline:main]
+ pipeline =
+ errors
+ raven
+ routing
+
+ [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_sentry]
+ class = raven.handlers.logging.SentryHandler
+ args = ('http://public:secret@example.com/1',)
+ level = WARNING
+ formatter = generic
+
+ [filter:raven]
+ use = egg:raven#raven
+ dsn = http://71727ea2c69043e4bbcd793bb0115cd4:e9cedccb32d9482d81f99eeca8b1ad30@sentry.talka.tv/3
+
.. _init-script:
Use an Init Script