언리얼 인사이트 레퍼런스

입력 단축키, 매크로, 명령줄 옵션을 설명하는 언리얼 인사이트 레퍼런스입니다.

추가 참고

사용자는 언리얼 인사이트(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.

[](TestingAndOptimization/PerformanceAndProfiling/StatCommands/StatsSystemOverview)

입력 단축키

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

타이밍 인사이트(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 + 왼쪽/오른쪽 화살표

선택 항목을 왼쪽/오른쪽에서 축소(여러 개의 패키지)

이벤트 더블 클릭

패킷 콘텐츠 뷰에서 선택 이벤트를 포함하는 모든 패킷을 하이라이트하고 다른 이벤트는 모두 숨김
언리얼 엔진의 이전 버전을 위해 작성된 페이지입니다. 현재 언리얼 엔진 5 버전을 위해 업데이트되지 않았습니다.