linux: Move SWSLatency outputs to Trace Compass core This commit moves the following outputs of the SWSLatency analysis from the incubator to Trace Compass core: [1] Sched Wakeup/Switch Latencies output: A re-use of the SegmentStoreTableView provided by Trace Compass. Each segment is the time difference between a sched_wakeup event and a sched_switch event of the same process, identified by the same TID. [2] Sched Wakeup/Switch Latency vs Time view: which uses the existing AbstractSegmentStoreScatterChartTreeViewer2 for its left side and the new SWSLatencyScatterGraphViewer for its right side. This view is a scatter chart, with each point showing the sched_wakeup/sched_switch latency vs the time when the latency happens. [3] Sched Wakeup/Switch Statistics view: A re-use of the SegmentStoreStatisticsView provided by Trace Compass. This view displays different statistics relating to the SWSLatency analysis, with each level corresponding to a process. [4] Sched Wakeup/Switch Density view: which uses the existing SegmentStoreTableViewer for its left side and the new SWSLatencyDensityViewer for its right side. This density view shows the number of latencies that corresponds to a specific duration. Manual testing is required to make sure the outputs provided by the analysis are consistent and to ensure that they are exposed to the users in the UI of Trace Compass. There are no unit tests for the SWSLatency outputs. To test the outputs: [1] Open a kernel trace that contains sched_wakeup and sched_switch events. Make sure that all of the 4 outputs are visible under Sched Wakeup Switch analysis. [2] Sched Wakeup/Switch Latencies: Make sure there is a duration column. When clicked on an entry, a group of consecutive rows should be highlighted in the trace tab. The first event (in the group) should be a sched_wakeup event and the last one should be a sched_switch event. The tid of the sched_wakeup event should be the same as the next_tid of the sched_switch event. The difference of the time stamp of the first and last event should be the same as the value as the duration column. [3] For the rest of the views, cross check to make sure that the data displayed make sense. For example, pick an event type, such as ls, and make sure that the event count in the Sched Wakeup/Switch Statistics view is the same as the number of dots displayed in the Sched Wakeup/Switch Latency vs Time view. Change-Id: Ibdd3ed5f2260f7638e1c581e6bf1ad3d22083aa6 Signed-off-by: Hoang Thuan Pham <hoang.pham@calian.ca> Reviewed-on: https://git.eclipse.org/r/c/tracecompass/org.eclipse.tracecompass/+/203535 Reviewed-by: Marco Miller <marco.miller@ericsson.com> Reviewed-by: Matthew Khouzam <matthew.khouzam@ericsson.com> Tested-by: Trace Compass Bot <tracecompass-bot@eclipse.org> Tested-by: Matthew Khouzam <matthew.khouzam@ericsson.com>
This source tree contains the source code for the Trace Compass plugins for Eclipse.
The plugins are categorized as follows:
analysis/ | Generic extensions to the base framework btf/ | Best Trace Format (BTF) integration common/ | Generic utilities that can be used by other plugins ctf/ | Common Trace Format (CTF) reader library doc/ | Documentation and code examples gdbtrace/ | Support for reading and viewing GDB traces lttng/ | LTTng integration pcap/ | libpcap integration rcp/ | Code specific to the RCP version releng/ | Releng-related plugins statesystem/ | State System library tmf/ | Core framework
See the components.svg file for a diagram showing the dependencies between the different components.
To set up the environment to build Trace Compass from within Eclipse, see this wiki page: http://wiki.eclipse.org/Trace_Compass/Development_Environment_Setup
The Maven project build requires version 3.3 or later. It can be downloaded from http://maven.apache.org or from the package management system of your distro.
To build the project manually using Maven, simply run the following command from the top-level directory:
mvn clean install
The default command will compile and run the unit tests. Running the tests can take some time, to skip them you can append -Dmaven.test.skip=true to the mvn command:
mvn clean install -Dmaven.test.skip=true
Stand-alone application (RCP) packages will be placed in rcp/org.eclipse.tracecompass.rcp.product/target/products.
The p2 update site, used for installation as plugins inside Eclipse, will be placed in releng/org.eclipse.tracecompass.releng-site/target/repository.
To generate the javadoc from the Trace Compass source code, run the following command from the top-level directory:
mvn clean package javadoc:aggregate
The javadoc html files will be under target/site/apidocs.
Trace Compass can be traced by doing the following in the launch configuration:
Additionally the folder the trace is being written to (default is home/.tracecompass/logs) needs to be created in advance. After running Trace Compass, a trace_n.json will be created in the tracing folder. It needs to be converted to true json, so use the jsonify.sh script in the root directory to convert it. Then it can be loaded into Trace Compass, if the Trace Event format is installed from the incubator, or from a web browser such as Chromium.
The performance impact is low enough as long as the log level is greater than “FINEST”.
NOTE: thread 1 is always the UI thread for Trace Compass. Also, the thread numbers are the JVM threads and do not correspond necessarily to Process IDs.
NOTE: if you want to build the RCP with older platforms than 4.12 you need to copy the legacy tracing.product: cp rcp/org.eclipse.tracecompass.rcp.product/legacy/tracing.product rcp/org.eclipse.tracecompass.rcp.product/
The following Maven profiles and properties are defined in the build system. You can set them by using -P[profile name] and -D[property name]=[value] in mvn commands.
-Dtarget-platform=[target]
Defines which target to use. This is used to build against various versions of the Eclipse platform. Available ones are in releng/org.eclipse.tracecompass.target. The default is usually the latest stable platform. To use the staging target for example, use -Dtarget-platform=tracecompass-eStaging.
-Dskip-tc-core-tests
Skips the automated core tests. Not required when using -Dmaven.test.skip=true or -DskipTests=true , which already skips all the tests.
-Dskip-short-tc-ui-tests
Skips the short UI integration tests. Not required when using -Dmaven.test.skip=true or -DskipTests=true, which already skips all the tests.
-Dskip-long-tc-ui-tests
Skips the long UI integration tests. Not required when using -Dmaven.test.skip=true or -DskipTests=true, which already skips all the tests.
-Dskip-rcp
Skips building the RCP archives and related deployment targets. Only works in conjunction with -Dskip-tc-long-ui-tests, due to a limitation in Maven.
-Pctf-grammar
Re-compiles the CTF grammar files. This should be enabled if you modify the .g files in the ctf.parser plugin.
-Prun-custom-test-suite
Runs a test suite present in releng/org.eclipse.tracecompass.alltests. The test suite to run has to be defined by -DcustomTestSuite=[name], for example -DcustomTestSuite=RunAllPerfTests.
-Pdeploy-rcp
Mainly for use on build servers. Copies the generated RCP archives, as well as the RCP-specific update site, to the paths specified by -DrcpDestination=/absolute/path/to/destination and -DrcpSiteDestination=/absolute/path/to/destination, respectively.
-Pdeploy-update-site
Mainly for use on build servers. Copies the standard update site (for the Eclipse plugin installation) to the destination specified by -DsiteDestination=/absolute/path/to/destination.
-Psign-update-site
Mainly for use on build servers. Signs all the generated update sites using the Eclipse signing server.
-Pdeploy-doc
Mainly for use on build servers. Copies the generated HTML documentation to the destination specified by -DdocDestination=/absolute/path/to/destination. Some directories may need to already exist at the destination (or Maven will throw related errors).
To compile the image of Trace Compass with Docker, run the following command from the top level directory:
docker build -f releng/dockerfiles/Dockerfile -t tracecompass .
The image will be tagged tracecompass.