From 3ce1d303daa92ecb1bc3ba6344f1ec9746a79c70 Mon Sep 17 00:00:00 2001 From: Jaap Roes Date: Mon, 3 Jun 2013 15:53:04 +0200 Subject: Warned that `request_finished` isn't sent by some buggy setups. Older versions of uWSGI and Sentry's middleware do not adhere to the WSGI spec and cause the `request_finished` signal to never fire. Added notes to the appropriate places in the docs. Fixed #20537. --- docs/howto/deployment/wsgi/index.txt | 8 ++++++++ docs/howto/deployment/wsgi/uwsgi.txt | 9 +++++++++ 2 files changed, 17 insertions(+) (limited to 'docs/howto') diff --git a/docs/howto/deployment/wsgi/index.txt b/docs/howto/deployment/wsgi/index.txt index ad32366bf8..17eb53cf0c 100644 --- a/docs/howto/deployment/wsgi/index.txt +++ b/docs/howto/deployment/wsgi/index.txt @@ -82,6 +82,14 @@ to combine a Django application with a WSGI application of another framework. .. _`WSGI middleware`: http://www.python.org/dev/peps/pep-3333/#middleware-components-that-play-both-sides +.. note:: + + Some third-party WSGI middleware do not call ``close`` on the response + object after handling a request — most notably Sentry's error reporting + middleware up to version 2.0.7. In those cases the + :data:`~django.core.signals.request_finished` signal isn't sent. This can + result in idle connections to database and memcache servers. + Upgrading from Django < 1.4 --------------------------- diff --git a/docs/howto/deployment/wsgi/uwsgi.txt b/docs/howto/deployment/wsgi/uwsgi.txt index 22f39342d6..3e9b47e8f9 100644 --- a/docs/howto/deployment/wsgi/uwsgi.txt +++ b/docs/howto/deployment/wsgi/uwsgi.txt @@ -34,6 +34,15 @@ command. For example: .. _installation procedures: http://projects.unbit.it/uwsgi/wiki/Install +.. warning:: + + Some distributions, including Debian and Ubuntu, ship an outdated version + of uWSGI that does not conform to the WSGI specification. Versions prior to + 1.2.6 do not call ``close`` on the response object after handling a + request. In those cases the :data:`~django.core.signals.request_finished` + signal isn't sent. This can result in idle connections to database and + memcache servers. + uWSGI model ----------- -- cgit v1.3