지원 매트릭스
hapti 0.0.6에서 검증된 항목입니다. 여기 없는 것은 검증되지 않았습니다.
범례 — ✅ 지원 · 🟡 제한적 · ❌ 미지원
OS·커널·드라이버·펌웨어를 포함한 스택 전체 조합은
SDK 설치 가이드에 있습니다. 이 페이지는 프로파일러 자체가
지원하는 범위를 다룹니다.
플랫폼
| 항목 |
상태 |
비고 |
| Linux, x86_64 |
✅ |
LD_PRELOAD 기반으로 동작 |
| Python 3.10 – 3.12 |
✅ |
|
Runtime (hart) 0.0.6 |
✅ |
|
| 디바이스 트레이싱 |
✅ |
|
| Windows, macOS |
❌ |
|
| 정적 링크된 대상 |
❌ |
LD_PRELOAD로 가로챌 수 없음 |
수집
| 기능 |
상태 |
비고 |
| 런타임 API 활동 |
✅ |
|
| 메모리 할당 활동 |
✅ |
런타임 활동에 포함되며 바이트 수가 붙음. 할당 디바이스 정보는 기록되지 않음 |
| 하위 계층 호출 활동 |
✅ |
|
| 디바이스 커널 타임라인 |
✅ |
--runtime-trace 또는 --device-trace |
| 디바이스 메모리 전송 타임라인 |
✅ |
|
| 메모리 전송 대역폭 트랙 |
✅ |
H2D·D2H, 4 KiB 이상 |
| 커널별 하드웨어 카운터 |
🟡 |
--device-trace. 기본은 core 0의 20개, 최대 32개 |
| 시그널 로거 |
✅ |
--device-trace |
| 호스트-디바이스 상관관계 |
✅ |
|
| 사용자 주석 |
✅ |
haprof 경로 |
| 프로파일러 오버헤드 |
❌ |
레코드 타입은 있으나 기록되지 않음 |
| 도메인별 활동 선택 |
❌ |
플래그가 파싱되지만 무시됨 |
| 이미 실행 중인 프로세스 프로파일링 |
❌ |
설정이 프로세스 시작 시점에 고정 |
| 실행 도중 시작·중지 |
❌ |
haprof는 프로세스 단위. 구간 단위는 Kineto 플러그인 |
| 트레이스당 디바이스 둘 이상 |
❌ |
디바이스 하나에서만 수집. HAPTI_TOOL_DEVICE_ID로 선택 |
CLI 옵션
옵션별 상태와 효과는 CLI: 옵션 상태에 있습니다.
| 옵션 |
상태 |
비고 |
--runtime-trace, --device-trace |
✅ |
|
--profile-children, --preload, --no-execv |
✅ |
|
-o, -d, -f, --log-level |
✅ |
|
도메인별 --*-trace, --external-correlation |
❌ |
파싱되지만 경고 없이 무시 |
haprof merge |
✅ |
|
출력
| 형식 |
상태 |
비고 |
Perfetto .pftrace |
✅ |
|
Chrome JSON .json |
✅ |
|
| 형식 하나만 선택 |
✅ |
-f |
| 사용자 지정 경로나 이름 |
✅ |
-d, -o |
카운터
|
|
| 카운터 블록 |
6개 — AXIBRG, CDMA, DMC, UTIL, CGDMA, MPU |
| 이벤트 |
41개 |
| 실행당 등록 |
최대 32개, 기본 20개 |
| 샘플링 |
커널 실행마다 |
| 표현 방식 |
적용 대상 |
| 실행별 델타 |
AXIBRG, CDMA, CGDMA, MPU |
| 원시 값 |
DMC |
sample_total 대비 백분율 |
UTIL |
| 파생 대역폭과 stall 분해 |
CGDMA, AXIBRG |
| 뱅크 편중 |
DMC |
카탈로그와 공식은 카운터 레퍼런스에 있습니다.
멀티 프로세스
| 기능 |
상태 |
비고 |
| fork·exec 자식 |
✅ |
--profile-children. 프로세스마다 트레이스 하나 |
| 같은 장비의 트레이스 병합 |
✅ |
haprof merge. 클럭을 공유하므로 정확히 정렬 |
| Straggler 리포트 |
✅ |
haprof merge. 랭크별 .json 필요 |
| 장비 간 트레이스 병합 |
🟡 |
이어 붙이기는 되지만 클럭을 보정하지 않음. 리포트에 cross-node: yes 경고와 프로세스별 클럭 오프셋 출력 |
연동
| 연동 |
상태 |
비고 |
| Perfetto UI |
✅ |
|
| Chrome tracing |
✅ |
|
| Kineto를 통한 PyTorch 프로파일러 |
✅ |
hapti.kineto.register() |
| Kineto 경로 디바이스 타임라인 |
✅ |
|
| Kineto 경로 하드웨어 카운터 |
❌ |
haprof --device-trace를 사용 |
Kineto 경로 hapti 주석 |
❌ |
torch.profiler.record_function()을 사용 |
haprof와 Kineto 플러그인 동시 사용 |
❌ |
디바이스 레코드 링은 하나만 열 수 있음 |
| 자체 수집 도구 작성(C++ API) |
❌ |
공개 API를 제공하지 않음. haprof나 Kineto 플러그인을 사용 |
| 트레이스 로드나 조회 API |
❌ |
Perfetto를 쓰십시오 |
알려진 제약
- 도메인별 트레이스 플래그가 파싱되지만 전달되지 않습니다. 경고 없이 아무 동작도 하지
않으며, 호스트 측 활동 종류는 항상 전부 수집됩니다. 디바이스 데이터 포함 여부는
--runtime-trace 또는 --device-trace로 고르십시오.
- 설정이 프로세스 시작 시점에 고정됩니다. 이미 실행 중인 프로세스를 프로파일링하거나, 실행 도중 시작·중지하거나, 설정을 바꿀 수 없습니다. 구간
단위로 수집해야 한다면 Kineto 플러그인의
profile()
구간을 쓰거나, 주석으로 분석 구간을 표시하십시오.
- 트레이스당 디바이스 하나입니다. 다른 디바이스는
HAPTI_TOOL_DEVICE_ID로 고르고, 랭크마다
디바이스가 하나인 멀티 랭크 실행은 --profile-children으로 랭크별 트레이스를 남기십시오.
- 트레이스는 프로세스 종료 시 기록됩니다. 강제 종료는 쓸 만한 결과를 남기지 않습니다.
SIGKILL 대신 인터럽트 시그널을 보내 정상 종료시키십시오.
- 프로파일러 오버헤드는 기록되지 않습니다. 프로파일러 없이 실행한 결과와 비교해 오버헤드
범위를 확인하십시오.
- 메모리 할당 레코드에 할당 디바이스가 기록되지 않습니다. 멀티 디바이스 프로세스에서는 할당
위치를 트레이스만으로 구분할 수 없으며, 현재 우회 방법은 없습니다.
- CGDMA 대역폭과 UTIL 활용률은 추정치이며 측정값이 아닙니다. 실행 회차 간 비교에만 쓰고,
UTIL 활용률은 stall 분해 지표와 교차 확인하십시오.
- 실행의 첫 회차는 측정 대상이 아닙니다. 커널 로드가 포함되고 카운터 델타에 유효한 기준값이
없습니다. 워밍업 후 정상 상태 회차를 프로파일하십시오.
- 여러 디바이스를 쓰는 Kineto 세션에서는 가장 낮은 번호의 디바이스만 이름 있는 행을
가집니다. 미검증 조합이 많으므로 멀티 디바이스는
haprof --profile-children을 권장합니다.
각 제약의 영향과 우회 방법은 릴리즈 노트의 알려진 문제에 표로
정리되어 있습니다.
함께 보기