Guides and Sample Code

Developer

Instruments User Guide

On This Page

GPU Hardware Instrument

Overview

Instrument Description

Monitors GPU hardware activity. This Instrument monitors GPU-side events.

Supported Platforms

iOS

Related Profiling Templates

Metal Application Instrument

Timeline Pane

The timeline pane displays a graph indicating GPU hardware activity.

Record Settings

This instrument doesn’t have any record settings you can configure.

Display Settings

Click the Display Settings button (image: ../Art/instruments_displaysettings_button_inline_2x.png) in the inspector pane to customize the following display settings.

Track Display Settings

These settings control how information is displayed in the timeline pane.

Setting

Description

Options

Style

How information is presented. This is a fixed setting, which can’t be changed.

  • GPU Hardware

Detail Pane Columns

Narrative Heuristics Detail Type

The following narrative heuristics columns are available in the detail pane.

Column name

Definition

Timestamp

The time an interesting event occurred.

Narrative

Information about an interesting event that occurred.

GPU Activity Detail Type

The following GPU activity columns are available in the detail pane.

Column name

Definition

Event

An event within your processing pipeline. This can be a Vertex, Fragment, or Compute processing phase.

State

The state of the event. This can be Busy or Idle.

Start Time

The start time of the event.

End Time

The end time of the event.

Duration

The duration of the event.

Notes

Additional notes about the event (e.g. "Partial render").

Summary Detail Type

The following summary columns are available in the detail pane.

Column name

Definition

Event/State

A GPU hardware event within your processing pipeline and its corresponding state. An event may be a Vertex, Fragment, or Compute processing phase in a Busy or Idle state.

Count

The number of events.

Total Duration

The total duration of the events. This mainly includes the function processing time, but may also include time costs of additional operations (e.g. tiling).

Min Duration

The minimum duration of the events.

Avg Duration

The average duration of the events.

Max Duration

The maximum duration of the events.

Std Dev Duration

The standard deviation of the events' duration.