gaogaotiantian/viztracer

O que é?

Recursos principais

• 01Registra a entrada e a saída de funções em uma linha do tempo, junto com o código-fonte.
• 02Executa scripts, módulos e console scripts sem alterar o código-fonte.
• 03Oferece suporte a threading, multiprocessing, subprocess, asyncio e PyTorch.
• 04Disponibiliza filtros de duração mínima, profundidade da pilha e inclusão ou exclusão de arquivos.
• 05Permite se conectar a processos Python remotos em execução.
• 06Funciona no Linux, macOS e Windows.

Casos de uso

• Depurar fluxos de controle inesperados em programas Python multithread ou assíncronos.
• Descobrir quais chamadas de função representam a maior parte do tempo de execução de um script lento.
• Inspecionar a execução de modelos PyTorch, incluindo eventos de GPU.
• Investigar o comportamento de um processo de longa duração conectando-se a ele.

Início rápido

1. 1

   Instale o VizTracer com pip

   pip install viztracer
2. 2

   Rastreie seu script pela linha de comando

   viztracer my_script.py arg1 arg2
3. 3

   Abra o result.json gerado no visualizador

   vizviewer result.json

Em coleções

Tópicos

Perguntas frequentes

O que é viztracer?

Um tracer de Python de baixo overhead que registra chamadas de função e visualiza a execução do código em uma linha do tempo interativa. O VizTracer rastreia a execução de código Python e exibe os resultados como uma linha do tempo interativa em um visualizador no navegador baseado no Perfetto. Cada entrada e saída de função é registrada na linha do tempo junto com o código-fonte, o que ajuda a depurar fluxos de controle inesperados e descobrir onde o tempo está sendo gasto.

viztracer é gratuito? Qual é a licença?

viztracer é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

viztracer ainda é mantido?

Atualizado nos últimos 6 meses. O último commit de viztracer foi em 26 de set. de 2026.

Para que posso usar viztracer?

Depurar fluxos de controle inesperados em programas Python multithread ou assíncronos. Descobrir quais chamadas de função representam a maior parte do tempo de execução de um script lento. Inspecionar a execução de modelos PyTorch, incluindo eventos de GPU. Investigar o comportamento de um processo de longa duração conectando-se a ele.

Como instalar viztracer?

Instale o VizTracer com pip: pip install viztracer Rastreie seu script pela linha de comando: viztracer my_script.py arg1 arg2 Abra o result.json gerado no visualizador: vizviewer result.json

Onde consigo viztracer?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/gaogaotiantian/viztracer