Skip to content

Document panel instrumentation behavior for production deployments#2405

Open
onxxdatas wants to merge 1 commit into
django-commons:mainfrom
onxxdatas:docs/production-panel-audit
Open

Document panel instrumentation behavior for production deployments#2405
onxxdatas wants to merge 1 commit into
django-commons:mainfrom
onxxdatas:docs/production-panel-audit

Conversation

@onxxdatas

Copy link
Copy Markdown

Description

This PR adds a new Production documentation page that audits the behavior of each built-in Django Debug Toolbar panel when the toolbar is installed but not displayed via SHOW_TOOLBAR_CALLBACK.

The documentation includes:

An overview of when instrumentation is installed (ready(), module import, or enable_instrumentation()).
Whether each panel's instrumentation can be fully avoided without removing it from DEBUG_TOOLBAR_PANELS.
Whether each panel monkey-patches Django or other components.
Recommendations for using Django Debug Toolbar in production-like environments.
An example configuration for excluding panels that install permanent instrumentation.

This also adds the new documentation page to the documentation index.

Closes #2203.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Audit panels instrumentation for production usage

1 participant