콘텐츠로 이동

지원 매트릭스

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을 권장합니다.

각 제약의 영향과 우회 방법은 릴리즈 노트의 알려진 문제에 표로 정리되어 있습니다.


함께 보기