Get Started

  • 2021.1
  • 12/04/2020
  • Public Content

Get Started with the Intel® System Debugger - System Trace
for Linux* OS Host

The System Trace feature of the Intel® System Debugger provides an
Eclipse* IDE
plug-in that adds the capability to access the Intel® Trace Hub providing advanced SoC-wide instruction and data events tracing through its trace viewer.
Intel® System Debugger is available as part of the Intel® System Bring-up Toolkit. Access to this toolkit requires a signed corporate Confidential Non-Disclosure Agreement (CNDA). See the toolkit product page.
This document covers only a publicly available subset of content. Once you install the product, refer to the documentation inside the product package as a primary and complete source of information. You can find all documentation at
<install-dir>\documentation_<year>\en\debugger
In case you need assistance installing or running this product, please visit our Get Help page for support options.
For discussions, user-to-user help and general debugging information, please also join our online community.
Python* 3 is used by default.

Prerequisites

For system requirements, see the Intel® System Debugger - System Trace User Guide and the Release Notes.

Installation

For details of the installation process, see the Intel® System Debugger - System Trace User Guide.

Starting the System Trace

If you have an existing workspace containing an old System Trace project, this project is probably not compatible with the newly-installed System Trace anymore.
Whenever you install a newer version of Intel® System Debugger including the System Trace, create a new Eclipse* IDE workspace or at least a new System Trace project.
  1. Launch the Intel® System Debugger by running
    <
    install-dir
    >/system_debugger/<
    version
    >
    /isd_eclipse-launcher.sh
    , where
    <
    install-dir
    >
    is the root directory of your Intel® oneAPI toolkit installation. By default,
    <
    install-dir
    >
    is
    /opt/intel/oneapi/
    .
    .
  2. To open the System Trace plugin, go to
    Window
    Open Perspective
    Other
    .
  3. Choose
    System Trace
    as the perspective. The System Trace default window is displayed. The first time you launch, the System Trace will show a welcome dialog, which guides you through the first steps.
Options available in the
Welcome to System Trace
dialog box:
Help me setup a new project
This option will guide you through the process of creating a trace project.
Import a project
This option will open the Intel® System Debugger import dialog to import existing trace projects.

Importing an Existing Trace Capture Archive/Trace Capture File (Bin-file)

To import an existing trace capture archive file, such as one of the examples which can be found in
<
install-dir
>/system_debugger/<
version
>/system_trace/examples/input
, you need to import that file into your trace viewer.
To import a sample System Validation Events (SVEN) trace included in a Trace Capture Archive or in a plain bin-file:
  1. Launch the
    Intel® System Debugger
    .
  2. Switch to the Trace perspective.
  3. Go to
    File
    Import ...
    .
  4. Browse to
    System Trace
    Trace Capture
    .
  5. Click
    Next
    .
  6. Select the Trace Capture Archive by clicking
    Browse…
    .
    Locate
    sven_stp_data_bxt.tracecpt
    in the directory
    <
    install-dir
    >/system_debugger/<
    version
    >/system_trace/examples/input
    .
    If you want to import a bin file, select the
    *.*
    file filter on the bottom right corner of the file browse dialog.
  7. Select the trace project you want to import the data from. If you do not have a project, type in a name for your new project and select
    Create trace project
    .
  8. Click
    Finish
    to import the trace capture archive.
  9. In the
    Project Explorer
    expand the capture node. You should see a
    sven_stp_data_bxt
    entry.
  10. Right-click the
    sven_stp_data_bxt
    entry and select
    Decode
    .
The sample trace is displayed in the trace viewer.
For more information about how to use the System Trace, see Intel® System Debugger - System Trace User Guide

Training and Documentation

Document
Description
This document provides information about how to install and start the System Trace on Eclipse*.
Release Notes (available in the Intel® Registration Center download page for Intel® System Debugger)
Contain the most up-to-date information about the Intel® System Debugger in general and Intel® Debug Extensions for WinDbg* in particular, including:
  • Overview information (including new features and product contents)
  • System requirements (hardware and software requirements for installing and using the product)
  • Known limitations
  • Technical support (links to contacts for reporting problems and getting assistance)
Intel® System Bring-up toolkit product page. See this page for support and instructions for obtaining the toolkit.
Intel® oneAPI product page. See this page for support and documentation for other toolkits.

Notices and Disclaimers

Intel technologies may require enabled hardware, software or service activation.
No product or component can be absolutely secure.
Your costs and results may vary.
© Intel Corporation. Intel, the Intel logo, and other Intel marks are trademarks of Intel Corporation or its subsidiaries. Other names and brands may be claimed as the property of others.
No license (express or implied, by estoppel or otherwise) to any intellectual property rights is granted by this document.
The products described may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request.
Intel disclaims all express and implied warranties, including without limitation, the implied warranties of merchantability, fitness for a particular purpose, and non-infringement, as well as any warranty arising from course of performance, course of dealing, or usage in trade.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.