About the Instruments Trace Document

Use the trace document of the Instruments analysis tool to control and analyze data collection. Data collection and analysis is based on your configuration of the trace document. The trace document consists of six major areas:

  • Toolbar: Contains the basic controls for recording data and controlling how the trace document is displayed.

  • Instruments pane: Contains the individual instruments currently active in the trace document.

  • Track pane: Displays a graphical summary of the data collected.

  • Detail pane: Contains details about the data your instruments collected.

  • Extended Detail pane: Displays information about the item currently selected in the Detail pane.

  • Navigation bar: Displays a quick view of how you got to your current location. Click entries in the navigation bar to select the active instrument and the level and type of information in the detail view.

../Art/instruments_window_help.jpg

Toolbar: It is made up of the following sections:

  • Record: Three buttons allow you to pause, record, stop, and loop data collection actions.

  • Target: Your choice in the pop-up menu designates the target for data collection. You can set the target for all instruments here or specify that each instrument has its own target set by you.

  • Inspection Range: Controls the beginning and ending points for inspection. Only the information located between these points is displayed in the Detail pane. Use the center button to clear the currently selected beginning and ending points. If no time filter is created, the Detail pane displays information on all of the collected data.

  • Time/Run: This activity viewer shows the elapsed time of the current trace. Use the arrows to switch between multiple trace runs.

  • View: Controls display of the Instruments, Detail, and Extended Detail panes.

  • Library: The button hides or shows the instruments library. The library contains a complete list of available instruments.

  • Search: The text you enter into the field filters information displayed in the Detail pane.

Instruments pane: Each instrument is lined up with its data collection graph displayed in the Track pane. Clicking the inspector button allows you to configure the chosen instrument.

Track pane: Each track is lined up with its controlling instrument in the Instruments pane. You can change how the information is displayed by configuring its corresponding instrument.

Detail pane: You can narrow the amount of information displayed by creating a time filter in the Track pane.

Extended Detail pane: Selecting an item in the Detail pane causes the Extended Detail pane to show more information about the item. This typically includes the stack trace, timestamp, and any instrument specific data.

Navigation bar: Contains two menus:

  • Active instrument menu - You can select which instrument’s information to display in the Display pane.

  • Detail view menu - You can select the type of information to display in the Display pane. This varies depending on the data collected.

Definitive Discussion