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

Этот модуль предоставляет 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 (IO[str]) – Записывать статистику в этот поток. Отключить с помощью 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) – Строка формата для имён файлов профилирования или вызываемый объект, возвращающий имя. См. объяснение выше.

Тип возвращаемого значения

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.