Information

likwid-perfscope is a command line application written in Lua that uses the timeline daemon mode of likwid-perfctr to create on-the-fly pictures with the current measurements. It uses the feedGnuplot Perl script to send the current data to gnuplot. In order to make it more convenient for users, preconfigured plots of interesting metrics are embedded into likwid-perfscope. Since the plot windows are normally closed directly after the execution of the monitored applications, likwid-perfscope waits until Ctrl+c is pressed.

Options

Option	Description
-h, –help	Print help message.
-v, –version	Print version information.
-a, –all	Print available predefined plot configurations for current processor.
-d, –dump	Print measurements to stdout.
-p, –plotdump	Use feedGnuplots feature to dump plot configuration and its data to stdout.
-c <arg>	Defines the CPUs that should be measured See CPU_expressions on the `likwid-pin` page for information about the syntax.
-C <arg>	Defines the CPUs that should be measured and pin the executable to the CPUs See CPU_expressions on the `likwid-pin` page for information about the syntax.
-t, –time <time>	Specify the measurement time for each plot. <time> is handled over to `likwid-perfctr` with the -t option. Examples for <time> are 1s, 250ms, 500us.
-g, –group <arg>	Specify a predefined plot with optional changes or an eventset.
-r, –range <arg>	Specify the amount of data points that should be visible in the plots. Often refered to as sliding window.
–host <arg>	Connect to <arg> via ssh and execute likwid-perfctr and the application there. The plots are created on the local machine. Often used if measured on hosts without X11 or GnuPlot.

Examples

likwid-perfscope -g L3 -C 0-2 -t 1s ./a.out
Pin the executable ./a.out to CPUs 0,1,2 and use the predefined plot configuration L3 The plot is updated ever second.
likwid-perfscope -g L3 -C S0:1 -t 500ms ./a.out
Pin the executable ./a.out to CPU 1 on Socket 0 and use the predefined plot configuration L3.
likwid-perfscope -g ENERGY -C S0:1 -r 10 -t 500ms ./a.out
Pin the executable ./a.out to CPU 1 on Socket 0 and use the predefined plot configuration ENERGY. Use a sliding window that contains 10 data points.

*/