Skip to content
Tracing tools for ROS
C++ CMake Shell
Branch: devel
Clone or download
Latest commit 2813379 Jun 26, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
include/tracetools Update tracetools.h Jun 26, 2018
lttng simplify repo Oct 10, 2017
scripts remove analysis stuff, is going to a new repository Nov 7, 2017
src/tracetools Fix indent Jun 25, 2018
test Merge Jun 26, 2018
.gitignore Ignore autogenerated compiler info Jun 25, 2018
.travis.yml enable lttng in Travis build Oct 26, 2017
3rd-party-licenses.txt simplify repo Oct 10, 2017
CHANGELOG.rst Add ChangeLog Oct 24, 2017
CMakeLists.txt Add ChangeLog Oct 24, 2017
LICENSE simplify repo Oct 10, 2017
NOTICE simplify repo Oct 10, 2017 fix URL Nov 7, 2017
dependencies.rosinstall add travis config Oct 26, 2017
mainpage.dox simplify repo Oct 10, 2017
package.xml release 0.2.1 Jun 26, 2018
rosdoc.yaml simplify repo Oct 10, 2017


The tracetools library is an Open Source project that provides tracing functions for message-passing middleware, specifically ROS.

Intended use

The intended use of this software is for collecting data from robotic systems during development.

The software is not targeted at use during production and has not been tested for this purpose. However, the license conditions of the applicable Open Source licenses allow you to adapt the software to your needs. Before using it in a safety relevant setting, make sure that the software fulfills your requirements and adjust it according to any applicable safety standards.

Instructions for use

This is a regular catkin package and can just be dropped into your workspace as-is.

Then either call the ros::trace methods directly, or use our modified ros_comm version.

However, to actually generate tracing output, you need to

  1. Install LTTNG using (example for Ubuntu) $ sudo apt install liblttng-ust-dev lttng-tools lttng-modules-dkms
  2. Pass WITH_LTTNG (example for catkin tools) $ catkin config -DWITH_LTTNG=ON
  3. Recompile your workspace
  4. TEST tracing with the included test script $ rosrun tracetools tracetools_test In this case, "no news is good news". If a problem occurs, the script will let you know.

At runtime, LTTng is not active by default (so you can leave it in your programs with no impact). To collect trace data, you need to start an LTTng session. In this package, in, a simple configuration script is included.

For even easier usage, with automatic data conversion, check out the tracetools_analysis package. It provides a Python API for easy definition, execution and analysis of tracing experiments.


This package is open-sourced under the Apache-2.0 license. See the LICENSE file for details.

For a list of other open source components included in this package, see the file 3rd-party-licenses.txt.

You can’t perform that action at this time.