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

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

class werkzeug.middleware.profiler.ProfilerMiddleware(app, stream=sys.stdout, 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 и должен вернуть строку имени файла. Словарь environ также будет содержать поле "werkzeug.profiler", содержащее словарь со следующими полями (в будущем может быть добавлено больше): - {elapsed} - Время выполнения запроса в миллисекундах. - {time} - Время запроса.

Параметры:

• 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)

Журнал изменений

Изменено в версии 3.0: Добавлен ключ "werkzeug.profiler" к параметру filename_format(environ) с полями elapsed и time.

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

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

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