gaogaotiantian/viztracer

어떤 프로젝트인가요?

핵심 기능

• 01소스 코드와 함께 각 함수의 진입과 종료를 타임라인에 기록합니다.
• 02소스 코드를 변경하지 않고 스크립트, 모듈, 콘솔 스크립트를 실행해 추적합니다.
• 03threading, multiprocessing, subprocess, asyncio, PyTorch를 지원합니다.
• 04최소 실행 시간, 스택 깊이, 파일 포함·제외 필터를 제공합니다.
• 05원격으로 실행 중인 Python 프로세스에 연결할 수 있습니다.
• 06Linux, macOS, Windows에서 사용할 수 있습니다.

활용 사례

• 멀티스레드 또는 비동기 Python 프로그램에서 예상과 다른 제어 흐름을 디버깅할 때.
• 느린 스크립트의 실행 시간을 주로 차지하는 함수 호출을 찾을 때.
• GPU 이벤트를 포함해 PyTorch 모델의 실행을 살펴볼 때.
• 장시간 실행 중인 프로세스에 연결해 동작을 조사할 때.

빠른 시작

1. 1

   pip으로 VizTracer 설치하기

   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의 마지막 커밋은 2026년 9월 26일입니다.

viztracer은(는) 어디에 사용할 수 있나요?

멀티스레드 또는 비동기 Python 프로그램에서 예상과 다른 제어 흐름을 디버깅할 때. 느린 스크립트의 실행 시간을 주로 차지하는 함수 호출을 찾을 때. GPU 이벤트를 포함해 PyTorch 모델의 실행을 살펴볼 때. 장시간 실행 중인 프로세스에 연결해 동작을 조사할 때.

viztracer는 어떻게 설치하나요?

pip으로 VizTracer 설치하기: pip install viztracer 명령줄에서 스크립트 추적하기: viztracer my_script.py arg1 arg2 생성된 result.json을 뷰어에서 열기: vizviewer result.json

viztracer은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/gaogaotiantian/viztracer