Skip to main content

Eclipse Community Forums
Forum Search:

Search      Help    Register    Login    Home
Home » Eclipse Projects » Eclipse Titan » User guide for LTTng and Trace Compass with Titan
User guide for LTTng and Trace Compass with Titan [message #1770720] Wed, 16 August 2017 13:07
Bence Janos Szabo is currently offline Bence Janos SzaboFriend
Messages: 9
Registered: April 2017
Junior Member
User guide for LTTng and Trace Compass with Titan

Representing LTTng logs generated by TTCN-3 applications compiled and executed with Titan in Trace Compass permits understanding the interactions between the Linux kernel and the applications themselves.
Usage of resources (memory, CPU, file I/O) can be monitored and connected to the executing code, thus permitting the optimization of the code.

  1. Eclipse Titan installation

    For installation from a binary package, please see the Eclipse Titan installation guide packed with binaries. When installing from source, refer to the README.linux file in github:

  2. Installing the LTTng Tracer
    On Ubuntu 16.04 the following packages have to be installed:

    • lttng-tools
    • lttng-modules-dkms
    • liblttng-ust0
    • liblttng-ust-dev

  3. Configuring Titan to compile the LTTng logger and logging with the LTTng logger

    In the Makefile.personal add the following line:

    Then recompile TITAN using:
    make distclean && make && make install

    It is advised to use the clang 3.8 compiler when compiling the LTTng logger. If the LTTng logger does not compile, then try installing the LTTng tracer from source:
    After the TITAN compilation is finished add the following line to your runtime configuration file to use the LTTng logger:
    LoggerPlugins := { LTTngUSTLogger := "liblttng-ust-logger" }

    Do not forget to use the dynamic runtime library of TITAN in the Makefile
    (TTCN3_LIB = libttcn3-dynamic or TTCN3_LIB = libttcn3-parallel-dynamic).
    For more information about TITAN LTTng logger see the TITAN reference guide section

  4. Configuring the LTTng tracer

    To be able to trace kernel events the current user of the operating system must be added to the tracing group (needs root access) from terminal:
    sudo usermod -aG tracing username

    1. To create an lttng tracing session:
      sudo lttng create

    2. Create a channel with a large buffer size:
      sudo lttng enable-channel --kernel chan --subbuf-size=8M

    3. Add the following events to the tracing session:
      sudo lttng enable-event --kernel --channel=chan block_bio_backmerge
      sudo lttng enable-event --kernel --channel=chan block_bio_remap
      sudo lttng enable-event --kernel --channel=chan block_rq_complete
      sudo lttng enable-event --kernel --channel=chan block_rq_issue
      sudo lttng enable-event --kernel --channel=chan irq_handler_entry
      sudo lttng enable-event --kernel --channel=chan irq_handler_exit
      sudo lttng enable-event --kernel --channel=chan irq_softirq_entry
      sudo lttng enable-event --kernel --channel=chan irq_softirq_exit
      sudo lttng enable-event --kernel --channel=chan irq_softirq_raise
      sudo lttng enable-event --kernel --channel=chan kmem_mm_page_alloc
      sudo lttng enable-event --kernel --channel=chan kmem_mm_page_free
      sudo lttng enable-event --kernel --channel=chan lttng_statedump_block_device
      sudo lttng enable-event --kernel --channel=chan lttng_statedump_file_descriptor
      sudo lttng enable-event --kernel --channel=chan lttng_statedump_process_state
      sudo lttng enable-event --kernel --channel=chan mm_page_alloc
      sudo lttng enable-event --kernel --channel=chan mm_page_free
      sudo lttng enable-event --kernel --channel=chan net_dev_xmit
      sudo lttng enable-event --kernel --channel=chan netif_receive_skb
      sudo lttng enable-event --kernel --channel=chan sched_pi_setprio
      sudo lttng enable-event --kernel --channel=chan sched_process_exec
      sudo lttng enable-event --kernel --channel=chan sched_process_fork
      sudo lttng enable-event --kernel --channel=chan sched_switch
      sudo lttng enable-event --kernel --channel=chan sched_wakeup
      sudo lttng enable-event --kernel --channel=chan sched_waking
      sudo lttng enable-event --kernel --channel=chan softirq_entry
      sudo lttng enable-event --kernel --channel=chan softirq_exit
      sudo lttng enable-event --kernel --channel=chan softirq_raise
      sudo lttng enable-event --kernel --channel=chan --syscall all

      If callstack information is also needed, this can be added by following the instructions in:

    4. Add the following event to trace TITAN lttng logs:
      sudo lttng enable-event --userspace titan_core:'*'

    5. Start tracing:
      sudo lttng start

    6. Execute the program

    7. Stop tracing:
      sudo lttng stop

    The lttng tracer will generate log traces in the HOME_DIR/lttng-traces folder by default. To visualize and analyse the traces the Trace Compass tool can be used.

  5. Installing Trace Compass

    Eclipse Trace Compass is an open source application for viewing and analyzing any type of logs or traces. Its' goal is to provide views, graphs, metrics, and more to help extract useful information from these traces.
    Trace Compass can be downloaded from the website: or it can be installed as an eclipse plugin. For instructions see:
    It is advised to install the lttng-analyses scripts too. For installation instructions see:
    After Trace Compass is installed the traces generated can be imported into the tool and it will visualize it and gives useful information.

  6. Using Trace Compass

    In this section a short user guide will be presented. The full user guide can be found at:

    1. Open Trace Compass or Eclipse with installed Trace Compass plugin
    2. Create a new Tracing project
    3. After the Tracing project is created select the Traces folder under the Tracing project and select Import after right clicking on the Traces folder.
    4. An import window pops up and select your tracing folder to import the traces into Trace Compass
    5. After importing the traces it is possible to select different perspectives and different views which shows different information. The importing and analysis of the traces may take a long time, depending on the size of the log files
    6. To align different traces and view them together create a new Experiment and right click on the created Experiment and select Select traces option and select the traces which will be viewed together

  7. Examples

    In this view it is possible to see the CPU usage of processes. If a process is selected, then the referring usage is displayed with red lines:

    In this view it is possible to see the memory usage of processes in the Kernel Memory Usage view:

    In this view it is possible to see the disk I/O activity in the Disk I/O Activity view:

    The event statistics can be seen in diagrams. The user can make a selection in the Histogram or in one of the views and it will show the events in the selection:

    In this picture the statistics about the system calls can be seen:

The Trace Compass in combination with LTTng logging in Titan can be used to display and detect correlations between the TTCN-3 code execution and Linux resource usage. As such, can be used as an advanced debugging/analysis tool and should be promoted as such, certainly by the Eclipse Titan project, and, if possible, by the Trace Compass project.
Previous Topic:No custom encoding function found
Next Topic:How to fork a Titan process
Goto Forum:

Current Time: Wed Sep 26 08:40:34 GMT 2018

Powered by FUDForum. Page generated in 0.02338 seconds
.:: Contact :: Home ::.

Powered by: FUDforum 3.0.2.
Copyright ©2001-2010 FUDforum Bulletin Board Software

Back to the top