A trace viewer and analyzer for LTTng kernel and user space traces
Switch branches/tags
Clone or download
eepp Bump version to 0.5.0-SNAPSHOT
Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>
Latest commit f9bc62c Oct 12, 2018

README.adoc

LTTng Scope

LTTng Scope is a trace viewer and analyzer for LTTng kernel and user space traces.

LTTng Scope supports Windows, macOS, and Linux. The source code is available under the Eclipse Public License.

Note
LTTng Scope is currently under development. There are still known bugs and some parts need to be optimized.

Installation

Binary installer

See the Beta section of the LTTng website for the latest downloadable installers for Windows, macOS, and Linux.

The installers ship with the required Java virtual machine.

Build from source

You need:

  • Java 8

  • JavaFX

  • Maven 3.3 or later

If you use Oracle’s JVM, which is typical on Windows and macOS, then JavaFX is already included.

If you use OpenJDK, you might need to install OpenJFX separately. On Debian and Ubuntu, you can run the following command to install the requirements:

sudo apt install openjdk-8-jre openjdk-8-jdk openjfx

To build and install LTTng Scope from source:

  1. Clone this repository.

  2. Run:

    mvn clean install -DskipTests

When the mvn command finishes, you can start LTTng Scope:

java -jar lttng-scope-ui/target/lttng-scope-ui-*-jar-with-dependencies.jar

Relation to Trace Compass

LTTng Scope is based on some parts of the Trace Compass source code. However, it is meant to be a separate project with different design goals. While Trace Compass aims to support any analysis for any trace type, LTTng Scope aims to:

  • Focus on LTTng use cases.

  • Streamline the user experience.

Running analyses on the command line (in a CI server, for example) with text-based output is also within the realm of possibilities.

Community

Mailing list

lttng-dev (lttng-dev@lists.lttng.org). Preferably, use the [lttng-scope] subject prefix.

IRC

#lttng on the OFTC network.

Code contribution

Create a new GitHub pull request.

Bug reporting

Create a new GitHub issue.

Continuous integration

LTTng Scope item on LTTng’s CI.

Blog

The LTTng blog contains posts about LTTng Scope.