언리얼 인사이트 트레이스 퀵스타트 가이드

언리얼 인사이트 구성

언리얼 인사이트(Unreal Insights) 를 빌드할 때는 여러 옵션을 사용할 수 있습니다.

옵션 1: 탐색기에서 언리얼 인사이트 실행

Engine\Binaries\Win64\UnrealInsights.exe 로 이동하여 사전에 생성된 언리얼 인사이트 사본이 있는지 확인합니다.

옵션 2: Visual Studio에서 빌드

솔루션 탐색기(Solution Explorer) 의 프로그램 디렉터리에서 언리얼 인사이트를 빌드할 수 있습니다.

옵션 3: 명령 프롬프트(Command Prompt)에서

시작(Start) > 명령 프롬프트(Command Prompt) 로 이동한 다음 명령 디렉터리에서 언리얼 인사이트를 빌드합니다.

		cd C:\MyEngineInstallLocation\

		Engine\Build\BatchFiles\RunUBT.bat UnrealInsights Win64 Development

Copy full snippet

옵션 4: 에디터에서

툴(Tools) > UNREAL INSIGHTS > 언리얼 인사이트 실행(Run Unreal Insights) 으로 이동하여 언리얼 에디터 에서 언리얼 인사이트를 시작합니다. 인사이트는 자동으로 컴파일을 시도합니다.

트레이스를 실행하여 프로젝트 데이터를 프로파일링할 때 언리얼 엔진 빌드와 운영 체제에 따라 다양한 워크플로 옵션을 사용할 수 있습니다.

디폴트 트레이싱 워크플로(Win64, 바이너리 런처)

1. 언리얼 인사이트 실행:

Engine\Binaries\Win64 폴더로 이동한 다음 UnrealInsights.exe 파일을 더블클릭합니다.

2. 인사이트 세션 브라우저:

언리얼 인사이트(Unreal Insights) 세션 브라우저(Session Browser) 를 실행하면 현재 사용 가능한 라이브 세션이 없다는 것을 알 수 있습니다.

3. 게임 프로젝트 실행:

운영 체제에서 명령 프롬프트(Command Prompt) 를 실행하고 라이라 게임 샘플을 실행합니다.

cd C:\MyEngineInstallLocation\

Samples\Games\Lyra\Binaries\Win64\LyraGame.exe

4. 라이브 인사이트 세션 브라우저:

언리얼 인사이트 세션 브라우저로 돌아가서 새 세션이 녹화 중임을 나타내는 'LIVE' 상태로 보이는지 확인합니다.

5. 트레이스 상태 확인:

라이라에서 물결표 키(`)를 두 번 눌러 콘솔을 열고 다음 명령을 입력합니다.

    Trace.Status
Copy full snippet

Gpu , Bookmark , Frame , Cpu, Log 채널은 기본으로 활성화됩니다.

6. 트레이스 세션 열기:

언리얼 인사이트 세션 브라우저로 이동한 다음 .utrace 파일을 더블클릭하여 새 언리얼 타이밍 인사이트(Timing Insights) 창에서 분석하기 위해 엽니다.

트레이스를 열면 언리얼 인사이트의 새 인스턴스가 실행됩니다. 타이밍 인사이트(Timing Insights)는 디폴트 컴포넌트이며, 이를 통해 트레이스 세션과 상호작용하며 프로젝트에서 각종 태스크에 얼마나 많은 시간을 소요하는지 볼 수 있습니다.

데이터를 확인하고 분석하는 방법을 자세히 알아보려면 타이밍 인사이트 문서를 참고하세요.

고급 트레이싱 컨트롤

언리얼 인사이트가 제공하는 몇 가지 트레이스 명령으로 데이터가 프로파일링되는 방식을 제어할 수 있습니다.

• Trace.SnapshotFile <파일명> : 현재 메모리 내 트레이스 버퍼의 스냅샷을 파일로 작성합니다. 이미 트레이싱이 활성 중인 경우 활성 트레이스를 방해하지 않고 이 스냅샷을 위해 병렬로 두 번째 트레이스 파일을 기록합니다.

• Trace.Bookmark <이름> : 주어진 스트링 이름으로 북마크 이벤트를 생성합니다. 북마크는 타이밍 인사이트에서 북마크가 기록된 시점에 수직선으로 나타납니다. 이전에는 TRACE_BOOKMARK() API를 통해서만 사용할 수 있었습니다.

• Trace.Screenshot <이름> <bIncludeUI> : 앞서 언급했듯, 이 콘솔 명령을 실행하여 타이밍 인사이트에서 스크린샷에 대한 true나 false를 지정하여 수직선을 생성하고 선택적으로 UI를 포함시킬 수 있습니다.

CPU 또는 GPU 프로파일링 데이터 등 특정 트레이스 채널에 대한 비저빌리티가 필요하거나 특정 채널의 트레이싱을 비활성화해야 하는 경우도 있습니다. Trace 명령에 대한 추가 정보는 트레이스 및레퍼런스 문서를 참고하세요.

늦은 연결

프로젝트를 실행하기 전에 UnrealInsights.exe 파일을 실행하는 것을 잊었거나, 처음에는 트레이싱을 하지 않았지만 기록하고 싶은 상황이 발생하는 경우가 생길 수 있습니다. 다음 단계에 따라 언리얼 인사이트의 늦은 연결(Late Connect) 을 수행할 수 있습니다.

	Trace.Stop
Copy full snippet

1. 평소와 같이 프로젝트를 빌드 , 쿠킹 또는 실행 합니다.

2. 언리얼 인사이트(Unreal Insights) 를 엽니다.

3. 연결(Connection) 을 클릭하여 연결 탭을 엽니다. 원하는 연결 세팅을 선택하고 연결(Connect) 을 클릭합니다.

연결에 성공하면 트레이스 스토어(Trace Store) 탭을 클릭합니다. 세션 목록에 새 LIVE 세션이 표시될 것입니다.