Guides and Sample Code

Developer

Instruments User Guide

On This Page

Activity Monitor Instrument

Overview

Instrument Description

The Activity Monitor instrument captures information about the load on the system measured against the virtual memory size. It can record information from a single process or from all processes running on the system.

Supported Platforms

iOS

OS X

Related Profiling Templates

Activity Monitor Profiling Template

Timeline Pane

The timeline pane displays the information shown in the following list, based on the instrument’s configuration. TotalVMSize, CPUTotalLoad, CPUUserLoad, and CPUSystemLoad are displayed by default. You enable additional statistics in the record settings area in the inspector pane.

Statistic name

Definition

SampleNumber

The number of the sample taken.

TotalThreads

The total number of threads.

PhysicalMemoryWired

The amount of memory used by the operating system.

PhysicalMemoryActive

The amount of memory currently used by processes.

PhysicalMemoryInactive

The amount of memory that was recently released.

PhysicalMemoryUsed

The total amount of memory that was used during the sample.

PhysicalMemoryFree

The amount of memory available for use.

TotalVMSize

The total size of the virtual memory.

VMPageInBytes

The amount of memory calls to RAM.

VmPageOutBytes

The amount of memory sent to the hard drive.

VMSwapUsed

The amount of memory called from the hard drive.

NetPacketsIn

The total number of network packets received.

NetBytesIn

The total number of network bytes received.

NetPacketsOut

The total number of network packets sent.

NetBytesOut

The number of bytes sent each second.

NetPacketsInPerSecond

The number of packets received each second.

NetPacketsOutPerSecond

The number of packets sent each second.

NetBytesInPerSecond

The number of bytes received each second.

NetBytesOutPerSecond

The number of bytes sent each second.

DiskReadOps

Total number of disk read operations.

DiskBytesRead

Total number of bytes read.

DiskWriteOps

Total number of disk write operations.

DiskBytesWritten

The number of bytes written each second.

DiskReadOpsPerSecond

The number of read operations each second.

DiskWriteOpsPerSecond

The number of write operations each second.

DiskBytesReadPerSecond

The number of bytes read each second.

DiskBytesWrittenPerSecond

The number of bytes written each second.

CPUTotalLoad

Percentage of the total load on the device during the sample.

CPUUserLoad

Percentage of the load caused by the user during the sample.

CPUSystemLoad

Percentage of the load caused by the operating system during the sample.

CPUNiceLoad

Percentage of the load caused by processes with a priority different from their normal priority.

Record Settings

Click the Record Settings button (image: ../Art/instruments_recordsettings_button_inline_2x.png) in the inspector pane to customize the following recording options.

Sampling Rate

Set how often the instrument records information. The slider allows sampling from 1/10th of a second to 1 second in 1/10th of a second increments. The text field allows for other 1/10th increments. The default value is 1/10th of a second.

System Statistics

Select a statistic to see it graphed in the track pane. Click the shape or the color well to change how a statistic is represented.

Select statistics to list

Select the statistics you want displayed in the System Statistics settings area, where their visibility in the track pane may be enabled or disabled.

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.

  • Block Graph: Information is presented as a horizontal line until the information changes. The area under the line is filled by the statistic’s designated color.

  • Peak Graph: Maximum value for the information is displayed. Lines are in the statistic’s designated color.

Process Detail Tracking

Choose whether to display the most recent values in the detail pane, or values based on the position of the inspection head in the track pane. Options include “Track inspection head” and “Display latest,” which is the default.

Process Life Span Filtering

Choose whether to display values for all processes, or only those that were created and are still running. Options include “Created & still living,” which is the default, and “All processes.”

Parent Child Outline

Choose whether to keep the nodes in the Parent Child outline in the detail pane expanded. The default is to not keep nodes expanded.

Detail Pane Columns

Summary Detail Type

The following summary columns are available in the detail pane.

Column name

Definition

Process ID

The process identifier.

Process Name

The name of the process.

User Name

The name of the user calling the process.

% CPU

The percentage of the CPU used by the process.

Threads

The number of threads used by the process.

Real Mem

The amount of real memory used by the process.

Virtual Mem

The amount of virtual memory used by the process.

Architecture

The device architecture.

CPU Time

The total CPU time used by the process.

Sudden Term

Whether or not the process was suddenly terminated.

Parent Child Detail Type

The following parent child columns are available in the detail pane.

Column name

Definition

Process ID

The process identifier.

Process Name

The name of the process.

User Name

The name of the user calling the process.

% CPU

The percentage of the CPU used by the process.

Threads

The number of threads used by the process.

Real Mem

The amount of real memory used by the process.

Virtual Mem

The amount of virtual memory used by the process.

Architecture

The device architecture.

CPU Time

The total CPU time used by the process.

Sudden Term

Whether or not the process was suddenly terminated.

Samples Detail Type

The following samples columns are available in the detail pane.

Column name

Definition

#

The number of the sample taken.

Total Threads

The total number of threads active during the sample.

Physical Memory Wired

The amount of memory used by the operating system.

Physical Memory Active

The amount of memory currently used by processes.

Physical Memory Inactive

The amount of memory that was recently released.

Physical Memory Used

The total amount of memory that was used during the sample.

Physical Memory Free

The amount of memory available for use.

VM Size

The total size of the virtual memory.

Page Ins

The amount of memory calls to RAM.

Page Outs

The amount of memory sent to the hard drive.

Swap Used

The amount of memory called from the hard drive.

Net Packets In

The total number of network packets received.

Net Bytes In

The total number of network bytes received.

Net Packets Out

The total number of network packets sent.

Net Bytes Out

The total number of network bytes sent.

Net Packets In Per Second

The number of packets received each second.

Net Packets Out Per Second

The number of packets sent each second.

Net Bytes In Per Second

The number of bytes received each second.

Net Bytes Out Per Second

The number of bytes sent each second.

Disk Read Ops

Total number of disk read operations.

Disk Bytes Read

Total number of bytes read.

Disk Write Ops

Total number of disk write operations.

Disk Bytes Written

Total number of bytes written.

Disk Read Ops Per Second

The number of read operations each second.

Disk Write Ops Per Second

The number of write operations each second.

Disk Bytes Read Per Second

The number of bytes read each second.

Disk Bytes Written Per Second

The number of bytes written each second.

% Total Load

Percentage of the total load on the device during the sample.

% User Load

Percentage of the load caused by the user during the sample.

% System Load

Percentage of the load caused by the operating system.

% Nice Load

Percentage of the load caused by processes with a priority different from their normal priority.