언리얼 인사이트 레퍼런스

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

Choose your operating system:

Windows

macOS

Linux

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

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 + 왼쪽/오른쪽 화살표

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

이벤트 더블 클릭

패킷 콘텐츠 뷰에서 선택 이벤트를 포함하는 모든 패킷을 하이라이트하고 다른 이벤트는 모두 숨김
언리얼 엔진 문서의 미래를 함께 만들어주세요! 더 나은 서비스를 제공할 수 있도록 문서 사용에 대한 피드백을 주세요.
설문조사에 참여해 주세요
취소