Profiler Information

Abstract

Profiler 탭은 "지금 메모리를 얼마나 쓰고 있나"를 기기 위에서 바로 보여 주는 계기판입니다. Unity 에디터의 Profiler 창을 대체하지는 못하지만, 에디터를 붙일 수 없는 상황에서 "새고 있는가 아닌가"를 판단하기에는 충분합니다.

숫자가 많지만 볼 것은 세 개

지표	뜻	이렇게 읽는다
Mono Used Size	C# 코드가 new 로 만든 객체가 차지하는 메모리	플레이 중 톱니 모양(올랐다가 GC 때 떨어짐)이면 정상. 톱니의 바닥이 계속 올라가면 누수다
Total Allocated Memory	Unity 엔진이 쓰는 네이티브 메모리 (텍스처·메시·오디오 등)	같은 장면을 반복해도 계속 오르면 에셋이 해제되지 않는 것
Allocated Memory For Graphics Driver	GPU 쪽 메모리	모바일에서 크래시의 주범. 텍스처 해상도·압축을 의심한다

직접 해 보기 — ToyboxNightmare 로 풀링 효과 확인하기

게임을 시작하고 디버거 → Profiler → Summary 를 연다.

적이 몰려오는 동안 Mono Used Size 를 30초쯤 지켜본다. 적과 투사체가 계속 생겼다 사라지는데도 값이 완만하게만 움직인다 — 엔티티가 Instantiate / Destroy 가 아니라 풀에서 재사용되고, 이벤트 인자와 엔티티 데이터도 ReferencePool 로 돌기 때문이다.

Profiler → Reference Pool 로 넘어가 EnemyData 줄을 본다. Acquire 횟수는 계속 오르지만 Unused + Using 합계(실제로 만들어진 객체 수)는 동시 생존 수 근처에서 멈춘다. 수백 번 스폰해도 객체는 십여 개만 만들어졌다는 뜻이다.

게임오버 → 재시작을 몇 번 반복한 뒤 Total Allocated Memory 가 판마다 계단식으로 오르는지 본다. 오르지 않아야 정상이다.

어디까지 믿을 수 있나

•

이 탭의 값은 UnityEngine.Profiling.Profiler API 를 그대로 출력한 것입니다. 숫자 자체는 에디터 Profiler 와 같은 출처입니다.

•

에디터에서 재면 에디터 자체의 메모리가 섞입니다. 절대값은 실기기 빌드에서만 의미가 있고, 에디터에서는 "오르는가 멈추는가"의 추세만 봅니다.

•

함수별 CPU 시간, 드로우 콜 같은 성능 프로파일링은 여기서 못 합니다. 그건 Unity Profiler 를 Development Build 에 연결해서 봅니다.

본문을 읽을 때 주의할 점

•

디버거를 여는 단축키(~)는 없습니다. 화면 왼쪽 위 FPS 아이콘을 클릭합니다. 본문도 고쳐 두었습니다.

•

본문의 "Unity 2018.3+ / 2019.3+ 에서 제공" 같은 버전 분기는 원작이 구버전까지 지원하던 흔적입니다. 이 에디션의 최소 버전(Unity 6)에서는 표의 모든 항목이 항상 표시됩니다.

Profiler Information

Introduction

Profiler Information 기능은 Unity Game Framework의 디버깅 툴킷의 일부로, 실시간 메모리 사용량과 성능 지표를 제공합니다.

이 툴은 개발자가 게임 플레이 중 리소스 소비를 모니터링할 수 있게 하여, 메모리 누수 확인, 성능 문제 추적, 게임 애플리케이션 최적화에 필수적입니다.

일반적인 디버깅 도구에 대한 내용은 Debugger Component 페이지를 참고하세요.

Architecture

Profiler Information 창은 DebuggerComponent 내의 ProfilerInformationWindow 클래스로 구현되어 있습니다.

이 클래스는 ScrollableDebuggerWindowBase 를 상속하여, 표시할 정보가 화면을 넘어설 경우 스크롤 가능한 UI를 제공합니다.

Implementation Details

ProfilerInformationWindow는 Unity의 Profiler API 에 직접 접근하여 메모리 및 성능 지표를 가져옵니다.

핵심 기능은 OnDrawScrollableWindow() 메서드에 있으며, Unity의 IMGUI 시스템을 사용해 프로파일링 정보를 출력합니다.

Profiler Metrics

ProfilerInformationWindow는 프로파일러 상태 정보와 메모리 사용 정보를 표시합니다.

카테고리	지표	코드 엔티티	설명
Status	Supported	Profiler.supported	현재 플랫폼에서 프로파일링 지원 여부
	Enabled	Profiler.enabled	프로파일링이 활성화되어 있는지 여부
	Enable Binary Log	Profiler.enableBinaryLog	바이너리 로그 활성화 여부 및 로그 파일 경로
	Enable Allocation Callstacks	Profiler.enableAllocationCallstacks	할당 콜스택 활성화 여부 (Unity 2019.3+)
	Area Count	Profiler.areaCount	프로파일러 영역 개수 (Unity 2018.3+)
	Max Used Memory	Profiler.maxUsedMemory	사용된 최대 메모리 (Unity 2018.3+)
Memory	Mono Used Size	Profiler.GetMonoUsedSizeLong()	Mono 런타임이 사용 중인 메모리
	Mono Heap Size	Profiler.GetMonoHeapSizeLong()	Mono 런타임 힙의 총 크기
	Used Heap Size	Profiler.usedHeapSizeLong	현재 사용 중인 힙 메모리
	Total Allocated Memory	Profiler.GetTotalAllocatedMemoryLong()	총 할당된 메모리
	Total Reserved Memory	Profiler.GetTotalReservedMemoryLong()	총 예약된 메모리
	Total Unused Reserved Memory	Profiler.GetTotalUnusedReservedMemoryLong()	예약되었으나 사용되지 않은 메모리
	Allocated Memory For Graphics Driver	Profiler.GetAllocatedMemoryForGraphicsDriver()	그래픽 드라이버에 할당된 메모리 (Unity 2018.1+)
	Temp Allocator Size	Profiler.GetTempAllocatorSize()	임시 할당자 크기 (Unity 5.5+)
	Marshal Cached HGlobal Size	Utility.Marshal.CachedHGlobalSize	캐시된 HGlobal 메모리 크기

코드에서는 #if 전처리 지시문을 사용하여 Unity 버전별 호환성을 유지합니다.

#if UNITY_2019_3_OR_NEWER
DrawItem("Enable Allocation Callstacks", Profiler.enableAllocationCallstacks.ToString());
#endif

복사

Platform Considerations

Unity 버전에 따라 지원되는 프로파일링 지표가 다릅니다.

ProfilerInformationWindow 클래스는 전처리 지시문을 통해 이러한 차이를 처리하여 모든 지원 Unity 버전에서 올바르게 동작합니다.

예시:

•

Unity 2019.3+ : 할당 콜스택 정보 제공

•

Unity 2018.3+ : 영역 개수, 최대 사용 메모리 제공

•

Unity 2018.1+ : 그래픽 드라이버 메모리 제공

•

Unity 5.5+ : 임시 할당자 크기 제공

따라서 표시되는 지표는 Unity 버전에 따라 달라집니다.

Using the Profiler Information Window

사용 방법:

씬에 DebuggerComponent 가 부착된 GameObject가 있어야 합니다.

실행 중에 화면 왼쪽 위의 FPS 아이콘을 클릭해 디버거를 엽니다. (단축키는 없습니다.)

디버거 인터페이스에서 Profiler → Summary 탭을 선택합니다.

게임 플레이 도중 실시간으로 메트릭을 모니터링합니다.

Optimization Use Cases

Profiler Information 창은 다음과 같은 상황에서 성능 문제를 파악하는 데 유용합니다:

•

메모리 누수 탐지: "Total Allocated Memory" 값이 계속 증가하고 해제되지 않는 경우 확인

•

관리 코드 최적화: "Mono Used Size" 또는 "Mono Heap Size"가 크다면 과도한 GC나 비효율적 관리 코드 사용 가능성

•

그래픽 메모리 사용량 추적: "Allocated Memory For Graphics Driver" 값으로 텍스처, 메시, 렌더 타겟의 GPU 메모리 사용량 확인

•

메모리 단편화 확인: "Total Reserved Memory" 와 "Total Unused Reserved Memory" 비교로 단편화 여부 파악

Related Debugging Tools

게임 성능을 종합적으로 분석하려면 Profiler Information 창과 함께 다음 툴도 활용하세요:

•

Graphics Information Window : 그래픽 디바이스, 기능, 렌더링 설정 상세 정보 제공

•

Scene Information Window : 로드된 씬 개수, 활성 씬의 이름·경로·빌드 인덱스 등 씬 정보 제공

•

Runtime Memory Information Window : 시스템별 메모리 사용 상세 내역 제공

•

Console Window : 로그, 경고, 에러 표시 → 특정 이벤트와 성능 문제 연관성 확인