gaogaotiantian/viztracer

Что это?

Ключевые возможности

• 01Записывает вход и выход из функций на временной шкале вместе с исходным кодом.
• 02Запускает скрипты, модули и консольные скрипты без изменения исходного кода.
• 03Поддерживает threading, multiprocessing, subprocess, asyncio и PyTorch.
• 04Предлагает фильтры по минимальной длительности, глубине стека и включению или исключению файлов.
• 05Позволяет удалённо подключаться к работающим процессам Python.
• 06Работает на Linux, macOS и Windows.

Сценарии использования

• Поиск причин неожиданного хода выполнения в многопоточной или асинхронной программе на Python.
• Выявление вызовов функций, на которые приходится основная часть времени выполнения медленного скрипта.
• Анализ выполнения моделей PyTorch, включая события GPU.
• Изучение поведения длительно работающего процесса через подключение к нему.

Быстрый старт

1. 1

   Установите VizTracer с помощью pip

   pip install viztracer
2. 2

   Запустите трассировку скрипта из командной строки

   viztracer my_script.py arg1 arg2
3. 3

   Откройте созданный файл result.json в просмотрщике

   vizviewer result.json

В подборках

Темы

Частые вопросы

Что такое viztracer?

Низконакладной трассировщик Python, который записывает вызовы функций и показывает выполнение кода на интерактивной временной шкале. VizTracer отслеживает выполнение Python-кода и показывает результат на интерактивной временной шкале в браузерном просмотрщике на базе Perfetto. Временная шкала фиксирует вход и выход из каждой функции вместе с её исходным кодом — это помогает разбираться в неожиданном ходе выполнения программы и находить участки, на которые уходит время.

viztracer можно использовать бесплатно? Какая у него лицензия?

viztracer распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

viztracer всё ещё поддерживается?

Обновлялся за последние 6 месяцев. Последний коммит в viztracer — 26 сент. 2026 г..

Для чего можно использовать viztracer?

Поиск причин неожиданного хода выполнения в многопоточной или асинхронной программе на Python. Выявление вызовов функций, на которые приходится основная часть времени выполнения медленного скрипта. Анализ выполнения моделей PyTorch, включая события GPU. Изучение поведения длительно работающего процесса через подключение к нему.

Как установить viztracer?

Установите VizTracer с помощью pip: pip install viztracer Запустите трассировку скрипта из командной строки: viztracer my_script.py arg1 arg2 Откройте созданный файл result.json в просмотрщике: vizviewer result.json

Где скачать viztracer?

Исходный код и инструкции по установке — на GitHub: https://github.com/gaogaotiantian/viztracer