프로파일러 툴 레퍼런스

Profiler 프로파일러는 언리얼 엔진 3 의 StatsViewer (통계 뷰어) 툴을 대신하는 것으로, 게임 데이터를 수집하고 추적하여 게임의 퍼포먼스를 모니터링하는 데 사용됩니다. 그 데이터는 게임을 느려지거나 버벅이게 만들 수도 있는 원인을 알아내는 데 쓸 수 있습니다.

퍼포먼스 튜닝이 처음이신 경우, 퍼포먼스와 프로파일링 문서를 먼저 참고해 주시기 바랍니다. 게임의 퍼포먼스를 모니터링하는 데 도움이 되는 팁을 여럿 찾아보실 수 있습니다.

프로파일러 켜기

프로파일러 를 켜고 데이터를 수집하는 데 사용되는 방법은 두 가지 있습니다:

1. 라이브 연결
   • 게임에 -messaging 파라미터를 붙여 실행합니다 (예: UE4Editor-Win64-Debug.exe -messaging).
   • UFE 에 -messaging 파라미터를 붙여 실행합니다 (예: UnrealFrontend-Win64-Debug.exe -messaging).
   • 창 메뉴의 개발자 툴 섹션에서 세션 프론트엔드 를 선택한 다음 프로파일러 탭을 선택합니다.
2. 기존에 갭처한 데이터 로드
   • 툴바의 프로파일러 탭에서 로드 버튼을 누른 다음 .ue4stats 파일을 선택합니다.
   • 탐색기나 다른 파일 매니저에서 통계 파일을 끌어 프로파일러 창에 놓습니다.

C:\Program Files\Unreal Engine\4.3\Engine\Binaries\Win64 폴더에서 UnrealFrontEnd.exe 를 독립형으로 실행시켜 세션 프론트엔드 와 프로파일러 탭에 접근할 수도 있습니다. (주: 엔진 버전과 설치된 경로에 따라 위 부분은 다를 수 있습니다).

프로파일러 창

아래는 프로파일러 창과 UI 성분입니다:

이미지를 클릭하면 원래 크기로 보입니다.

1. 연결된 세션 및 세션 정보 창 - 통계 데이터를 구하는 세션으로 사용됩니다.
2. 메인 툴바 창 - 전체적으로 작용하는 기본적인 기능이 들어있습니다.
3. 데이터 그래프 전체 창 - 전체 통계에 대한 그래프 표현이 제공됩니다.
4. 데이터 그래프 창 - 통계에 대한 그래프 표현입니다.
5. 필터 및 프리셋 창 - 모든 통계와 그룹이 들어있습니다 (사용자가 입맛대로 필터와 소트 적용 가능합니다).
6. 이벤트 그래프 창 - 선택된 프레임(들)을 이벤트 그래프로 나타냅니다.

메인 툴바

아래는 메인 툴바 에 있는 각 기능에 대한 설명입니다:

데이터 캡처 파일 저장 위치는 ...\UE4\Engine\Programs\UnrealFrontend\Saved\Profiling\UnrealStats\Received... 입니다.

필터와 프리셋

메인 툴바 에 있는 각 기능에 대한 설명은 아래와 같습니다:

통계 추적 방법

통계 추적 방법은 세 가지입니다:

1. 선택된 통계에 더블클릭 하여 데이터 그래프 뷰 에 표시 추가/제거합니다.
2. 통계/그룹 창 에서 데이터 그래프 뷰 로 드래그 앤 드롭합니다 (아래 그림 참고).
3. 이벤트 그래프 뷰 에서 드래그 앤 드롭 합니다.

통계가 추적중인 경우, 다른 색으로 표시되며, 이름 옆에 "*" 심볼이 나타납니다.

또한, 그룹 이름 옆의 () 안에 있는 두 번째 숫자를 통해 그룹에 추적중인 통계 갯수를 확인할 수 있습니다.

오디오 에 대한 윗 그림에서, 그룹에 11 항목이 있으며, 그 중 하나를 현재 추적중입니다.

데이터 그래프

데이터 그래프 뷰에는 추적된 통계가 전부 표시됩니다. 통계 추적을 중지하려면, 통계 텍스트 앞의 (X) 버튼을 누르면 됩니다.

통계 텍스트는 다음의 정보로 이루어져 있으며, 아래와 같이 나뉘어 있습니다:

1. (그룹 이름) - 통계의 그룹 이름입니다.
2. 통계 이름 - 통계의 이름입니다.
3. 실제 값 - 통계의 실제 값입니다.
4. 최소 값 - 전체 캡처를 기반으로 한 최소 값입니다.
5. 평균 값 - 전체 캡처를 기반으로 한 평균 값입니다.
6. 최대 값 - 전체 캡처를 기반으로 한 최대 값입니다.
7. 호출 - 이 통계로의 호출을 가진 프레임 백분율입니다 (계층 데이터 전용)
8. 최소 값 - 전체 캡처를 기반으로 한 이 통계로의 최소 호출 수입니다 (계층 데이터 전용).
9. 평균 값 - 전체 캡처를 기반으로 한 이 통계로의 평균 호출 수입니다 (계층 데이터 전용).
10. 최대 값 - 전체 캡처를 기반으로 한 이 통계로의 최대 호출 수입니다 (계층 데이터 전용).

계층 데이터 전용 이라고 표시된 값은 계층 데이터에만 표시되는 값으로, 표시되지 않을 수도 있습니다.

데이터 그래프 축에 대한 설명은 아래와 같습니다:

• 하단 - 처음부터의 시간을 표시하며, 0.0 부터 시작합니다.
• 상단 - 처음부터의 프레임 번호를 나타내며, 0.0 부터 시작합니다.
• 좌측 - 줌 레벨에 따른 시간에 대한 적응형 정보를 ms 단위로 나타냅니다. 마우스 휠 을 사용하면 게임에 미리정의된 축이 30, 60, 100FPS 로 셋 있는데, 각기 다른 색으로 표시됩니다.
• 우측 - Float 나 Memory 같은 다른 통계에 대한 적응형 정보가 표시됩니다. 이 축에는 실수나 메모리 값은 시간 관련 통계보다 보통 크기 때문에 좌측의 것과 스케일이 다릅니다.

데이터 그래프 창에 우클릭 을 해도 부가 옵션이 있는 컨텍스트 메뉴가 나타납니다:

• 뷰 모드 - 현재는 인덱스 기반 모드만 지원됩니다 (시간 기반 모드는 프로파일러 의 멀티세션 모드에서만 사용가능하며, 기본적으로 꺼져있는 실험단계 기능입니다).
• 모든 프레임 선택 - 모든 프레임을 선택하고 이벤트 그래프 뷰 를 업데이트합니다.
• 라이브 프리뷰 - 이 옵션은 메인 툴바에 있는 것과 같습니다.

이벤트 그래프

이벤트 그래프 뷰 는 다음과 같이 구성되어 있습니다:

1. 제목 - 현재 연결된 세션 이름 또는 현재 로드된 통계 파일이 표시됩니다.
2. 이벤트 그래프 툴바 - 이벤트 그래프 필터링 및 기타 기능에 사용됩니다.
3. 함수 디테일 - 선택된 이벤트/함수의 디테일 뷰입니다.
4. 메인 이벤트 그래프 - 선택된 프레임(들)의 계층 뷰입니다.

이벤트 그래프 툴바

아래는 이벤트 그래프 툴바 에 있는 각 기능에 대한 설명입니다:

함수 디테일

함수 디테일 에는 사용자가 선택한 함수/이벤트와 선택된 함수/이벤트를 실행하는 함수 호출 사이의 관계를 표시합니다. 이러한 관계는 백분율 값에 맞도록 스케일 적용된 버튼을 사용하여 표시됩니다.

사용자는 맨 위의 이벤트에서부터 차례로 내려가며 퍼포먼스에 문제가 되는 부분을 쉽게 찾을 수 있습니다. 함수 디테일 뷰는 메인 이벤트 그래프 와 양방향 동기화되어 있어, 새 함수를 선택하면 메인 이벤트 그래프 에도 그 함수가 선택됩니다.

함수 디테일 은 다음과 같은 요소로 구성되어 있습니다:

• 함수 호출 - 선택된 함수를 호출한 함수를 표시합니다. 위젯의 크기는 백분율 값에 따라 스케일 조절됩니다.
• 현재 함수 - 현재 메인 이벤트 그래프 이벤트에 선택된 이벤트/함수 입니다.
• 호출된 함수 - 선택된 함수에 의해 호출된 함수입니다. 위젯의 크기는 백분율 값에 따라 스케일 조절됩니다.
  • - 이것이 표시되면, 이벤트가 메인 이벤트 그래프 창에 컬링(선별)된 것입니다 (자세한 정보는 다음 섹션을 참고하세요).
  • - 이것이 표시되면, 이벤트가 메인 이벤트 그래프 창에 필터링된 것입니다 (자세한 정보는 다음 섹션을 참고하세요).

아이콘에 커서를 올리면 그 항목에 대한 부가 정보가 표시된다는 점 기억하세요.

메인 이벤트 그래프

메인 이벤트 그래프 창에는 이벤트 실행 경로가 표시됩니다. 보통 이름에 "thread" 또는 "[0x1234]" 식의 스레드 번호 ID 로 나타냅니다.

메인 이벤트 그래프 를 통해 필터링, 컬링, 및 기타 여러가지 기능이 가능합니다. 이 기능은 아래와 같으며, 메인 이벤트 그래프 창에 우클릭 하면 뜨는 컨텍스트 메뉴에서 원하는 기능을 선택하면 됩니다.