Guides and Sample Code

Developer

Instruments User Guide

On This Page

Graphics Driver Activity Instrument

Overview

Instrument Description

Records command buffer scheduling and submission events in the graphics driver. This Instrument monitors CPU-side events.

Supported Platforms

iOS

Related Profiling Templates

Metal Application Instrument

Timeline Pane

The timeline pane displays a graph indicating command buffer scheduling and submission events in the graphics driver.

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.

  • Nested Data

Detail Pane Columns

Graphic Driver Events Detail Type

The following graphic driver events columns are available in the detail pane.

Column name

Definition

Source

The object responsible for the driver event (e.g. a framebuffer).

Event

The driver event (e.g. an attachment action).

Timestamp

The time at which the event occurred.

Notes

Additional notes about the event (e.g. "Depth store").

Process

The process that created the event.

Command Buffer

The command buffer associated with the event.

Encoder

The command encoder associated with the event.

Resource Events Detail Type

The following resource events columns are available in the detail pane.

Column name

Definition

Timestamp

The time at which the event occurred.

Event

ID

Label

Type

Num Bytes

Process

Shader Compilation Detail Type

The following shader compilation columns are available in the detail pane.

Column name

Definition

Source

The type of shader compiled. This can be a Vertex, Fragment, or Compute shader.

Start Time

The start time of the shader compilation.

End Time

The end time of the shader compilation.

Duration

The duration of the shader compilation.

Process

The process that created the shader.

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.

Graphic Driver Processing Detail Type

The following graphic driver processing columns are available in the detail pane.

Column name

Definition

Event

The driver event (e.g. a kernel submission).

Start Time

The start time of the event.

End Time

The end time of the event.

Duration

The duration of the event.

Process

The process that created the event.

Frame

The frame at which the event occurred.