언리얼 인사이트를 실행하면 세션 브라우저(Session Browser) 창이 열리는데, 여기서 보고 싶은 트레이스 세션을 선택할 수 있습니다. 이 페이지에서는 세션 브라우저 창과 이 창을 사용하여 트레이스 세션을 로드하고 라이브 트레이스 세션을 연결하는 방법에 대한 레퍼런스를 제공합니다.
언리얼 인사이트의 워크플로에 대한 전체 개요는 언리얼 인사이트 개요를 참조하세요.
트레이스 스토어 탭
트레이스 스토어(Trace Store) 탭에서는 볼 수 있는 트레이스 세션 파일 목록을 제공합니다. 이 목록에는 로컬 컴퓨터의 파일뿐 아니라 원격 트레이스 레코더 서버에서 이용할 수 있는 파일도 포함되어 있습니다. 각 세션에는 애플리케이션의 퍼포먼스 및 리소스 사용에 대한 녹화된 데이터가 포함되어 있습니다.
| 엘리먼트 | 이름 | 설명 |
|---|---|---|
| 1 | 스토어 세팅 관리(Manage Store Settings) | 드롭다운을 클릭하면 트레이스 스토어 디렉터리(4) 및 추가 디렉터리(5)가 표시됩니다. |
| 2 | 스토어 호스트(Store Host) | 트레이스 서버의 IP 주소입니다. 기본값은 127.0.0.1인데, 이는 로컬 트레이스 서버를 사용한다는 뜻입니다. 원격 트레이스 서버가 있다면, 해당 IP 주소를 제공하여 로컬 대신 원격 서버에서 트레이스 데이터를 검색할 수 있습니다. 연결이 성공하면 아이콘이 녹색 체크 표시로 나타나고 연결하지 못하면 경고 아이콘으로 나타납니다. 이 필드를 하이라이트하면 툴팁에 버전 및 포트 등의 추가 트레이스 서버 정보가 나타납니다. |
| 3 | 디렉터리(Directory) | 트레이스 서버가 새 트레이스를 저장하는 디렉터리입니다. |
| 4 | 트레이스 스토어 디렉터리(Trace Store Directory) | 트레이스 스토어 디렉터리(3)를 나타냅니다. 이 옵션은 보통 숨겨져 있습니다. 접힌 부분을 클릭하면 표시됩니다. |
| 5 | 추가 디렉터리(Additional directories) | 언리얼 트레이스 서버가 트레이스 파일을 모니터링하는 다른 디렉터리입니다. 트레이스 스토어 디렉터리와 외부 모니터링 디렉터리 모두의 트레이스 파일은 트레이스 스토어 탭의 세션 목록에 통합 목록으로 표시됩니다. 이 옵션은 보통 숨겨져 있습니다. 접힌 부분을 클릭하면 표시됩니다. |
| 6 | 이름/명령줄 토글(Name/Command Line Toggle) | 이름 필터를 사용할 때 이름과 명령줄 필터링을 토글합니다. |
| 7 | 이름 필터(Name filter) | 토글한 모드(6)에 따라 이름이나 명령줄로 트레이스 세션을 필터링합니다. 트레이스 세션 이름은 숫자 스트링으로 표시되지만, 이 필터를 사용하여 확인하려는 세션 범위를 좁힐 수 있습니다. |
| 8 | 필터 바(Filter Bar) | 트레이스 세션 목록(9)의 열을 필터링합니다. 자세한 내용은 아래의 필터 섹션을 참조하세요. |
| 9 | 트레이스 세션 목록(Trace session list) | 선택한 디렉터리(3/4)에서 프로파일링에 사용할 수 있는 트레이스 세션 목록입니다. 한 번에 여러 트레이스 파일을 선택할 수 있습니다. |
| 10 | 자동 시작 분석 토글(Auto-start analysis toggle) | 라이브 트레이스 세션에 대한 자동 시작분석을 활성화하거나 비활성화합니다. 이 세팅은 세션 간에 유지됩니다. |
| 11 | 자동 시작 필터(AutoStart filters) | 특정 경우에만 자동 시작이 실행되도록 제한합니다. 플랫폼 또는 앱 이름 으로 필터링할 수 있습니다. |
| 12 | 자동 연결(Windows 전용)(Auto-Connect (Windows only)) | 활성화하면 언리얼 인사이트가 실행 중인 경우 UE 애플리케이션이 로컬 트레이스 서버에 자동 연결되고 트레이싱이 시작됩니다. |
| 13 | 트레이스 열기 버튼(Open Trace button) | 트레이스 열기 버튼을 클릭하면 트레이스 세션 목록(9)에서 선택한 세션에 대한 언리얼 인사이트가 열립니다. |
| 14 | 트레이스 열기 드롭다운(Open Trace Dropdown) | 트레이스 열기 버튼 옆에 있는 드롭다운으로, 트레이스를 여는 다른 방법이 표시됩니다. 자세한 내용은 아래의 트레이스 열기 드롭다운에 대한 섹션을 참조하세요. |
필터
필터 바에는 트레이스 세션 목록의 열에 해당하는 필터가 있는 드롭다운이 포함되어 있습니다. 각 드롭다운을 클릭하면 필터링하려는 값을 토글할 수 있습니다. 다음과 같은 필터 타입을 사용할 수 있습니다.
| 필터 | 설명 |
|---|---|
| 플랫폼(Platform) | 프로파일링하려는 빌드의 타깃 플랫폼으로 필터링합니다. 예를 들어, Win64, Mac 또는 Linux가 있습니다. |
| 앱 이름(App Name) | 프로파일링하려는 애플리케이션 이름으로 필터링합니다. 앱 이름은 속한 앱과 상관없이 개별 세션에 대한 식별자인 트레이스 세션 이름과는 다릅니다. |
| 환경설정(Config) | 빌드 환경설정으로 필터링합니다. 예를 들어, 디버그(Debug), 개발(Development) 또는 출시(Shipping) 타입 빌드 환경설정으로 필터링할 수 있습니다. |
| 타깃(Target) | 빌드 타깃으로 필터링합니다. 예를 들어, 에디터(Editor), 게임(Game), 클라이언트(Client) 또는 서버(Server) 빌드 타깃으로 필터링할 수 있습니다. |
| 분기(Branch) | 애플리케이션이 연결된 버전 관리 시스템의 분기로 필터링합니다. |
| 크기(Size) | 트레이스 파일의 크기를 기준으로 필터링합니다. |
| 상태(Status) | 세션이 오프라인 상태 라이브 상태인지에 따라 필터링합니다. |
분석을 위한 트레이스 로드
다음 옵션을 사용하여 분석할 트레이스를 로드할 수 있습니다.
- 언리얼 인사이트 브라우저에 표시된 트레이스 세션 중 원하는 세션을 더블클릭합니다.
- 트레이스 세션을 선택하고 트레이스 열기(Open Trace) 를 클릭합니다.
- Windows를 사용하는 경우, 탐색기에서
.utrace파일을 언리얼 인사이트 창으로 드래그 앤 드롭하여 트레이스 파일 분석을 시작합니다. - 트레이스 열기(Open Trace) 드롭다운을 사용하여 다른 위치에서
.utrace파일을 검색합니다.
트레이스 세션을 열면, 언리얼 인사이트에서 인사이트의 메인 프로파일링 툴을 제공하는 타이밍 인사이트가 열립니다.
트레이스 열기 드롭다운
트레이스 열기 버튼 옆에 있는 드롭다운으로, 트레이스를 여는 자세한 옵션이 표시됩니다.
| 옵션 | 설명 |
|---|---|
| 기타(Misc) | |
| 파일 열기(Open File) | 트레이스 파일을 수동으로 선택할 수 있는 파일 브라우저가 열립니다. |
| 테이블 임포트(Import Table) | CSV 또는 TSV를 테이블 임포트 뷰에 임포트합니다. |
| 테이블 비교...(Diff Tables...) | 비교 모드에서 테이블 2개가 열립니다. |
| 가장 최근에 생성된 상위 트레이스(Top Most Recently Created Traces) | |
| 트레이스 항목(Trace Entries) | 목록에 가장 최근에 생성된 트레이스가 표시됩니다. 여기서 해당 트레이스에 빠르게 액세스할 수 있습니다. |
| 서버(Server) | |
| 언리얼 트레이스 서버(Unreal Trace Server) | 로컬 트레이스 서버에 대한 서브 메뉴가 표시됩니다. 아래의 언리얼 트레이스 서버 섹션을 참조하세요. |
| 디버그 옵션(Debug Options) | |
| 세션 자동화 테스팅 활성화(Enable Session Automation Testing) | 이 창에서 열린 세션에 대한 자동 테스트 시스템이 활성화됩니다. |
| 디버그 툴 활성화(Enable Debug Tools) | 이 창에서 열린 세션에 대한 디버그 툴이 활성화됩니다. |
| 스타쉽 테스트 스위트(Starship Test Suite) | 다양한 UI 엘리먼트의 프리뷰가 포함된 스타쉽 UX 테스트 스위트가 열립니다. |
언리얼 트레이스 서버 펼치기
트레이스 열기(Open Trace) 드롭다운의 언리얼 트레이스 서버(Unreal Trace Server) 옵션은 트레이스 서버 인스턴스에 대한 정보와 컨트롤이 있는 서브 메뉴를 표시합니다. 다음과 같은 옵션을 사용할 수 있습니다.
| 옵션 | 설명 |
|---|---|
| 스폰서 모드(Sponsored Mode) | 활성화하면 해당 서버를 사용하는 로컬 프로세스가 실행되는 동안에만 서버가 실행됩니다. |
| 시작(Start) | 로컬 트레이스 서버가 아직 실행 중이 아니라면 로컬 트레이스 서버를 시작합니다. |
| 중지(Start) | 로컬 트레이스 서버가 이미 실행 중이라면 로컬 트레이스 서버를 중단합니다. |
이러한 옵션 외에도 다음과 같은 서브 메뉴도 표시됩니다.
- 버전 번호(Version number)
- 서버의 레코더 포트(The Recorder Port for the server)
- 서버의 스토어 포트(The Store Port for the server)
라이브 연결(Live Connect)
라이브 상태란 현재 트레이스 세션이 녹화 중이라는 뜻입니다. 라이브 트레이스 세션이 언리얼 트레이스 서버에 연결되면 해당 세션이 트레이스 스토어 목록에도 표시됩니다. 라이브 세션은 상태 열에 라이브(LIVE) 라는 단어가 표시되며 분석 도중에 실시간으로 업데이트됩니다. 그 외에는 사전 녹화된 세션과 동일합니다.
툴은 동시에 여러 개의 세션을 모니터링할 수 있고, 데이터가 스트림으로 오는 동안 해당 세션의 데이터를 모두 자동으로 녹화합니다. 이러한 세션은 사전 녹화된 세션과 같은 방식으로 목록에서 로드하여 실시간으로 분석할 수 있습니다.
컨텍스트 메뉴
트레이스 스토어 목록에서 항목을 우클릭하면, 해당 트레이스에 사용할 수 있는 액션과 함께 컨텍스트 메뉴가 표시됩니다.
| 옵션 | 설명 |
|---|---|
| 트레이스 ID 복사(Copy Trace ID) | 트레이스 세션의 트레이스 ID를 클립보드에 복사합니다. |
| 전체 경로 복사(Copy Full Path) | 트레이스 세션 파일이 저장된 파일 경로를 복사합니다. |
| 포함하는 폴더 열기(Open Containing Folder) | 트레이스 세션 파일이 포함된 폴더를 엽니다. |
| 이름변경(Rename) | 트레이스 파일의 새 이름을 입력합니다. |
| 삭제(Delete) | 선택된 트레이스 파일을 삭제합니다. 여러 트레이스를 선택한 경우, 이 옵션을 사용하여 선택한 트레이스를 모두 삭제할 수 있습니다. |
연결 탭
연결 탭(Connection Tab) 에서는 트레이스 서버를 사용하여 실행 중인 게임이나 에디터에 연결하는 인터페이스를 제공합니다. 연결 탭에는 연결 세팅을 변경할 수 있는 여러 가지 옵션이 있습니다.
| 파라미터 | 설명 |
|---|---|
| 트레이스 레코더 IP 주소(Trace Recorder IP address) | 트레이스 서버의 IP 주소입니다. |
| 실행 중인 인스턴스 IP 주소 초기 채널(Running Instance IP address Initial Channels) | 데이터 트레이싱을 시작하기 위해 트레이스 서버와 연결하는 프로젝트, 즉 실행 중인 인스턴스의 IP 주소입니다. |
| 초기 채널(Initial channels) | 트레이스 연결에서 데이터 분석을 시작할 때 활성화할 트레이스 채널의 목록을 지정하는 필드입니다. |
트레이스 레코더에 연결하려면 위의 각 필드를 채운 다음 연결(Connect) 을 클릭합니다. 새 연결에 해당하는 새 라이브 세션이 트레이스 세션 목록에 라이브(LIVE) 라는 단어로 표시되어 나타납니다. 로컬 트레이스 데이터 외에도 이제 트레이스 스토어에서 원격 트레이스 데이터를 사용할 수 있습니다.