메모리 프로파일러 모듈

Unity에서 애플리케이션의 메모리 사용량을 분석하는 방법에는 다음의 두 가지가 있습니다.

• 메모리 프로파일러 모듈: 애플리케이션이 메모리를 사용하는 위치에 대한 기본 정보를 제공하는 빌트인 프로파일러 모듈
• 메모리 프로파일러 패키지: 프로젝트에 추가할 수 있는 Unity 패키지입니다. Unity 에디터에 메모리 프로파일러 창을 추가하여 애플리케이션의 메모리 사용량을 더 자세히 분석하는 데 사용할 수 있습니다. 스냅샷을 저장하고 비교하여 메모리 누수를 찾거나 메모리 레이아웃을 확인하여 메모리 단편화 문제를 찾을 수 있습니다.

이 페이지는 빌트인 메모리 프로파일러 모듈에 대한 정보를 다룹니다. 메모리 프로파일러 패키지에 대한 자세한 내용은 메모리 프로파일러 문서를 참조하십시오.

메모리 프로파일러 모듈은 애플리케이션에 할당된 전체 메모리를 나타내는 카운터를 시각화합니다. 메모리 모듈을 사용하여 로드된 오브젝트의 수와 카테고리별로 해당 오브젝트가 차지하는 메모리 양 같은 정보를 볼 수 있습니다. 또한 프로파일러 프레임당 GC 할당 수도 확인할 수 있습니다.

에디터에서 메모리 프로파일링

When you profile your application in the Editor, the Memory Profiler module reports higher data use than a similar profile of the application built on a target device would. This is because the Unity Editor uses specific objects that take up memory, and the Editor window itself uses extra memory.

Part of the extra memory use is because Unity treats objects like textures as read/write enabled in the Editor and keeps an extra copy of each texture on the CPU. This effectively doubles the reported memory use of textures in the Editor; for a more accurate idea of memory use by textures, profile a built version of your application running on the target platform.

또한 Unity는 프로파일러 자체가 차지하는 메모리를 플레이 모드의 메모리에서 완전히 분리할 수 없기 때문에 프로파일러가 사용하는 메모리도 프로파일러 창에 표시됩니다. 이를 알려주기 위해 프로파일러 타겟을 플레이 모드 또는 에디터로 설정할 때마다 메모리 프로파일러 모듈 세부 정보 창 상단에 경고가 표시됩니다. 애플리케이션에 대한 보다 정확한 숫자와 메모리 사용량을 위해서는 애플리케이션을 실행하려는 타겟 디바이스와 운영체제에서 애플리케이션을 프로파일링해야 합니다. 자세한 내용은 애플리케이션 프로파일링 문서를 참조하십시오.

차트 카테고리

메모리 프로파일러 모듈에는 메모리를 사용하는 애플리케이션 위치에 대한 세부 정보를 표시하는 카테고리로 나뉩니다. 카테고리의 색상 범례를 클릭하여 표시를 토글할 수도 있습니다.

모듈 세부 정보 창

프로파일러 창 하단에 있는 모듈 세부 정보 창에는 다음과 같은 두 가지 뷰가 있습니다.

• Simple: 프레임당 메모리 통계의 고수준 개요를 표시합니다.
• Detailed: 네이티브 오브젝트에 대한 네이티브 레퍼런스와 Unity의 다양한 보조 시스템을 포함하여 네이티브 오브젝트가 사용한 메모리에 대한 자세한 내용이 포함된 메모리 스냅샷을 캡처합니다.

뷰를 변경하려면 모듈 세부 정보 창의 왼쪽 상단에 있는 드롭다운에서 선택합니다.

간단한 뷰

간단한 뷰는 Unity가 프레임별로 어떻게 메모리를 사용하는지에 대한 개요를 실시간으로 표시합니다. 애플리케이션이 사용하는 총 메모리를 몇 가지 주요 카테고리로 나눕니다. System Used Memory 프로파일러 카운터를 기반으로 Total 값은 운영체제가 애플리케이션에서 사용 중인 것으로 보고하는 메모리의 양을 나타냅니다.

Unity는 운영체제에 너무 자주 메모리를 요청하지 않도록 일부 메모리 풀을 할당용으로 따로 설정합니다. 프로파일러 모듈은 Unity가 예약한 메모리 양과 프로파일러 캡처 시 Unity가 사용한 메모리 양을 표시합니다.

간단한 뷰는 System Used Memory 프로파일러 카운터 내에 수집된 데이터를 표시합니다. 이는 운영체제가 앱에서 사용 중인 것으로 보고하는 메모리 양을 나타내며 Total Committed Memory 바와 Total Memory Breakdown 바의 전체 값에 해당합니다.

운영체제로부터 애플리케이션의 전체 메모리 크기를 가져올 수 있는 플랫폼에서 System Memory Usage는 0을 초과하고 작업 관리자와 같은 크기입니다.

다음 참조 표에서는 간단한 뷰에서 사용할 수 있는 통계와 해당 프로파일러 카운터, 릴리스 빌드의 가용성에 대해 설명합니다. 이 정보는 ProfilerRecorder API와 프로파일러 모듈 에디터에서도 제공하므로 커스텀 프로파일러 모듈에 추가할 수 있습니다.

플레이어의 가용성

You can use the ProfilerRecorder API to access the Memory Profiler module’s counters in Players. The following example contains a simple script that collects Total Reserved Memory, GC Reserved Memory and System Used Memory metrics, and displays those as a GUI.TextArea. The Memory Profiler module information belongs to the ProfilerCategory.Memory Profiler category.

using System.Text;
using Unity.Profiling;
using UnityEngine;

public class MemoryStatsScript : MonoBehaviour
{
    string statsText;
    ProfilerRecorder totalReservedMemoryRecorder;
    ProfilerRecorder gcReservedMemoryRecorder;
    ProfilerRecorder systemUsedMemoryRecorder;

    void OnEnable()
    {
        totalReservedMemoryRecorder = ProfilerRecorder.StartNew(ProfilerCategory.Memory, "Total Reserved Memory");
        gcReservedMemoryRecorder = ProfilerRecorder.StartNew(ProfilerCategory.Memory, "GC Reserved Memory");
        systemUsedMemoryRecorder = ProfilerRecorder.StartNew(ProfilerCategory.Memory, "System Used Memory");
    }

    void OnDisable()
    {
        totalReservedMemoryRecorder.Dispose();
        gcReservedMemoryRecorder.Dispose();
        systemUsedMemoryRecorder.Dispose();
    }

    void Update()
    {
        var sb = new StringBuilder(500);
        if (totalReservedMemoryRecorder.Valid)
            sb.AppendLine($"Total Reserved Memory: {totalReservedMemoryRecorder.LastValue}");
        if (gcReservedMemoryRecorder.Valid)
            sb.AppendLine($"GC Reserved Memory: {gcReservedMemoryRecorder.LastValue}");
        if (systemUsedMemoryRecorder.Valid)
            sb.AppendLine($"System Used Memory: {systemUsedMemoryRecorder.LastValue}");
        statsText = sb.ToString();
    }

    void OnGUI()
    {
        GUI.TextArea(new Rect(10, 30, 250, 50), statsText);
    }
}

다음 스크린샷은 Tanks! 튜토리얼 프로젝트에 스크립트를 추가한 결과를 보여줍니다.

이 정보는 위의 표에 있는 다른 고수준 카운터와 마찬가지로 릴리스 플레이어에서 사용할 수 있습니다. 프로파일러 창의 커스텀 모듈에서 선택한 메모리 카운터를 보려면 모듈 에디터를 사용하여 차트를 구성하십시오.

세부 정보 뷰

세부 정보 뷰는 애플리케이션의 현재 상태에 대한 스냅샷을 제공합니다. Take Sample 버튼을 선택하여 현재 타겟에 대한 자세한 메모리 사용량을 캡처할 수 있습니다. 이 데이터를 가져오는 데 프로파일러 시간이 걸리므로 세부 정보 뷰는 실시간 세부 정보를 제공하지 않습니다. 프로파일러가 샘플을 수집한 후 프로파일러 창에 애플리케이션의 메모리 사용량을 더 자세히 살펴볼 수 있는 리스트 뷰가 표시됩니다.

모듈 세부 정보 창 상단에서 Gather Object References 설정을 활성화하여 스냅샷 시점에 오브젝트를 참조하는 항목에 대한 정보를 수집합니다. 프로파일러 창의 오른쪽에 이 정보를 표시합니다.

리스트 뷰는 메모리를 사용하는 오브젝트를 다음 카테고리로 구분합니다.

• Other: 에셋, 게임 오브젝트 또는 컴포넌트가 아닌 오브젝트입니다. Unity가 다양한 시스템에 사용하는 메모리 양 등과 같은 정보가 여기에 표시됩니다.
• Not Saved: DontSave로 표시된 게임 오브젝트
• Builtin Resources: Unity 에디터 리소스 또는 Unity 기본 리소스(예: 그래픽스 설정의 항상 포함된 셰이더 리스트에 추가한 셰이더).
• Assets: 사용자 또는 네이티브 코드에서 참조된 에셋입니다.
• Scene Memory: 오브젝트 및 연결된 컴포넌트

에셋 또는 씬 메모리 리스트에서 게임 오브젝트를 클릭하면 Unity는 프로젝트 뷰 또는 씬 뷰에서 강조 표시합니다.

참고: Other 카테고리에서 System.ExecutableAndDlls에 보고된 메모리는 읽기 전용 메모리입니다. 운영체제는 필요에 따라 해당 페이지를 폐기하고 나중에 파일 시스템에서 다시 로드할 수 있습니다. 그러면 메모리 사용량이 줄어들고 애플리케이션이 너무 많은 메모리를 사용하는 경우 운영체제에서 해당 애플리케이션을 종료하기로 결정하는 직접적인 원인이 되지 않습니다. 일부 페이지는 동일한 프레임워크를 사용하는 다른 애플리케이션과 공유될 수도 있습니다.