Instruments Help

This page offers a complete list of help articles for performing essential tasks with Instruments. The help articles are grouped into sections based on related tasks. See Instruments User Guide for in-depth information.

Contents:

About Instruments

Learn about the different windows and dialogs in Instruments.

About the Instruments Trace Document

About the Trace Document Toolbar

About the Trace Document Timeline Pane

About the Trace Document Detail Pane

About the Trace Document Inspector Pane

About the Library Palette

About the Flags Palette

About Trace Templates

About the Profiling Template Selection Dialog

About the Preferences Window

Launching Instruments

Learn how to open Instruments so you can begin profiling.

Launching Instruments from the Xcode Menu

Launching Instruments from the Dock

Adding Instruments to Your Dock

Launching Instruments from Launchpad

Launching Instruments from the Command Line

Creating, Saving, and Opening Trace Documents

Learn how to work with trace documents.

Creating a Trace Document

Saving a Trace Document

Saving a Trace Document as a Profiling Template

Opening a Trace Document

Closing a Trace Document

Targeting Devices and Processes

Learn how to select a device and process to profile.

Targeting a Device and Process

Targeting an iOS Device

Targeting an iOS Device Wirelessly

Targeting an Apple Watch

Accessing and Using Instruments

Lean how to work with individual instruments in a trace document.

Displaying the Library Palette

Filtering for a Specific Instrument in the Library Palette

Changing the View Mode of the Library Palette

Adding an Instrument to a Trace Document

Removing an Instrument from a Trace Document

Configuring an Instrument’s Record Settings

Configuring an Instrument’s Display Settings

Recording, Pausing, and Stopping Traces

Learn how to profile your app.

Recording a Trace

Setting Recording Options

Pausing a Trace

Stopping a Trace

Profiling from the Dock

Profiling Your App from the Xcode Build and Product Menus

Using a Default Template When Profiling from the Xcode Build and Product Menus

Profiling from the Xcode Gauges While Debugging

Profiling with the instruments Command-Line Tool

Collecting and Viewing Data with the iprofiler Command-Line Tool

Running a Trace in Deferred Mode

Running Instruments in Deferred Mode

Navigating Collected Data

Learn how to analyze data collected while profiling your app.

Zooming In and Out in the Timeline Pane

Filtering a Range of Data in the Timeline Pane

Setting Flags in the Timeline Pane

View Different Types of Data in the Detail Pane

Use the Extended Detail Pane

Accessing Trace Data for Multiple Runs

Accessing Source Code from Instruments

Configuring Instruments

Learn how to adjust various settings in Instruments.

Mapping Data to Source Code

Setting General Preferences

Setting Recording Preferences

Setting CPUs Preferences

Setting Symbols Preferences

Profiling Your App’s Performance

Learn how to check your app for performance problems.

Track CPU Core and Thread Use

Look for Performance Bottlenecks

Use Activity Monitor to Track Overall Network and Disk Use

Monitor Network Connections of an iOS App

Monitor Disk Use in OS X

Profiling Your App’s Graphics Performance

Learn how to check your app for graphics problems.

Measuring Core Animation Graphics Performance in iOS

Measuring OpenGL Activity in iOS

Finding Graphics-Related Bottlenecks in iOS or OS X

Profiling Your App’s Memory Usage

Learn how to check your app for memory problems.

Finding Abandoned Memory

Finding Memory Leaks

Finding Zombies

Profiling Your App’s Energy

Learn how to check your app for inefficient energy usage.

Measuring the Energy Impact of an iOS Device

Logging Energy Usage Directly on an iOS Device

Advanced Tasks

Learn how to perform advanced tasks in Instruments.

Creating a Custom Instrument