프로파일러 마커 레퍼런스
빌트인 프로파일러 마커에 대한 레퍼런스입니다.
읽는 시간 11분최근 업데이트: 9일 전
Unity의 코드는 애플리케이션에서 시간을 소모하는 요소에 대한 인사이트를 제공하는 프로파일러 마커가 장착되어 있습니다. 다음 표에는 일부 빌트인 마커가 나와 있습니다.
메인 스레드 기본 마커
메인 스레드 기본 마커는 애플리케이션에 소비한 시간과 Unity 에디터 및 프로파일러 작업에 소비한 시간을 분명하게 구분합니다. 또한 이러한 마커를 API와 함께 사용하여 메인 스레드의 프레임 타이밍을 가져오거나, 런타임 시 고수준 프레임 통계를 위한 API를 사용할 수도 있습니다.
ProfilerRecorderFrameTimingManager또한 렌더링 프로파일러 카운터 CPU 메인 스레드 프레임 시간, CPU 렌더 스레드 프레임 시간, CPU 총 프레임 시간을 사용하여 애플리케이션의 CPU 사용량에 대한 높은 수준의 타이밍을 얻을 수 있습니다. 자세한 내용은 렌더링 프로파일러 카운터 참조를 참조하십시오.
Marker | 설명 |
|---|---|
| PlayerLoop | 애플리케이션의 메인 루프에서 파생된 모든 샘플이 포함되어 있습니다. 플레이어가 활성 플레이 모드에서 에디터 내에서 실행 중인 동안 플레이 모드 대신 에디터를 타게팅하면 PlayerLoop 샘플이 EditorLoop 아래에 중첩됩니다. |
| EditorLoop (에디터 전용 마커) | 에디터의 메인 루프에서 파생된 모든 샘플이 포함되어 있습니다. 이는 에디터에서 플레이어를 프로파일링하는 동안만 존재합니다. 프로파일러를 사용하여 플레이 모드를 타게팅하는 경우 EditorLoop 샘플은 플레이어가 포함된 에디터를 렌더링하고 실행하는 데 소요된 시간을 나타냅니다. 자세한 내용은 재생 모드 및 편집 모드 샘플을 참조하십시오. |
| Profiler.CollectEditorStats (에디터 전용 마커) | 다양한 활성 프로파일러 모듈의 통계 수집과 관련된 모든 샘플이 포함되어 있습니다.특정 모듈의 오버헤드를 제거하려면 모듈의 차트를 닫거나 참고: 빌트인 카운터를 사용하는 커스텀 프로파일러 모듈은 해당 모듈이 비활성화되어 있더라도 빌트인 카운터의 영역을 활성화합니다. 프로파일러가 이러한 통계를 수집하고 컬렉션 오버헤드를 생성하지 않도록 하려면 빌트인 프로파일러 모듈과 커스텀 프로파일러 모듈을 모두 비활성화해야 합니다. |
스크립트 업데이트 마커
Unity의 업데이트 루프에 대한 자세한 내용은 이벤트 함수 실행 순서 기술 자료를 참고하십시오. 를 사용하여 자체 콜백을 플레이어 루프에 삽입할 수 있습니다. 메인 루프에 콜백을 직접 삽입하면 스크립트 업데이트 샘플 자체가 나타납니다. 콜백을 보조 시스템으로 삽입하면 샘플이 각각의 메인 PlayerLoopSystem 마커 아래에 나타납니다.
PlayerLoop.SetPlayerLoopMarker | 설명 |
|---|---|
| BehaviourUpdate | 모든 |
| CoroutinesDelayedCalls | 첫 번째 수확 후 모든 코루틴 샘플이 포함됩니다. |
| FixedBehaviourUpdate | 모든 |
| PreLateUpdate.ScriptRunBehaviourLateUpdate | 모든 |
| Update.ScriptRunBehaviourUpdate | 모든 |
렌더링 및 VSync 마커
이러한 마커에는 CPU가 GPU에 대한 데이터 처리에 시간을 소비하거나 GPU가 완료될 때까지 대기 중일 수 있는 샘플이 포함되어 있습니다. GPU 프로파일러 모듈을 사용할 수 없거나 오버헤드가 너무 많이 발생하면 프로파일러 모듈 세부 정보 창의 툴바에 이 정보가 표시되지 않습니다. 이 마커 아래의 샘플을 통해 애플리케이션이 CPU 바운드인지 GPU 바운드인지 확인할 수 있습니다.
Marker | 설명 |
|---|---|
| WaitForTargetFPS | 애플리케이션이 지정된 타겟 FPS를 기다리는 데 소비한 시간을 나타냅니다. 샘플이 Gfx.WaitForPresentOnGfxThread의 하위 샘플인 경우, 애플리케이션이 GPU를 대기하는 데 소요한 시간을 나타냅니다. 예를 들어, QualitySettings.vSyncCount에서 구성된 경우, 또는 타겟 플랫폼에서 vSync가 적용된 경우 GPU가 다음 VSync를 기다리는 데 소요한 시간일 수 있습니다. 하지만 GPU가 프레임 컴퓨팅을 완료하지 않은 경우에도 이 마커가 있는 샘플이 내보입니다. 이 마커가 있는 샘플이 많은 시간을 소모하는 원인을 파악하려면 CPU 프로파일러 모듈의 타임라인 뷰로 전환하십시오. 이 뷰에서는 렌더 스레드에서 발생한 상황과 현재 프레임에서 끝나는 이 샘플과 주변 프레임에서 끝나는 동일한 샘플 사이에 경과한 시간을 확인할 수 있습니다. 기간이(타겟 프레임 속도 또는 vSync에 따라) 애플리케이션의 프레임 시간보다 길면 프레임이 렌더링하거나 계산하는 데 너무 오래 걸립니다. 이 경우 렌더 스레드를 조사하고 Gfx.PresentFrame에서 준비하고 GPU에 커맨드를 발행하는 다른 작업보다 소비한 시간을 확인합니다. 렌더 스레드가 Gfx.PresentFrame에서 많은 시간을 소비한 경우 렌더링 작업은 GPU 바운드입니다. 렌더 스레드의 시간이 커맨드를 준비하는 데 소요된 경우, 애플리케이션은 CPU 바운드입니다. 애플리케이션이 GPU 바운드인 경우 초점을 맞추려면 Unity 프로파일러 또는 플랫폼 프로파일러를 사용하여 GPU 작업을 프로파일링합니다. 자세한 내용은 그래픽 성능 최적화 방법에 대한 사용자 매뉴얼 문서를 참조하십시오. 참고: 에디터는 GPU에서 VSync되지 않고 대신 WaitForTargetFPS를 사용하여 VSync의 지연을 시뮬레이션합니다. 일부 플랫폼, 특히 Android 및 iOS는 VSync를 적용하거나 기본 프레임 속도 한도를 30 또는 60으로 설정합니다. |
| Gfx.PresentFrame | 애플리케이션이 GPU가 프레임을 렌더링하고 표시할 때까지 대기하는 데 소요된 시간을 나타내며, 여기에는 VSync 대기가 포함됩니다. 메인 스레드 WaitForTargetFPS 마커가 있는 샘플은 VSync를 기다리는 데 소요된 시간을 보여줍니다. |
| Gfx.ProcessCommands | 렌더 스레드의 렌더링 커맨드에 대한 모든 처리가 포함되어 있습니다. 애플리케이션이 VSync 또는 메인 스레드 새 커맨드를 대기하는 데 소요한 시간 중 일부를 소요했을 수 있습니다. 이는 해당 자식 샘플인 Gfx.WaitForPresentOnGfxThread에서 확인할 수 있습니다. |
| Gfx.WaitForCommands | 렌더 스레드가 새 커맨드에 대한 준비가 되었음을 나타냅니다. 이 마커가 나타나면 메인 스레드 병목 현상을 나타낼 수 있습니다. |
| 예제는 아래와 같습니다. GfxDeviceD3D11.WaitForLastPresent GfxDeviceD3D12.WaitForLastPresent GfxDeviceMetal.WaitForLastPresent | 이 마커가 있는 샘플은 메인 스레드가 GPU가 프레임 번호를 화면(이 샘플에 대한 자세한 내용과 Unity의 프레임 파이프라인 개요는 Unity의 델타 시간 수정 블로그 게시물을 참조하십시오. |
| Gfx.WaitForPresentOnGfxThread | 메인 스레드 다음 프레임 렌더링을 시작할 준비가 되었지만, 렌더 스레드가 GPU가 프레임을 표시할 때까지 대기하는 것을 완료하지 않았음을 나타냅니다. 이는 애플리케이션이 GPU 바운드임을 나타낼 수 있습니다. 렌더 스레드가 동시에 시간을 소비하는 부분을 확인하려면 CPU 프로파일러 모듈의 타임라인 뷰를 확인하십시오. 렌더 스레드가 Camera.Render에서 시간을 소비하는 경우, 애플리케이션이 CPU 바운드이므로 드로우 콜이나 텍스처를 GPU로 전송하는 데 너무 많은 시간이 소요될 수 있습니다. 렌더 스레드가 시간을 |
| Gfx.WaitForRenderThread | 메인 스레드 렌더 스레드가 커맨드 스트림의 모든 커맨드를 처리할 때까지 기다렸음을 나타냅니다. 이 마커가 있는 샘플은 멀티스레드 렌더링에서만 나타납니다. |
백엔드 스크립팅 마커
샘플은 Mono 또는 IL2CPP 스크립팅 백엔드 작업을 강조하고 가비지 컬렉션 및 할당 문제를 해결하는 데 유용합니다.
Marker | 설명 |
|---|---|
| GC.Alloc | 자동 가비지 컬렉션 대상인 관리되는 할당이 포함된 관리되는 힙 힙의 할당을 나타냅니다. 애플리케이션이 자동 가비지 컬렉션 소비하는 시간을 줄이려면 이러한 타입의 샘플을 최소화해야 합니다. |
| GC.Collect | 가비지 컬렉션 관련된 샘플을 나타냅니다. Unity 가비지 컬렉션 수행해야 할 때마다 프로그램 코드 실행을 중지하고 가비지 컬렉터 모든 작업을 완료한 후에만 정상 실행을 재개합니다. 참고: 점진적 가비지 컬렉션을 활성화한 경우 가비지 컬렉터가 단일 프레임에서 작업을 완료하지 못할 수 있습니다. 이러한 중단으로 인해 애플리케이션 실행 지연이 1밀리초 이하에서 수백밀리초 이하로 지속될 수 있습니다. 가비지 컬렉터 처리해야 하는 메모리 양과 애플리케이션이 실행 중인 플랫폼에 따라 다릅니다. 자세한 내용은 자동 메모리 관리 이해 기술 자료를 참조하십시오. |
| Mono.JIT Mono 전용 | 스크립팅 방법의 정확한 시점 컴파일과 관련된 샘플이 포함되어 있습니다. 함수가 처음 실행되면 Mono 함수를 컴파일하고 Mono.JIT는 이러한 컴파일 오버헤드를 나타냅니다. |
| UnsafeUtility.Malloc | UnsafeUtility.Malloc을 호출하여 관리되지 않는 메모리를 할당하는 샘플이 포함되어 있습니다. 가비지 컬렉터 이 메모리를 추적하지 않지만, 메모리를 할당하면 이 샘플과 같이 성능에 상당한 영향을 미칠 수 있습니다. 이 호출의 소스를 조사하려면 프로파일러 창에서 이 마커에 대한 호출 스택 기록을 활성화하십시오. |
멀티스레드 마커
이 마커에는 소비된 CPU 사이클을 측정하지 않고 대신 스레드 동기화와 잡 시스템과 관련된 정보를 강조 표시하는 샘플이 포함되어 있습니다. 이러한 샘플이 표시되면 CPU 프로파일러 모듈의 타임라인 뷰를 사용하여 다른 스레드에서 동시에 발생하는 동작을 확인합니다.
Marker | 설명 |
|---|---|
| 휴대 | 워커 스레드가 비활성화된 시간을 나타내는 샘플이 포함되어 있습니다. 작업 시스템이 워커 스레드를 사용하지 않을 때마다 워커 스레드가 비활성화되어 대기 모드로 전환되어 세마포어를 대기합니다. 대기(Idle) 샘플 간의 작은 간격은 일반적으로 잡 시스템이 새 잡을 예약하기 위해 잡 시스템이 이를 깨울 때 발생합니다. 공백이 길면 계측되지 않은 네이티브 잡이 스레드에서 실행 중임을 나타낼 수 있습니다. |
| JobHandle.Complete | 잡의 동기화 지점이 발생한 시점을 나타내는 샘플이 포함되어 있습니다. 동기화 포인트는 애플리케이션의 성능에 영향을 미치며 멀티 스레드 잡 코드 실행에 방해가 될 수 있습니다. 동기화 지점이 정확히 발생한 위치를 쉽게 찾을 수 있도록 이 샘플에 대해 호출 스택 레코딩을 활성화합니다. CPU 프로파일러 모듈의 Timeline 뷰에서 플로 이벤트를 활성화하여 이 시점에서 완료된 작업을 식별할 수 있습니다. |
| Semaphore.WaitForSignal | 스레드의 동기화 지점을 나타내는 샘플이 포함되어 있습니다. 기다리는 스레드를 찾으려면 Timeline 뷰에서 이 뷰 직전에 종료된 샘플을 확인하십시오. |
| WaitForJobGroupID | JobHandle의 동기화 펜스가 트리거되었습니다. 이로 인해 작업 훔치기가 발생할 수 있습니다. 이는 노동자가 작업을 마치고 다른 노동자의 작업을 완료할 때 발생합니다. 이는 이 마커 아래에서 실행되는 작업 샘플로 표시됩니다. 도난당한 잡은 반드시 대기 중인 잡이 아닙니다. |
물리 마커
다음 표에는 몇 가지 고수준 물리 프로파일러 마커가 나와 있습니다. 는 이러한 모든 측정을 호출합니다.
FixedUpdateMarker | 설명 |
|---|---|
| Physics.FetchResults | 컨택트 스트림, 트리거 오버랩, 조인트 파괴 이벤트 등 물리 엔진 물리 시뮬레이션 결과를 수집하는 샘플이 포함되어 있습니다. |
| Physics.Interpolation | |
| 물리 처리 | 모든 스레드에서 물리 시뮬레이션이 완료될 때까지 메인 스레드 대기하는 데 소요된 샘플이 포함되어 있습니다. 애플리케이션이 |
| Physics.ProcessingCloth | |
| Physics.ProcessReports | 물리 데이터를 다음 네 단계가 있습니다.
|
| 물리 시뮬레이션 | |
| Physics.UpdateBodies | 모든 물리 바디의 포지션과 회전을 업데이트하는 샘플이 포함되어 있습니다. 리지드바디 컴포넌트가 있는 각 게임 오브젝트에 대해 이 마커가 있는 샘플은 물리 시스템의 포즈를 읽고 트랜스폼에 작성합니다. |
| Physics.UpdateCloth | |
스크립트 라이프사이클과 스크립트 라이프사이클 내의 일반 샘플에 대한 자세한 내용은 이벤트 함수의 실행 순서를 참조하십시오.
애니메이션 마커
다음 표에는 애니메이션 시스템의 마커가 포함되어 있습니다. 애니메이션 시스템 성능에 대한 일반적인 내용은 메카님 성능 및 최적화 페이지를 참조하십시오.
PreLateUpdate.DirectorUpdateAnimationBegin stage
이 단계에서는 활성화되고 활성화된 모든 애니메이터가 처리됩니다. 활성 애니메이터는 컬링 모드와 가시성에 관계없이 처리됩니다.
Director.Marker | 설명 |
|---|---|
| Director.PrepareFrame | |
| Director.PrepareFrameJob (job) | 단일 액티브 애니메이터의 상태 머신 평가합니다. 애니메이터를 처리하는 데 걸리는 시간은 상태 머신 복잡도(예: 상태, 전환, 프로퍼티, 레이어 수)에 따라 증가합니다. |
| Animators.PrepareFirstPass | 다음 처리 단계를 준비합니다. |
| Animators.ProcessGraphJob | |
| Animators.ProcessGraph (job) | 연결된 모든 애니메이션 클립의 모든 프로퍼티를 평가합니다. 모든 클립의 루트 모션 프로퍼티를 함께 블렌딩하여 루트 모션 변위를 계산합니다. 현재 AnimationClips의 프로퍼티를 평가할 때 커브 세그먼트는 애니메이션 클립의 메모리에서 필요 이상으로 읽지 않도록 프레임 간에 로컬로 캐싱됩니다. |
| Animators.FireAnimationEventsAndBehaviours | |
| Animators.ApplyOnAnimatorMove | 루트 모션을 적용하고 MonoBehaviours에서 |
PreLateUpdate.DirectorUpdateAnimationEnd
이 단계에서는 컬링 모드 가 있는 애니메이터와 컬링 모드 또는 가 있는 가시 애니메이터만 처리됩니다. 루트 모션에 의해 프레임 밖으로 이동된 가 있는 애니메이터는 이 단계에 참여하지 않습니다. StateMachineBehaviours 및 AnimationEvents에서 트리거한 사용자 코드로 비활성화된 애니메이터도 마찬가지입니다.
Always UpdateUpdateTransformCull CompletelyCull CompletelyMarker | **함수 |
|---|---|
| Animators.PrepareSecondPass | 다음 처리 단계를 설정합니다. 여기에는 컬링 모드 및 가시성 상태를 기반으로 애니메이터가 제외되는 작업이 포함됩니다. |
| Animators.SortWriteJob | 트랜스폼 시스템에서는 한 번에 하나의 스레드만 트랜스폼 계층 구조를 수정할 수 있습니다. 이 제약을 수용하기 위해 최상의 성능을 위해 동일한 트랜스폼 계층 구조에 여러 애니메이터를 두지 않아 잡을 예약하고 병렬화할 수 있는 세분화도를 높입니다. |
| Animators.ProcessAnimationsJob | |
| Animator.ProcessAnimations (job) | 루트 모션을 제외하고 현재 활성화된 애니메이션 클립의 모든 프로퍼티를 단일 애니메이터에 블렌딩한다. 이를 내부 아바타 표현에 적용합니다. 이 마커의 길이는 애니메이션과 블렌딩의 복잡도에 따라 스케일됩니다. |
| OnAnimatorIK | 설정 애니메이션 IK. 이는 IK 패스가 활성화된 각 애니메이터 컨트롤러 레이어에 대해 한 번 호출됩니다. |
| Animators.WriteJob | |
| Animators.WriteTransforms (job) | 애니메이션화된 모든 트랜스폼을 워커 스레드에서 씬에 작성합니다. |
| Animator.WriteProperties | 트랜스폼 포즈가 아닌 애니메이션화된 프로퍼티를 타겟 오브젝트에 작성한다. |
성능 경고
CPU 프로파일러는 몇 가지 일반적인 성능 문제를 감지하고 경고를 표시합니다. 모듈 세부 정보 창의 CPU 프로파일러 모듈의 계층 구조 뷰의 경고 열에 표시됩니다.
프로파일러는 성능이 중요한 상황에서 피할 특정 호출을 감지합니다. 다음과 같이 작업이 성능에 영향을 미치는 이유와 함께 경고를 표시합니다.
경고 | 설명 |
|---|---|
| Animation.DestroyAnimationClip Animation.AddClip Animation.RemoveClip Animation.Clone Animation.Deactivate | RebuildInternalState가 트리거되었음을 나타냅니다. RebuildInternalState는 Animation 컴포넌트의 각 클립에 대한 커브 리스트를 확인한 다음 각 커브를 게임 오브젝트의 컴포넌트의 값으로 리바인딩하는 작업입니다. 리소스를 많이 소모하는 작업이므로 런타임 시점에 이러한 메서드를 최대한 호출하지 않는 것이 좋습니다. |
| AssetBundle.asset/allAssets | 에셋 번들 로딩이 완료되지 않았을 때 Unity AssetBundleRequest.assets/allAssets API 호출했음을 나타냅니다(AssetBundleRequest.isDone은 false). 이렇게 하면 메인 스레드 지연되고 로딩 작업이 완료될 때까지 기다립니다. |
| AsyncUploadManager.AsyncBufferResized AsyncUploadManager.AsyncBufferDelete | GPU에 데이터를 업로드하기 위한 내부 버퍼 크기가 크기가 충분하지 않기 때문에 크기가 조절되었음을 나타냅니다. 이 크기 조절은 느리고 CPU 작업이 급증합니다. 메모리를 절약하여 더 큰 크기를 전면에 할당하면 이 경고를 피할 수 있습니다. 품질 설정에서 비동기 업로드 버퍼 크기 설정을 사용하여 기본 크기를 설정할 수 있습니다. |
| Rigidbody.SetKinematic | 리지드바디에 대해 볼록하지 않은 MeshCollider를 다시 생성한다. |