Профилировщик приложений

Этот модуль предоставляет middleware, который профилирует каждый запрос с помощью модуля cProfile. Это может помочь определить узкие места в вашем коде, которые могут замедлять работу приложения.

class werkzeug.middleware.profiler.ProfilerMiddleware(app, stream=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>, sort_by=('time', 'calls'), restrictions=(), profile_dir=None, filename_format='{method}.{path}.{elapsed:.0f}ms.{time:.0f}.prof')

Оборачивает WSGI-приложение и профилирует выполнение каждого запроса. Ответы буферизуются, чтобы обеспечить более точное измерение времени.

Если stream задан, pstats.Stats записываются в него после каждого запроса. Если profile_dir задан, файлы данных cProfile сохраняются в указанном каталоге, по одному файлу на запрос.

Имя файла можно настроить, передав filename_format. Если это строка, она будет отформатирована с использованием str.format() с доступными полями:

• {method} - метод запроса; GET, POST и т. д.
• {path} - путь запроса или ‘root’, если путь не существует.
• {elapsed} - время выполнения запроса.
• {time} - время запроса.

Если это вызываемый объект, он будет вызван с WSGI environ словарем и должен вернуть имя файла.

Параметры:

• app (WSGIApplication) – WSGI-приложение, которое нужно обернуть.
• stream (t.IO[str] | None) – Запись данных статистики в данный поток. Отключение с помощью None.
• sort_by (t.Iterable[str]) – Кортеж столбцов для сортировки данных статистики. См. pstats.Stats.sort_stats().
• restrictions (t.Iterable[str | int | float]) – Кортеж ограничений для фильтрации данных статистики. См. pstats.Stats.print_stats().
• profile_dir (str | None) – Сохранение файлов профилирования в этот каталог.
• filename_format (str) – Строка форматирования для имён файлов профилирования или вызываемый объект, возвращающий имя. См. объяснение выше.

from werkzeug.middleware.profiler import ProfilerMiddleware
app = ProfilerMiddleware(app)

Изменения

Изменено в версии 0.15: Статистика записывается даже если profile_dir задан, и может быть отключена путем передачи stream=None.

Добавлен в версии 0.15: Добавлен filename_format.

Добавлен в версии 0.9: Добавлен restrictions и profile_dir.