트레이스 컨트롤(Trace Control) 탭은 사용자가 실행 중인 언리얼 엔진(UE) 프로젝트 세션의 트레이스를 시작하고 제어하는 수단을 제공합니다. 사용자는 자체 트레이스 채널 필터를 설정하여 세션의 트레이스 데이터 캡처를 쉽게 제어할 수도 있습니다.
트레이스 컨트롤 탭 찾는 방법
인사이트를 실행하면 열리는 언리얼 인사이트 프론트엔드(Unreal Insights Frontend) 대화창에 트레이스 컨트롤 탭이 있습니다.
이 탭을 열려면 인사이트 를 실행하고 세션 프론트엔드(Session Frontend) 탭을 클릭한 다음, 트레이스 컨트롤(Trace Control) 탭을 클릭합니다.
세션 선택 방법
언리얼 에디터 세션을 선택하려면 세션 프론트엔드 탭의 왼쪽 열에서 실행 중인 세션 중 하나를 클릭합니다. 필요한 만큼 그룹 헤딩을 확장합니다.
세션을 선택하면 트레이스 컨트롤 탭을 업데이트하는 데 몇 초 정도 걸릴 수 있습니다.
다음과 같은 세션이 표시됩니다.
- 언리얼 에디터 세션.
- 플레이(Play) 버튼을 사용하여 실행된 에디터에서 플레이(Play-In-Editor) 세션.
-messaging명령줄 실행인자로 실행된 독립형 세션.
이 목록에 세션이 표시되지 않으면 -messaging 실행인자로 실행했는지 다시 확인합니다.
트레이싱 환경설정 및 제어 방법
세션을 선택하면 해당 세션의 트레이싱을 제어할 수 있습니다.
가장 일반적인 워크플로는 다음과 같습니다.
-
채널 체크박스를 개별적으로 클릭하여 트레이스 데이터를 수집할 채널을 선택하거나 필터 프리셋 드롭다운을 사용하여 공통 채널 그룹을 선택합니다.
-
언리얼 에디터 세션을 트레이싱하기 시작합니다(아래 버튼 2 참조).
트레이싱을 시작하는 즉시 트레이스 스토어(Trace Store) 탭에 항목이 표시되고 인사이트에서 분석할 수 있는 새 트레이스 데이터가 열립니다.
다음 테이블에서는 사용할 수 있는 모든 옵션의 전체 분석을 제공합니다.
| 엘리먼트 | 이름 | 설명 |
|---|---|---|
| 1 | 트레이스 타깃 | 세션의 트레이스 데이터를 기록할 위치를 환경설정합니다. 다음 중에서 선택합니다.
이 세팅은 트레이싱이 이미 실행 중일 때는 변경할 수 없습니다(2번 참조). |
| 2 | 트레이스 시작/중지 | 선택한 채널의 트레이스 데이터를 수집하기 시작하거나 중지합니다. 트레이싱을 시작하는 즉시 트레이스 스토어 탭에 라이브(LIVE) 상태로 라벨링된 항목이 표시됩니다. 그런 다음, 세션을 열어 인사이트에서 분석할 수 있습니다. |
| 3 | 스냅샷 저장 | 세션의 트레이스 스냅샷을 찍습니다. 스냅샷은 트레이스 스토어 탭에 표시되고, 스냅샷을 열면 분석할 수 있습니다. |
| 4 | 트레이스 채널 일시정지/재개 | 선택한 트레이스 채널을 모두 비활성화합니다. 이 버튼을 다시 클릭하면 이전에 선택한 모든 채널이 다시 활성화되고 재개됩니다. |
| 5 | 북마크 트레이스 | 트레이싱이 실행 중이면 트레이스 데이터에서 TRACE_BOOKMARK 이벤트를 내보냅니다. 이벤트 이름은 생성 시점의 타임스탬프를 토대로 명명됩니다. |
| 6 | 스크린샷 찍기 | 트레이싱이 실행 중이면 실행 중인 세션의 사진을 찍고 트레이스 데이터에 포함시킵니다. 스크린샷 이름은 생성 시점의 타임스탬프를 토대로 명명됩니다. |
| 7 | 통계 명명된 이벤트 활성화/비활성화 | 통계 명명된 이벤트의 트레이싱을 활성화하거나 비활성화합니다. 이러한 이벤트는 프로파일링 메트릭을 추가로 제공하면서 추가적인 오버헤드 비용을 발생시킵니다. |
| 8 | 필터 프리셋 | 채널 그룹을 활성화하거나 비활성화합니다. 자세한 내용은 이 페이지의 프리셋 채널 필터 설정 방법을 참조하세요. |
| 9 | 채널 검색 | 아래 11번의 트레이스 채널에 표시된 트레이스 채널을 검색합니다. |
| 10 | 필터 프리셋 토글 | 선택한 모든 필터 프리셋이 여기 표시되며 개별적으로 켜거나 꺼서 채널 그룹을 활성화하거나 비활성화할 수 있습니다. |
| 11 | 트레이스 채널 | 데이터를 캡처할 트레이스 채널들을 개별적으로 활성화하거나 비활성화합니다. 회색으로 표시된 채널은 트레이싱을 활성화한 상태로 실행한 세션에서만 지원되며, 이 뷰에서는 활성화할 수 없습니다. 이러한 채널 중 가장 주목할 채널은 메모리 트레이싱입니다. |
| 12 | 트레이스 정보 | 현재 세션 정보로 다음과 같은 정보가 표시됩니다.
|
프리셋 채널 필터 설정 방법
프리셋 채널 필터를 사용하면 편리하게 한 번의 클릭으로 트레이스 채널을 활성화하거나 비활성화할 수 있습니다. 필터 프리셋(Filter Presets) 드롭다운을 사용하여 이러한 필터를 환경설정할 수 있습니다. 각 옵션의 자세한 내용은 아래 테이블을 참조하세요.
| 엘리먼트 | 이름 | 설명 |
|---|---|---|
| 1 | 프리셋 리셋(Reset Presets) | 현재 선택한 프리셋 필터를 삭제합니다(트레이싱 환경설정 섹션의 10번 참조). |
| 2 | 사용자 프리셋으로 저장(Save as User Preset) | 현재 선택한 채널을 새로운 프리셋 필터로 저장합니다. |
| 3 | 엔진 프리셋(Engine Presets) | 사용자가 프로파일링하려는 공통 영역을 기반으로 필터 프리셋을 선택합니다. 이러한 엔진 프리셋은 다음에 정의되어 있습니다.
|
| 4 | 사용자 프리셋(User Presets) | 사용자 정의 필터 프리셋을 선택합니다. 이러한 프리셋은 인사이트의 로컬 |
| 5 | 사용자 프리셋 이름변경(Rename User Preset) | 이 사용자 필터의 이름을 변경합니다. |
| 6 | 공유 프리셋 만들기(Make Shared Preset) | 필터 프리셋을 다른 사용자와 공유합니다. 공유 사용자 프리셋은 인사이트의 디폴트 Engine.ini 파일에 저장됩니다(Engine\Programs\UnrealInsights\Config\DefaultEngine.ini). 환경설정 파일이 쓰기 가능하거나 체크아웃되어 있어야 합니다. |
| 7 | 프리셋 저장(Save Preset) | 현재 선택한 채널을 이 필터 아래에 저장합니다. 프리셋이 공유된 경우 Engine.ini 파일이 쓰기 가능하거나 체크아웃되어 있는지를 먼저 확인합니다. |
| 8 | 프리셋 삭제(Delete Preset) | 사용자 필터를 필터 프리셋 메뉴에서 제거합니다. |
에디터에서 트레이스 컨트롤 탭 사용 방법
툴(Tools) > 세션 프론트엔드(Session Frontend) 를 선택하면 에디터 내에 있는 새로운 트레이스 탭을 찾을 수도 있습니다.
트레이스 탭을 에디터에서 열면 다른 사용자 프리셋 세트가 보입니다. 이러한 세트는 에디터에서 연 프로젝트에 기반하여 저장됩니다.
로컬 사용자 프리셋은 다음 위치에 저장됩니다.
[PROJECT_ROOT]\Saved\Config\WindowsEditor\Engine.ini에 있는 프로젝트의 로컬Engine.ini파일
공유 사용자 프리셋은 다음 위치에 저장됩니다.
- 쓰기 가능하거나 체크아웃된 경우
[PROJECT_ROOT]\Config\DefaultEngine.ini에 있는 프로젝트의 디폴트Engine.ini파일
인사이트에서 트레이스 컨트롤 탭 사용 방법
메뉴(Menu) > 라이브 트레이스 컨트롤(Live Trace Control) 를 선택하면 인사이트에서 라이브 세션의 트레이스 컨트롤 탭을 열 수도 있습니다.
