마이크로프로파일

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

Roblox Studio 및 Roblox 클라이언트에서 사용할 수 있는 마이크로 프로파일러는 태그라는 이름의 작업 스케줄러 작업에 대한 자세한 타이밍 정보를 제공하는 최적화 도구입니다.

  • 일반적인 태스크 목록에 대해서는 태그 참조를 참조하십시오.
  • MicroProfiler를 사용하여 성능 문제를 식별하는 단계별 예시는 MicroProfiler 워크플로우를 참조하십시오.

마이크로프로파일 기초

MicroProfiler를 열려면 Studio 또는 클라이언트에서 CtrlAltF6 ( 1>⌥1> 3>F63> )를 누르십시오. 또한 클라이언트의 설정 메뉴를 사용할 수도 있습니다.

열면 3D 뷰포트 顶部에 메뉴 바가 표시됩니다. 기본 모드에서는 이동 바 그래프가 작업 일정 프레임마다 사용된 시간을 표시합니다.

The Microprofiler frame graph, showing blue frames and detailed frame information.

바는 일반적으로 그래프의 중앙 주위에 있지만, 갑자기 증가하는 값을 볼 수 있습니다(값 간의 빠른 증가). 스파이크는 일반적으로 작업을 수행하는 데 더 많은 시간이 필요하다는 것을 나타내며, 이는 일반적으로 작업 부하가 증가하는 결과로 나타��

The Microprofiler with several bars higher than others.

프레임 녹화를 중지하려면 CtrlP (P))를 누르거나 메뉴 바에서 2>중지2>를 클릭하십시오. 중지 상태에서 시간 표시가 나타나고 그래프를 클릭하거나 드래그하여 프레임을 탐색할 수 있습니다.

MicroProfiler 인터페이스를 탐색하는 방법과 다양한 보기에 대한 자세한 내용은 MicroProfiler 모드를 참조하십시오.

스레드

많은 프로그램과 마찬가지로 Roblox는 여러 스레드를 사용하여 여러 시퀀스의 작업을 동시에 수행합니다. MicroProfiler 상세 모드에서 왼쪽에 있는 레이블을 확인할 수 있습니다.

The lefthand side of the Microprofiler detailed view, with rows for threads.

주요 스레드 유형은 세 가지가 있습니다.

  • 메인/렌더 : 어쩌면 직관적이지 않지만, 프로세스 입력, Humanoids, 애니메이션/트위닝, 물리 소유권, 음향 및 대기 스크립트 재시작을 처리합니다. 또한 Studio 인터페이스를 업데이트하고 다른 스레드를 조정합니다.

  • 작업자 ("RBX 작업자") : 네트워킹, 물리 및 경로 찾기를 위한 메인 스레드를 도와줍니다. 현대 칩셋의 코어 수는 많기 때문에 작업자 스레드가 많을 수 있습니다.

  • 렌더링 ("GPU") : 준비, 실행, 제공 논리를 따릅니다. 기기그래픽 처리 장치(GPU)와 통신합니다.

    • 준비: 메인 스레드에서 업데이트된 모델은 렌더링 모델을 업데이트하는 데 사용됩니다.
    • 수행: 2D 인터페이스를 포함한 이슈 렌더링 명령을 수행합니다.
    • 현재: GPS와 동기화됩니다.

사용자 지정 프로파일

복잡한 작업을 수행하는 스크립트의 경우, 코드의 크리티컬 부분을 프로필하여 지연되지 않도록 하세요. 코드를 debug.profilebegin()debug.profileend() 에 감싼 후 에서 시작하여 모든 함수 호출 사이에 시간을 측정하고 레이블을 마

하드워크 스크립트

debug.profilebegin("Hard Work")
-- 여기 코드를 프로파일링할 코드가 있습니다.
debug.profileend()
A custom label on the detailed view of the MicroProfiler.

MicroProfiler 레이블에는 사용 가능한 메모리가 제한되어 있습니다. 이 메모리가 부족하면 사용자 정의 프로파일러 레이블이 타임라인에 의미 있는 이름으로 표시되지 않을 수 있습니다. 이 메모리를 사용하지 않도록 레이블을 적게 사용하십시오. 코드 섹션을 프로파일링하지 않아도 되도록 해제하려면 ��

예시

아래 코드 샘플은 모든 프레임에 대해 실행되는 RunService.PreSimulation 이벤트에 더미 함수를 연결하고, 이는 코드를 최대한 효율적으로 실행해야 합니다. 이 함수는 프로파일링에 좋은 후보이므로 자주 수행되는 작업은 가능한 한 효율적으로 수행해야 합니다.


local RunService = game:GetService("RunService")
local function onPreSimulation()
debug.profilebegin("Hard Work")
-- 힘든 일: 200,000 번 변수 교체
local a, b = 0, 1
for _ = 1, 200000 do
a, b = b, a
end
debug.profileend()
end
RunService.PreSimulation:Connect(onPreSimulation)

경험을 실행하고 MicroProfiler( CtrlP 또는 P )를 중지하면 사용자 레이블이 2>게임Stepped2> 레이블 아래에 표시됩니다.

Many labels on the MicroProfiler, with a custom label taking up the majority of the processing time.

기간 축에 대한 지속 시간에 따라 함수가 다른 작업에 비해 많은 처리 시간을 사용하고 있음을 알 수 있습니다.

프레임 데이터 저장

나중에 검토(또는 다른 사람과 공유)할 프레임 데이터 세트를 저장하려면 덤프 메뉴를 사용하십시오. 엔진은 프레임 데이터를 Roblox 로그 디렉터리에 있는 microprofile-<date>-<time>.html 파일로 저장합니다.

  • On Windows, check %LOCALAPPDATA%\Roblox\logs .
  • On macOS, check ~/Library/Logs/Roblox .

이 HTML 파일은 모바일 장치의 라이브 연결과 서버 덤프와 같은 동일한 웹 기반 UI를 사용합니다.

모바일 장치에서 프로파일링

모바일 클라이언트에서 MicroProfiler에 액세스하려면 개발 컴퓨터와 동일한 네트워크에 연결해야 합니다.

모바일 기기 설정 메뉴에서 마이크로프로필을 활성화하십시오. 활성화되면 메뉴에 IP 주소와 포트 번호가 표시됩니다.

A picture of the Settings menu on mobile, showing how to enable the MicroProfiler.

예를 들어 위의 스크린샷에서 주소는 192.168.1.166 이고 포트는 1338 입니다. 동일한 네트워크의 컴퓨터에서 주소를 http://192.168.1.166:1

The MicroProfiler web view.

서버 프로파일

서버 마이크로프로필을 사용하여 서버 활동에 대한 간단한 덤프를 얻을 수 있습니다.

  1. 편집 권한이 있는 경험에서 개발자 콘솔을 열려면 CtrlAltF9 을 사용하십시오.

  2. 드롭다운 메뉴에서 마이크로 프로파일러 를 선택합니다.

  3. In the 서버 프로파일러 section, specify the number of frames per second (maximum 60) and the number of seconds to profile (maximum 4).

  4. 클릭하십시오 녹음 시작 .

    The Developer Console MicroProfiler screen.

    몇 초 후 개발자 콘솔은 파일의 경로를 제공하며, 이는 표준 덤프와 동일한 경로입니다.

웹 UI 사용

일반적으로 MicroProfiler 웹 UI는 세부 정보 모드와 동일하게 작동하지만 몇 가지 추가 기능이 있습니다.

  • 그룹별 필터링 외에도 스레드별 필터링을 사용할 수 있습니다.

  • Use CtrlF / F 를 사용하여 덤프에서 가장 오래 걸리는 작업이 발생할 때 점프합니다. 예를 들어, 2> computeLightingPerform2> 는 모든 프레임에서 실행됩니다.

  • 메모리 할당에 대한 색상 코딩을 활성화하거나 비활성화하려면 X-Ray 메뉴를 사용하십시오.

    The MicroProfiler web view with x-ray enabled.
    • 메인 바 그래프 내의 가벼운 프레임은 더 높은 메모리 할당을 나타냅니다.
    • 미리 보기 바의 경우 미리 보기 레이블 및 타임라인에 있는 라이트 레이블은 메모리 할당량이 높은 프레임의 일부를 나타냅니다.
    • X 레이 모드에서 C를 눌러 메모리 할당의 총 크기를 표시하는 대신 할당 수를 표시하지 않습니다.
  • 내보내기 메뉴를 사용하여 CPU 또는 메모리 화살표 그래프를 내보내십시오, 덤프에 포함된 모든 호출 스택을 요약하는 특수 시각화입니다. 화살표 그래프는 멈춤 시간이 길지 않지만 실행 시간이 길기 때문에 실행 시간이 중요한 작업을 식별하는 데 유용

    The MicroProfiler flame graph.
  • Second dump file into the web UI to generate a diff flame graph, which can help you identify improvements or regressions to your experience's performance over time. Click Combine & Compare to export a new HTML file.

    The MicroProfiler diff flame graph builder showing the left and right sides.

    차이 화살표 그래프는 더 많은 CPU 또는 메모리를 소비하는 덤프(왼쪽 또는 오른쪽)를 강조하고, 색이 더 크게 나타나면 차이를 더 많이 나타냅니다.

    The MicroProfiler diff flame graph.