README.md

MOJITO/S

An Open Source System, Energy and Network Monitoring Tools at the O/S level MojitO/S runs on GNU/Linux

Usage

Usage : ./bin/mojitos [OPTIONS] [SENSOR ...] [-e <cmd> ...]

OPTIONS:
-f|--freq <freq>
	set amount of measurements per second.
-t|--time <time>
	set duration value (seconds). If 0, then loops infinitely.
-e|--exec <cmd> ...
	Execute a command with optional arguments.
	If this option is used, any usage of -t or -f is ignored.
-o|--logfile <file>
	specify a log file.
-s|--overhead-stats
	enable overhead statistics (nanoseconds).

The following is an exhaustive list of all the sensors (it is very likely that one will not have all the sensors activated in his build):

SENSORS:
-r|--amd-rapl
	AMD RAPL (micro-joules)
-p|--perf-list <perf_list>
	performance counters
	perf_list is a coma separated list of performance counters.
	Ex: instructions,cache_misses
-l|--list
	list the available performance counters and quit
-i|--monitor-infiniband <infiniband_path>
	infiniband monitoring (if infiniband_path is X, tries to detect it automatically)
-u|--sysload
	system load
-d|--net-dev <net_dev>
	network monitoring (if network_device is X, tries to detect it automatically)
-n|--nvidia-gpu
	provides basic gpu information [clocks, memory, utilization, power, temperature].
-r|--intel-rapl
	INTEL RAPL (micro-joules)
-c|--cpu-temp
	processor temperature
-m|--memory
	Retrieves information about the memory via the syscall 'sysinfo(2)'.
-M|--memory-counters <memory_list>
	memory counters
	memory_list is a coma separated list of memory counters.
	Ex: Zswap,Zswapped
-L|--memory-list
	list the available memory counters and quit
-k|--likwid <perf_list>
	performance counters
	perf_list is a coma separated list of performance counters with associated register.
	Ex: FP_ARITH_INST_RETIRED_128B_PACKED_DOUBLE:PMC0,FP_ARITH_INST_RETIRED_SCALAR_DOUBLE:PMC1
-w|--list-likwid
	list the available performance counters and quit

Installation Instructions

Download the source code

git clone https://gitlab.irit.fr/sepia-pub/mojitos.git

The quickest way to compile the code is:

cd mojitos
./configure.sh
make

You may want to run ./configure.sh --help to see configuration options.

To use amd_rapl you have to load the module msr

sudo modprobe msr

To execute mojitos without being root to monitor performance counters

sudo sh -c 'echo 0 >/proc/sys/kernel/perf_event_paranoid'

To execute mojitos without being root for accessing RAPL

sudo chmod a+w /sys/class/powercap/intel-rapl/*/*
sudo chmod a+w /sys/class/powercap/intel-rapl/*/*/*

For now likwid backend needs mojitos to run root privileges

Tutorial and Examples