Guides and Sample Code

Developer

Instruments User Guide

About This Document

To help you find the information you need quickly, this document is organized into parts that focus on specific aspects of Instruments.

  • The first main part focuses on using the Instruments app. It covers things like creating a document, finding an instrument to do what you need, profiling an app, analyzing data, and more. Go here to find out how to do general tasks.

  • Later parts cover more specialized tasks, such as boosting performance, resolving memory problems, and improving battery life.

  • The final parts provide a reference guide for individual instruments and templates, as well as additional resources and reference material.

Prerequisites

Background Knowledge

Before using Instruments, you should have a solid understanding of how Xcode works (see Xcode Overview), as well as key app development concepts, such as building and running an app, and provisioning a device.

You should also be familiar with core concepts for the type of profiling you want to perform. For example, if you’re checking your app for memory problems, then you should know a little about memory management and potential memory problems, such as leaks and zombies. If you’re checking your app for performance problems, you should know about CPU and thread utilization. If you’re trying to resolve battery problems, you should know about the kinds of things that can negatively affect power, such as display brightness, network interface (GPS, Bluetooth, Wi-Fi) usage, and timer utilizations.

Some background information on these and other topics has been provided throughout this guide. Links to additional resources can be found in:

System Requirements

Instruments is installed with Xcode. If you don’t already have Xcode installed, download it from the Mac App Store.

If you plan to profile an app on an iOS device, you’ll need to provision your device. See Launching Your App on Devices.