Package: dogslow-sentry
OverviewDogslow is a Django watchdog middleware that logs tracebacks of slow
requests. Dogslow-sentry requires Python 3.7+, Django 2.2+.It started as aninternal project inside Bitbucketto help trace
operational problems.In 2021, the dogslow-sentry fork was created to add Sentry-specific information
to reports, like full stack trace, request information, fingerprint for issue
grouping, breadcrumbs, etc.InstallationInstall dogslow-sentry:$ pip install dogslow-sentryThen adddogslow_sentry.WatchdogMiddlewareto your Django settings file:MIDDLEWARE = [
    'dogslow_sentry.WatchdogMiddleware',
    ...
]For best results, make it one of the first middlewares that is run.ConfigurationNaturally, dogslow-sentry expects aworking Sentry configuration for Django.You can use the following configuration in yoursettings.pyfile to tune the watchdog:# Watchdog is enabled by default, to temporarily disable, set to False:
DOGSLOW = True

# Log requests taking longer than 25 seconds:
DOGSLOW_TIMER = 25

# Enable logging to Sentry
DOGSLOW_SENTRY = True

# Also log slow request tracebacks to Python logger
DOGSLOW_LOGGER = 'dogslow_sentry'
DOGSLOW_LOG_LEVEL = 'WARNING'

# Tuple of url pattern names that should not be monitored:
# (defaults to none -- everything monitored)
DOGSLOW_IGNORE_URLS = ('some_view', 'other_view')UsageEvery incoming HTTP request gets a 25 second timeout in the watchdog. If a
request does not return within that time, the watchdog activates and takes a
peek at the request thread’s stack and writes the backtrace (including all
local stack variables – Django style) to a log file.Note thatdogslowonly takes a peek at the thread’s stack. It does not
interrupt the request, or influence it in any other way. Usingdogslowis
therefore safe to use in production.Changelog2.0.1 (2023-12-08)Use ISO 8601-like YYYY-MM-DD date format for email/file logging.Fixed deprecation warnings on Python 3.12 (utcnow function).Enabled CI testing with Python 3.11, 3.12 and Django 5.0, 4.2, 4.1.2.0.0 (2021-12-13)Configured GitHub Actions for CI.Enabled testing with Python 3.10 and Django 4.0.Fixed deprecation warning when using Python 3.10.2.0.0b1 (2021-07-19)Initial pre-release ofdogslow-sentryfork.Improved Sentry integration.Dropped Python 2.7 support, now requires Python 3.7+, Django 2.2+.Many minor tweaks. Reformatted code with Black.1.2 (2018-01-04)Last release of upstreamdogslowpackage.CaveatsDogslow uses multithreading. It has a single background thread that handles the
watchdog timeouts and takes the tracebacks, so that the original request
threads are not interrupted. This has some consequences.Multithreading and the GILIn CPython, the GIL (Global Interpreter Lock) prevents multiple threads from
executing Python code simultaneously. Only when a thread explicitly releases
its lock on the GIL, can a second thread run.Releasing the GIL is done automatically whenever a Python program makes
blocking calls outside of the interpreter, for example when doing IO.Fordogslowthis means that it can only reliably intercept requests that
are slow because they are doing IO, calling sleep or busy waiting to acquire
locks themselves.In most cases this is fine. An important cause of slow Django requests is an
expensive database query. Since this is IO,dogslowcan intercept those
fine. A scenario where CPython’s GIL is problematic is when the request’s
thread hits an infinite loop in Python code (or legitimate Python that is
extremely expensive and takes a long time to execute), never releasing the
GIL. Even thoughdogslow’s watchdog timer thread does become runnable, it
cannot log the stack.Co-routines and GreenletsDogslowis intended for use in a synchronous worker configuration. A
webserver that uses dedicated threads (or single-threaded, dedicated worker
processes) to serve requests. Django’s built-in wsgi server does this, as
doesGunicornin its default sync-worker mode.When running with a “co-routines framework” where multiple requests are served
concurrently by one thread, backtraces might become nonsensical.