언리얼 인사이트 레퍼런스 | 언리얼 엔진 4.27 문서

사용자는 언리얼 인사이트(Unreal Insights)와 함께 제공되는 수많은 기능을 최대한 활용하기 위해 매크로와 명령줄 옵션으로 프로젝트의 출력을 커스터마이징할 수 있습니다. 또한 마우스 및 키보드 입력 단축키는 사용자가 인사이트 창을 보다 효율적으로 탐색하게 해줍니다.

매크로

언리얼 인사이트 툴에서 보려는 데이터에 따라 어떤 매크로를 조정해야 할지 결정하려면 다음 테이블을 참조합니다:

매크로 이름	기본 상태	소스 파일	영역 설명
`UE_TRACE_ENABLED`	켜짐	`Engine/Source/Runtime/TraceLog/Public/Trace/Config.h`	전체 시스템의 완전한 제어
`LOGTRACE_ENABLED`	켜짐	`Engine/Source/Runtime/Core/Public/Logging/LogTrace.h`	로그 메시지를 언리얼 인사이트에 보고할지를 제어
`MISCTRACE_ENABLED`	켜짐	`Engine/Source/Runtime/Core/Public/ProfilingDebugging/MiscTrace.h`	북마크, 프레임, 스레드, 스레드 그룹의 추적을 제어
`CPUPROFILERTRACE_ENABLED`	켜짐	`Engine/Source/Runtime/Core/Public/ProfilingDebugging/CpuProfilerTrace.h`	CPU 타이머 및 타이밍 이벤트의 추적을 제어
`LOADTIMEPROFILERTRACE_ENABLED`	켜짐	`Engine/Source/Runtime/CoreUObject/Public/Serialization/LoadTimeTrace.h`	로드 애셋과 관련된 이벤트의 추적을 제어
`EXPERIMENTAL_STATSTRACE_ENABLED` and `STATSTRACE_ENABLED`	Off	`Engine/Source/Runtime/Core/Public/Stats/StatsTrace.h`	통계 카운터의 추적을 제어. 두 매크로를 모두 '1'로 정의하면 활성화됨
`PLATFORMFILETRACE_ENABLED`	꺼짐 Windows에서는 '켜짐'이 기본값입니다.	`Engine/Source/Runtime/Core/Public/ProfilingDebugging/PlatformFileTrace.h`	파일 활동 추적을 제어(파일 열기, 닫기, 읽기, 쓰기 등)
`GPUPROFILERTRACE_ENABLED`	켜짐	`Engine/Source/Runtime/RHI/Public/GpuProfilerTrace.h`	GPU 타이머 및 타이밍 이벤트 제어
`UE_NET_TRACE_ENABLED`	켜짐	`Engine\Source\Runtime\Net\Core\Public\Net\Core\Trace\NetTrace.h` `Engine\Source\Runtime\Net\Core\Public\Net\Core\Trace\Config.h`	네트워크 패킷 콘텐츠의 추적을 제어

명령줄 옵션

다음과 같은 명령줄 옵션을 매크로와 결합하면 트레이스 데이터가 활성화됩니다:

명령줄 옵션	용도	설명
`-statnamedevents`	`CPUPROFILERTRACE_ENABLED`	이 옵션을 '-trace=cpu'와 결합하면 더 많은 CPU 타이밍 이벤트가 활성화됩니다.
`-trace`	`-trace=channel1,channel2,...`	사용자는 이름이 지정된 그룹으로 이벤트를 분류함으로써 생성할 트레이스 데이터의 양을 관리할 수 있습니다. 예를 들어 '-trace=cpu,frame,bookmark'는 CPU 프로파일러 이벤트, 프레임 마커, 북마크를 활성화합니다.
`-tracehost`	`tracehost=X`	'-tracehost'에 대한 자세한 정보는(TestingAndOptimization/PerformanceAndProfiling/UnrealInsights/Overview)를 참조하세요.

사용 가능한 트레이스 채널:

Log
Bookmark
Frame
CPU
GPU
LoadTime
File
Net

사용 중단되는 명령줄 옵션

다음 명령줄 옵션은 사용 중단 예정입니다(아직 사용 가능하지만 향후 UE 버전에서 삭제될 예정):

명령줄 옵션	필수 매크로	효과
`-cpuprofilertrace`	`CPUPROFILERTRACE_ENABLED`	이 옵션으로 실행하면 타이밍 뷰(Timing View)가 타이밍 이벤트를 포함하는 여러 개의 CPU 스레드 트랙으로 채워집니다.
`-filetrace`	`PLATFORMFILETRACE_ENABLED`	이 옵션으로 트레이스를 생성하면 언리얼 인사이트 툴의 타이머 탭에 2개의 I/O 활동 트랙이 제공됩니다. 해당 트랙을 보려면 'I' 키를 누르거나 '트랙(Tracks)' 드롭다운에서 'I/O 트랙(I/O Tracks)'을 활성화합니다. 이 함수 기능은 4.23에서 실험 중인 기능입니다.
`-loadtimetrace`	`LOADTIMEPROFILERTRACE_ENABLED`	이 옵션을 사용하면 애셋 로딩 인사이트(Asset Loading Insights) 창에 '로딩 - 메인 스레드(Loading - Main Thread)' 트랙과 '로딩 - 비동기 스레드(Loading - Async Thread)' 트랙이 포함됩니다.

UnrealInsights.exe의 명령줄 옵션

명령줄 옵션	용도	설명
'-OpenTraceId'	'-OpenTraceId=id'	'뷰어 모드(Viewer mode)'에서 지정 ID를 분석하도록 언리얼 인사이트를 강제합니다.
'-OpenTraceFile'	'-OpenTraceFile=file.utrace'	'뷰어 모드'에서 지정된 파일을 분석하도록 언리얼 인사이트를 강제합니다.
'-Store'	'-Store=address:port'	지정된 트레이스 스토어에 브라우저를 연결합니다. '-StoreHost=address'와 '-StorePort=port'도 사용할 수 있습니다.

입력 단축키

'Counters(카운터)' 탭은 다음의 두 API 소스로부터 카운터를 표시할 수 있습니다.

API 소스	예시	명령줄 실행인자	참고
통계	`TRACE_STAT_*` macros	`-trace=frame,stats,...` 4.24에서는 `-statstrace`를 사용합니다.	'Engine\Source\Runtime\Core\Public\Stats\StatsTrace.h'에서 '#define EXPERIMENTAL_STATSTRACE_ENABLED 1'으로 활성화합니다.
카운터	`TRACE_COUNTER_*` macros	`-trace=frame,counters,...` 4.24에서는 `-counterstrace`를 사용합니다.	See `Source\Runtime\Core\Public\ProfilingDebugging\CountersTrace.h`.

Learn more in the Stats System Overview.

입력 단축키

모든 입력 수행 및 컨트롤 레퍼런스가 제한되며, 변경될 수 있습니다.

타이밍 인사이트(Timing Insights) 창

다음과 같은 마우스 및 키보드 명령으로 타이밍 인사이트를 좀 더 효율적으로 탐색할 수 있습니다:

프레임(Frames) 패널

입력 단축키	기능
좌클릭	프레임 선택 타이밍 뷰는 선택된 프레임의 중앙에 배치됩니다.
우클릭	수평 패닝
마우스 왼쪽/오른쪽 드래그	수평 줌
마우스 휠	수직 줌
Shift + 마우스 휠	컨텍스트 메뉴 열기

타이밍 패널 입력

입력 단축키	기능
마우스 왼쪽/오른쪽 드래그	수평 또는 수직 패닝
Ctrl + 마우스 왼쪽/오른쪽 드래그	수평 패닝
Shift + 마우스 왼쪽/오른쪽 드래그	수직 패닝
마우스 휠	줌
Ctrl + 마우스 휠	수평 스크롤
Shift + 마우스 휠	수직 스크롤
우클릭	컨텍스트 메뉴 열기 그래프 트랙용 옵션입니다.
타이밍 이벤트 좌클릭	타이밍 이벤트 선택
빈 공간 좌클릭	선택 항목 지우기
Ctrl + 마우스 왼쪽 더블 클릭	선택한 타이밍 이벤트의 시간 범위 선택 ENTER 키를 눌러도 동일한 기능이 수행됩니다.
타임 룰러(Time Ruler) 위에서 마우스 왼쪽/오른쪽 드래그	시간 지역 선택 집계된 상태가 타이머 및 카운터 뷰에서 자동으로 업데이트됩니다.
F	마지막 선택 항목에 프레임을 지정한 다음, 시간 범위와 타이밍 이벤트 간에 교대 마지막 선택 항목은 시간 범위나 타이밍 이벤트일 수 있습니다.
G	그래프 트랙 가시성을 토글하여 게임 및 렌더링 프레임 표시(카운터 시리즈의 자리표시자 포함)
Y	GPU 타이밍 트랙 가시성 토글
Y	CPU 타이밍 트랙 가시성 토글
I	I/O 개요 및 활동 트랙 가시성 토글
O	I/O 활동 트랙에서 파일 활동과 관련된 백그라운드 이벤트의 가시성 토글
L	애셋 로딩 트랙 가시성 토글
C	노멀 모드와 컴팩트 모드 간에 전환하여 타이밍 이벤트의 시각화 방식에 영향을 미침
V	빈 타임라인 자동 숨김 빈 타임라인이란 타이밍 이벤트가 없는 타임라인을 말합니다.
B	북마크 가시성 토글 북마크는 기본적으로 표시됩니다.
M	타임 마커(북마크만이 아닌 모든 트레이스 로그) 가시성 토글 타임 마커는 기본적으로 표시되지 않습니다.
D	다운샘플링 활성화 이 디버그 함수 기능은 기본적으로 활성화됩니다.
**-/+	줌
Ctrl + 왼쪽/오른쪽/위/아래 화살표	수평 및 수직 패닝
왼쪽/오른쪽/위/아래 화살표	자신의 이전 또는 다음 형제/부모/가장 큰 자손인 타이밍 이벤트 선택
Enter	선택한 타이밍 이벤트의 시간 범위 선택 Ctrl + 마우스 왼쪽 더블 클릭으로도 동일한 기능이 수행됩니다.

네트워킹 인사이트 창

다음과 같은 마우스 및 키보드 명령으로 네트워킹 인사이트를 좀 더 효율적으로 탐색할 수 있습니다:

입력 단축키	기능
패킷 좌클릭	해당 패킷 선택
여러 패킷을 Shift + 좌클릭	패킷 범위 선택
Ctrl + A	모든 패킷 선택
왼쪽/오른쪽 화살표	이전/다음 패키지 선택
Shift + 왼쪽/오른쪽 화살표	선택 항목을 왼쪽/오른쪽으로 확대(여러 개의 패키지)
Ctrl + Shift + 왼쪽/오른쪽 화살표	선택 항목을 왼쪽/오른쪽에서 축소(여러 개의 패키지)
이벤트 더블 클릭	패킷 콘텐츠 뷰에서 선택 이벤트를 포함하는 모든 패킷을 하이라이트하고 다른 이벤트는 모두 숨김