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

Этот модуль предоставляет 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 и должен вернуть имя файла.

Parameters

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

Return type

None

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

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

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

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

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