모바일 GPU 프로파일링 (Mali 및 Adreno 하드웨어 카운터)은(는) 무엇을 하나요?
mobile-3d-rendering은 외부에서 측정합니다: fps, 메모리, 온도 및 엔진 카운터.
이 스킬은 GPU를 열고 하드웨어 카운터를 읽습니다. 질문에 답합니다: GPU가 정말 한계인가요?
만약 그렇다면, 픽셀, 정점, 텍스처, 대역폭 또는 셰이더 수학 중 어떤 것 때문인가요? 각각 다른
수정이 필요하므로 추측은 시간 낭비입니다.
언제 사용하는가 (첫 단계가 아니라, 문제 에스컬레이션 시):
mobile-3d-rendering트라이지에서 드로우 콜 예산은 충분한데 fps가 목표치 이하이거나, 드로우 콜과 삼각형을 줄여도 fps가 변하지 않을 때;- 높은 수준의 효과(노멀 맵, MSAA 4x, 블룸 후광, 더 많은 조명)가 기준 폰에서 예산에 맞는지 결정할 때;
- 어떤 셰이더 또는 머티리얼이 비용이 많이 드는지 찾을 때;
- 명백한 원인 없이 발열이 발생할 때 (대역폭 문제가 여기서 드러납니다);
- 한 벤더에서 GPU 측면의 이상 현상이 발생할 때.
항상 마지막에는 기기에서 mobile-3d-rendering/scripts/device_probe.py로 다시 측정합니다
(fps, p95, 메모리 기울기, 온도). 카운터는 설명하고, 프로브는 확인합니다.
0. GPU 감지 및 경로 선택
S=~/.claude/skills/mobile-gpu-profiling/scripts
python3 $S/gpu_profile.py detect # 벤더, GPU, 드라이버, 안드로이드 버전, 화면 크기
| GPU | 카운터 캡처 | 셰이더 비용 | 프레임 캡처 |
|---|---|---|---|
| Arm Mali / Immortalis | gpu_profile.py mali-capture (Streamline, 헤드리스) | malioc_batch.py (Mali Offline Compiler) | Frame Advisor, RenderDoc for Arm GPUs |
| Qualcomm Adreno | Snapdragon Profiler Realtime/Trace (GUI), 또는 Android 11+ 지원 기기에서 AGI | Adreno 오프라인 컴파일러 (가능한 경우) 또는 SDP 셰이더 통계 | Snapdragon Profiler Snapshot, AGI 프레임 프로파일러 |
| 기타 (PowerVR, Xclipse) | 벤더 도구 / AGI; gpu_profile.py gpu-busy | — | RenderDoc / AGI |
각 도구 설치 방법: references/arm-performance-studio.md, references/adreno.md.
앱은 디버깅 가능한 빌드여야 합니다 (Godot: 디버그 내보내기; Unity: Development Build;
android:debuggable="true").
1. Mali: 카운터 캡처 및 읽기
python3 $S/gpu_profile.py mali-capture -p <패키지> -s 30 -o gpu-profile-<이름>
# 첫 번째 실행 시 해당 GPU에 대한 Arm 템플릿에서 카운터 구성을 빌드합니다 (~/.cache/mobile-gpu-profiling에 캐시됨)
# 스크립트가 앱을 실행합니다; 측정하려는 장면을 재생합니다 (최악의 경우: 군중, 전투, 밤)
python3 $S/gpu_profile.py mali-analyze gpu-profile-<이름>/capture.apc --fps 60 # 나중에 다시 읽기
report.md + metrics.json 파일을 생성합니다. 상단의 진단 결과를 읽고, 그 다음 숫자들을 확인합니다.
| 메트릭 | 중간급 폰에서 양호 | 그렇지 않을 경우 |
|---|---|---|
gpu_util | 목표 fps에서 < 75–80% (열 헤드룸) | > 85%: GPU 바운드, 다음 행을 읽으세요. < 60%에서 낮은 fps: CPU 바운드이므로 CPU를 프로파일링하세요 |
fragment_queue_util vs non_fragment_queue_util / tiler_util | — | 100%에 가까운 쪽이 한계입니다: 프래그먼트 = 픽셀당 비용; 논프래그먼트/타일러 = 정점, 삼각형, 그림자 캐스터 |
fragments_per_screen_pixel | < 2.0 (모든 패스) | 오버드로우, 섀도우 맵, 추가 렌더 패스 (render_passes_per_frame 참조) |
alu_instr_per_fragment | Bifrost에서 < 20–30 | 무거운 프래그먼트 셰이더 → §2 |
tex_compressed_share / tex_mipmapped_share | 씬 텍스처에 대해 높음 | 압축되지 않음/밉맵 없는 텍스처는 대역폭과 캐시를 낭비합니다 (섀도우 맵과 렌더 타겟은 절대 압축되지 않으므로 어떤 텍스처가 지배적인지 확인) |
late_zs_test_share | < 10% | discard/알파 테스트, 또는 셰이더 깊이 쓰기, 조기-Z 비활성화 |
early_zs_kill_rate, fpk_occluding_share | 높을수록 좋음 | 불투명체를 앞에서 뒤로 정렬; 큰 표면에서 discard 사용 피하기 |
bandwidth_mb_per_frame | 2018–2020 폰에서 60 fps 기준 < ~30–40 MB | 렌더 타겟, 압축되지 않은 텍스처, MSAA 리졸브 → 발열 |
facing_culled_share | 닫힌 메시에서 ~40–50% | 양면 머티리얼이 정점 작업을 두 배로 늘림 |
fp16_varying_share | 높음 | mediump varyings는 보간 비용을 절반으로 줄임 |
전체 카운터-수정 참조표와 공식은 references/mali-counters.md에 있습니다.
프레임 마커: Performance Advisor의 프레임별 HTML 보고서에는 Arm 레이어의 프레임 경계가 필요합니다.
Arm은 Android 11+를 지원합니다. Android 10 (Galaxy Note 9에서 테스트)에서는 카운터가 작동하지만
레이어의 프레임이 gatord에 도달하지 않아 스크립트는 캡처 중 SurfaceFlinger에서 측정한 fps로
초당 카운터를 대신 사용합니다.
2. 비용이 많이 드는 셰이더 찾기 (모든 엔진, Mali 비용 모델)
# Godot (Compatibility/GLES3): 데스크톱에서 Mesa를 통해 게임이 실제로 컴파일하는 GLSL ES 덤프
HEADLESS=1 $S/godot_dump_shaders.sh <godot_프로젝트> dump/ 20 [res://test_scene.tscn]
python3 $S/malioc_batch.py --core Mali-G72 dump/ --label-src <godot_프로젝트>/shaders --top 15
- 순위는 픽셀당(또는 정점당) 사이클 수와 이를 제한하는 파이프라인(A 산술, LS 로드/스토어, V 베어링, T 텍스처)을 나열합니다. 레이블은 여러분의 셰이더 파일을 식별합니다; "engine"은 내장 머티리얼을 의미합니다.
- 플래그:
occ50은 32개 이상의 작업 레지스터를 의미하므로 절반의 스레드만 실행 중입니다 (레이턴시 은닉이 더 나쁨);SPILL은 스택 스필을 의미함;lateZS는 discard를 의미함;fp16:0%는 16비트 수학이 없음을 의미합니다. - 셰이더 비용 ≈ 사이클 × 적용되는 픽셀 수입니다. 바닥과 건물에 적용된 38사이클 셰이더가 작은 표지판의 60사이클 셰이더보다 중요합니다.
- Unity, three.js 및 Bevy 셰이더 추출:
references/shader-cost.md.
덤프 스크립트는 사용자 데이터의 복사본을 사용하여 게임을 실행하므로 저장 내용과 설정은 건드리지 않고 Godot의 셰이더 캐시가 컴파일을 숨기지 않습니다. 실행 중에 관심 있는 영역을 방문하십시오 (또는 테스트 씬을 전달). Godot은 셰이더 변형을 지연 컴파일합니다.
3. Adreno (Qualcomm)
Snapdragon Profiler 사용: 실시간 메트릭은 Realtime, 타임라인은 Trace, 드로우별 통계가 있는 단일 프레임은 Snapshot을 사용합니다. 해당 메트릭에서 동일한 질문을 읽습니다: % Shaders Busy, % Time Shading Fragments vs Vertices, Avg Bytes / Fragment, % Texture Fetch Stall, % Texture L1 Miss, ALU / Fragment, % Prims Trivially Rejected, Read/Write Total. 메트릭-수정 테이블은 references/adreno.md에 있습니다.
Android 11+ 기기에서 AGI가 지원하는 경우, Android GPU Inspector는 벤더 중립적인 카운터와 프레임 프로파일러를 제공합니다. 도구 없이 빠른 사용률을 읽으려면 gpu_profile.py gpu-busy -s 30이 빌드에서 허용하는 경우 커널의 busy 노드를 읽습니다.
4. 카운터에서 변경 사항으로 (그리고 확인)
-
보고서가 지목하는 가장 큰 제한 요소를 수정하십시오. 한 번에 하나만 변경하십시오.
-
일반적인 매핑:
제한 수정 프래그먼트 바운드 더 적거나 작은 섀도우 맵과 더 짧은 섀도우 거리, 더 적은 투명 오버드로우, 큰 표면에서 더 저렴한 셰이더 (수학을 정점 셰이더로 이동, Low/Medium에서 픽셀당 노이즈/안개/스펙큘러 제거, mediump 사용), 압축+밉맵 텍스처, 안전하다고 입증된 경우에만 내부 해상도 낮춤 (Mali-G72는 렌더 스케일링으로 메모리 누수 발생) 지오메트리/타일러 바운드 LOD 및 가시성 범위, 더 적은 섀도우 캐스터, 후면 컬링 켜기, 군중에 대한 단순화된 스키닝 대역폭/발열 압축된 텍스처, 더 적은 렌더 타겟/패스, 포스트 AA 대신 MSAA, 전체 화면 포스트 없음 CPU 바운드 (GPU < 60% 사용) 드로우 콜, 스크립트, 애니메이션, 물리 ( performance-optimization) -
동일한 장면을 다시 캡처하고
metrics.json을 이전/이후 비교합니다 (프레임당 GPU ms, 제한 요소의 비율). -
기기에서
device_proxy.py로 최소 60초 동안 확인합니다 (fps, p95, 메모리 기울기, 온도). 카운터에서 이겼지만 기기를 가열시키거나 메모리 누수가 발생한다면 승리가 아닙니다. -
프로젝트 노트에 결과를 기록합니다 (무엇이 바운드였는지, 무엇이 수정했는지, 이전/이후 숫자).
실제 캡처에서 얻은 까다로운 규칙
- GPU의 템플릿에서 카운터 구성을 생성하고 기본적으로 GPU 카운터만 유지하십시오. CPU PMU 카운터는 Samsung Android 10 커널에서 캡처 자식 프로세스를 시작 시에 종료시켰습니다.
- Wi-Fi adb는 작동하지만, 기기 ID는
ip:port입니다. 모든 곳에 전달하십시오 (스크립트가 처리합니다). - 충돌한 캡처는
gatord에이전트를 앱의 샌드박스 내에 남겨둘 수 있습니다. 이들은 다음 캡처의 소켓을 차단하고 ("Address already in use") 이를 조기에 종료시킵니다. 스크립트는 PID로 이를 종료합니다 (run-as <pkg> pkill은 작동하지 않았습니다). - 캡처 직전에 앱을 강제 종료하면 1초 후에 캡처가 끝날 수 있습니다. 스크립트는 상황이 안정될 때까지 기다립니다.
Streamline-cli -generate-config는-help텍스트와 달리-template <이름>을 대상 앞에 필요로 합니다.- Godot은 GLES 셰이더 캐시를
user://shader_cache에 유지하므로, 두 번째 데스크톱 실행에서는 아무것도 컴파일하지 않습니다. 새XDG_DATA_HOME을 사용하십시오 (덤프 스크립트가 수행). - 데스크톱에서 실제 게임을 실행하여 감사하면 자동 저장이 기록됩니다. 사용자 데이터 디렉토리를 격리하십시오.
참조
| 파일 | 읽을 때 |
|---|---|
references/arm-performance-studio.md | Streamline, Performance Advisor, Frame Advisor, RenderDoc for Arm, malioc 설치/사용; 헤드리스 파이프라인 세부 정보 |
references/mali-counters.md | 각 Mali 메트릭의 의미, 공식, 임계값, Bifrost vs Valhall vs 5세대 |
references/adreno.md | Snapdragon Profiler / AGI 설정 및 Adreno 메트릭-수정 테이블 |
references/shader-cost.md | Godot/Unity/three.js/Bevy에서 컴파일된 셰이더를 추출하고 malioc 출력을 읽는 방법 |