Table of Contents

  1. Table of Contents
  2. Overview
    1. About Tracing
    2. Features
    3. LTTng integration
  3. Installation
    1. LTTng Tracer
    2. Trace Compass Plug-ins
    3. LTTng Control Dependencies
    4. Installation Verification
  4. Trace Compass Main Features
    1. Tracing Perspective
    2. Project Explorer View
      1. Creating a Tracing Project
      2. Importing Traces to the Project
        1. Opening a Trace
        2. Importing
        3. Drag and Drop
      3. Trace Package Exporting and Importing
        1. Exporting
        2. Importing
      4. Remote Fetching
        1. Remote Profile elements
          1. Profile
          2. Connection Node
          3. Trace Group
          4. Trace
        2. Profile editing and management
        3. Selecting remote traces
      5. Selecting a Trace Type
      6. Opening a Trace or Experiment
      7. Creating a Experiment
      8. Selecting Traces for an Experiment
      9. Removing Traces from an Experiment
      10. Renaming a Trace or Experiment
      11. Copying a Trace or Experiment
      12. Deleting a Trace or Experiment
      13. Deleting Supplementary Files
      14. Link with Editor
    3. Events Editor
      1. Searching and Filtering
        1. Searching
        2. Filtering
        3. Bookmarking
      2. Event Source Lookup
        1. Source Code
        2. EMF Model
      3. Exporting To Text
      4. Collapsing of Repetitive Events
      5. Customization
    4. Histogram View
    5. Statistics View
    6. Colors View
    7. Filters View
    8. Time Chart View
    9. State System Explorer View
    10. Custom Parsers
      1. Creating a custom text parser
      2. Creating a custom XML parser
      3. Managing custom parsers
      4. Opening a trace using a custom parser
    11. Automatic Time Axis Alignment
  5. LTTng Tracer Control
    1. Control View
      1. Creating a New Connection to a Remote Host
      2. Disconnecting from a Remote Host
      3. Connecting to a Remote Host
      4. Deleting to a Remote Host Connection
      5. Creating a Tracing Session
      6. Creating a Tracing Session With Advanced Options
      7. Creating a Snapshot Tracing Session
      8. Creating a Live Tracing Session
      9. Enabling Channels - General
      10. Enabling Channels On Session Level
      11. Configuring Trace File Rotation
      12. Configuring per UID and per PID Buffers (UST only)
      13. Configuring Periodical Flush for metadata Channel
      14. Enabling Channels On Domain Level
      15. Enabling and Disabling Channels
      16. Enabling Events - General
      17. Enabling Kernel Events On Session Level
      18. Enabling UST Events On Session Level
      19. Enabling Events On Domain Level
      20. Enabling Events On Channel Level
      21. Enabling and Disabling Events
      22. Enabling Tracepoint Events From Provider
      23. Configuring Filter Expression On UST Event Fields
      24. Adding Contexts to Channels and Events of a Domain
      25. Adding Contexts to All Events of a Channel
      26. Adding Contexts to an Event of a Specific Channel
      27. Start Tracing
      28. Recording a Snapshot
      29. Stop Tracing
      30. Destroying a Tracing Session
      31. Refreshing the Node Information
      32. Quantifing LTTng overhead (Calibrate)
      33. Importing Session Traces to a Tracing Project
      34. Importing Network Traces to a Tracing Project
    2. Properties View
    3. LTTng Tracer Control Preferences
  6. LTTng Kernel Analysis
    1. LTTng Kernel Perspective
    2. Control Flow View
      1. Process tree and information
      2. Control flow
        1. Using the mouse
        2. Using the keyboard
        3. Incomplete regions
        4. Zoom region
        5. Tooltips
      3. Toolbar
    3. Resources View
      1. Navigation
      2. Incomplete regions
      3. Toolbar
    4. LTTng CPU Usage View
      1. Process Information
      2. CPU Usage Chart
        1. Using the mouse
        2. Tooltips
        3. Toolbar
    5. LTTng Kernel Events Editor
  7. LTTng-UST Analyses
    1. Call Stack View
      1. Using the Callstack View with LTTng-UST traces
      2. Importing a function name mapping file for LTTng-UST traces
    2. Memory Usage
      1. Using the mouse
      2. Toolbar
  8. Trace synchronization
    1. Obtain synchronizable traces
      1. LTTng-module network tracepoint with complete data
      2. LTTng-modules addons kernel module with dynamic tracepoints
    2. Synchronize traces in Trace Compass
  9. Time offsetting
    1. Basic mode
    2. Advanced mode
    3. Clearing time offset
  10. Timestamp formatting
  11. Data driven analysis
    1. Importing an XML file containing analysis
    2. Defining XML components
    3. Defining an XML state provider
      1. Definitions and example
      2. Determining the state system structure
      3. Writing the XML state provider
      4. Debugging the XML state provider
    4. Defining an XML time graph view
    5. Defining an XML XY chart
  12. Limitations
  13. How to use LTTng to diagnose problems
    1. Random stutters
    2. Slow I/O
  14. References