Get frame timing data

Get frame time data with a custom Profiler module, or using the FrameTimingManager API.

Read time 2 minutes

Last updated 20 days ago

You can get frame timing data from the

FrameTiming

API in the following ways:

To get frame timing data from release builds, you must first enable the Frame Timing Stats property.

Use a custom Profiler module

To view frame timing data in a custom Profiler module perform the following steps:

Create a custom profiler module according to the instructions on Creating a custom profiler module.
Open the Profiler window (Window > Analysis > Profiler)
Open the Profiler Module Editor (Profler Modules dropdown > gear icon) and select your custom Profiler module.
In the Available Counters panel, select Unity.
Select Render to open the submenu that contains Profiler counters related to memory usage, which includes those that the
```
FrameTimingStats
```
property enables. You can then click on the relevant counters in the submenu to add them to your custom module.

For a list of available counters, refer to Profiler counters reference.

FrameTiming

to determine whether a frame is CPU or GPU bound.

Use the

FrameTiming

API to access timestamp information. In each variable,

FrameTimingManager

records the time a specific event happens during a frame.

The following table contains the values available through the API, in the order that Unity executes them during a frame:

Property	Description
`frameStartTimestamp`	The CPU timestamp time when the frame begins.
`firstSubmitTimestamp`	The CPU timestamp time when Unity submits the first job to the GPU during this frame.
`cpuTimePresentCalled`	The CPU timestamp time when Unity calls the Present() function for the current frame.
`cpuTimeFrameComplete`	The CPU timestamp time when the GPU finishes rendering the frame and interrupts the CPU.

Use

FrameTimingManager.GetCpuTimerFrequency

API to convert the timestamp to seconds.