Intel® System Debugger User Guide

ID 648476
Date 06/13/2024
Confidential
Document Table of Contents

Select Trace Fields to Be Displayed

In many cases, you are interested in only a certain set of trace fields, which are shown as columns in the trace viewer. You can customize the column display of the trace viewer with the Select Columns dialog in Message View.

  1. Open Select Columns dialog from the Message View toolbar :

    17_ToolbarButtonColumnSelection

    Or right click in message view and pick “Select Columns…” item from context menu.

    18_MenuColumnSelection

  2. The Message View Select Columns dialog is opened.

    The dialog contains two tabs: Common and Advanced. The selection is synchronized between the tabs.

    • The Common tab displays commonly used fields and grouped by use cases or protocols:

      19_ColumnSelectionDialog

    • The Advanced tab displays every selectable field for a session, where the metadata fields retain their hierarchical structure within BLOB as the root node of the metadata tree. The Default node contains additional fields that are not part of the metadata.

      20_AdvancedColumnSelection

    Note:

    The All node is great for clearing selection, but it is not recommended to simply enable all fields in Advanced tab. A maximum of 32 fields can be selected.

    Some fields are common fields and are shared across protocols. When you enable or disable one of these fields, it will be enabled or disabled across all protocols.

  3. To implement your selection, click OK in the Message View Select Columns dialog.

The trace viewer now displays all selected fields of the session.

Create Column Presets

The column preset feature allows you to save column settings and load them very easily. In the Message View, expand the drop down menu to show the available column presets:

84_Preset

To create a new custom column preset, do the following:

  1. Enable all columns in the Message View you want to have in your new preset.

  2. Select Column Preset Settings from the column picker drop down menu.

    23_ColumnPresetSettings

  3. In the new dialog, click Add to create a new column preset.

    24_ColumnPresetAdd

    In the left List of preset settings*column, you can type in a new name for the column preset. The right column (*Columns in the selected preset) shows the columns you have activated in the Message View. If you want to rename the new column preset, right click on the entry and choose Rename.

  4. Click OK to save the preset in your workspace.

  5. The new column preset will show up in the column picker drop down menu:

    25_ColumnPresetNew

To import column presets, do the following:

  1. Open the Column Preset Settings and click Import on the right.

  2. Select the .columnOrder file you want to import and click Open.

  3. If the Message View Column Presets dialog detects that you try to import existing settings, it asks if the column preset should be overwritten or not:

    28_ColumnPresetImportAsk

    • Select Yes to overwrite the existing column preset in the list.

    • Select No to skip importing the existing column preset.

    • Select Yes to All to overwrite all existing column presets in the list from the import file.

    • Select No to All to skip importing all existing column presets.

To export column presets:

  1. Click Export in the Column Preset Settings.

  2. Choose a location and a filename in the file picker and click Save.

To restore default presets, click Restore Defaults in the Column Preset Settings:

30_ColumnPresetRestore

Warning:

Your custom presets will be removed.