EnergiBridge

Energibridge is a cross-platform energy measurement utility that provides support for Linux, Windows, and MacOS, as well as Intel, AMD, and Apple ARM CPU architectures.

This tool is designed to collect resource usage data for a command to execute and to output the data in a CSV format.

| OS | Intel CPU | AMD CPU | M1 CPU | Intel GPU | Nvidia GPU | AMD GPU | M1 GPU | | ------- | --------- | ------- | ------ | --------- | ---------- | ------- | ------ | | Linux | ✅ | ✅ | | | ✅ | | | | Windows | ✅ | ✅ | | | ✅ | | | | Mac | ✅ | | ✅ | ✅ | | ✅ | ✅ |

Requirements

Depending on your hardware you need different dependencies.

NVIDIA

• nvml

Install

Windows

Install LibreHardwareMonitor to access the CPU registry.

In an elevated (Administrator) command line (e.g. cmd.exe): ``` Create: sc create rapl type=kernel binPath=""

Start: sc start rapl

Stop: sc stop rapl

Delete: sc delete rapl

Build: cargo build -r ```

For PowerShell use sc.exe instead of sc.

Linux

Change the permission of the msr file to be able to read them without root access. The permissions are reseted each time your restart the machine.

sudo chgrp -R msr /dev/cpu/*/msr; sudo chmod g+r /dev/cpu/*/msr;

Build EnergiBridge

cargo build -r;

Provide the permission to the binary to read the registry. Since any non-root program accessing the msr also needs the rawio capability, if you move the binary you should eecute this line again

sudo setcap cap_sys_rawio=ep target/release/energibridge;

MacOS

Build EnergiBridge cargo build -r;

Usage

To run the script, use the following command:

``` Usage: energibridge[.exe] [OPTIONS] [COMMAND]...

Arguments: [COMMAND]...

Options: -o, --output

-s, --separator [default: ,] -c, --command-output

-i, --interval Duration of the interval between two measurements in micoseconds [default: 100] -m, --max-execution Define the maximum duration of the execution of the command in seconds, set to -1 to disable [default: 0] -g, --gpu Get GPU usage data --summary Provide a summary of the total energy consumption of running the command -h, --help Print help -V, --version Print version ```

Output Example

csv Delta,Time,CPU_FREQUENCY_0,CPU_FREQUENCY_1,CPU_FREQUENCY_2,CPU_FREQUENCY_3,CPU_FREQUENCY_4,CPU_FREQUENCY_5,CPU_FREQUENCY_6,CPU_FREQUENCY_7,CPU_FREQUENCY_8,CPU_FREQUENCY_9,CPU_TEMP_0,CPU_TEMP_1,CPU_TEMP_2,CPU_TEMP_3,CPU_TEMP_4,CPU_TEMP_5,CPU_TEMP_6,CPU_TEMP_7,CPU_TEMP_8,CPU_TEMP_9,CPU_USAGE_0,CPU_USAGE_1,CPU_USAGE_2,CPU_USAGE_3,CPU_USAGE_4,CPU_USAGE_5,CPU_USAGE_6,CPU_USAGE_7,CPU_USAGE_8,CPU_USAGE_9,SYSTEM_POWER (Watts),TOTAL_MEMORY,TOTAL_SWAP,USED_MEMORY,USED_SWAP 0,1697704464320,0,0,0,0,0,0,0,0,0,0,46.529457092285156,44.31881332397461,43.83422088623047,47.03656005859375,44.67115783691406,43.856910705566406,41.333412170410156,41.268951416015625,44.348262786865234,43.08387756347656,46.37215805053711,45.429779052734375,15.021618843078613,8.819367408752441,5.0954484939575195,3.514699935913086,2.9715969562530518,1.5818228721618652,1.1069598197937012,0.9475208520889282,11.58033275604248,34359738368,0,10188488704,0 104,1697704464321,0,0,0,0,0,0,0,0,0,0,46.529457092285156,44.31881332397461,43.83422088623047,47.03656005859375,44.67115783691406,43.856910705566406,41.333412170410156,41.268951416015625,44.348262786865234,43.08387756347656,46.37215042114258,45.429771423339844,15.021615982055664,8.819366455078125,5.095447063446045,3.514699697494507,2.9715967178344727,1.5818227529525757,1.1069598197937012,0.9475207924842834,11.58033275604248,34359738368,0,10189275136,0

Units of output metrics

| Time | Energy | Memory | Frequency | Voltage | |:----:|:------:|:------:|:---------:|:-------:| | ms | J | Bytes | MHz | V |