Energy Consumption Measurement

This IT4I-specific guide summarizes the available options for viewing energy consumption and CO2e emissions and explains when to use each of them.

Overview: which option to use

Notes:

• Energy/CO2e values are available only for finished jobs.
• Access differs by tool (e.g., SCS visibility depends on permissions).

Command-line utility (get_energy)

The get_energy utility is available on cluster login nodes.

Use this tool to query energy consumption for your finished jobs, or for finished jobs in projects where you share membership with another user. Running jobs are not supported.

The default output (-f/--format sum) also lets you aggregate totals across all matching jobs. With -a/--account, this can be used to get project/account-level consumption for a given time window.

Important behavior

1. -c/--cluster-name is required and must match a valid cluster name for your deployment (at IT4I: karolina, barbora).
2. You must provide at least one filter, otherwise the tool prints help and exits.

Basic usage

get_energy -c <cluster_name> --all

Filters and access rules

• --all returns all your jobs in the specified time window.
• -j/--job-id filters by a specific scheduler job ID.
• -u/--username is allowed only if you and the requested user share at least one account.
• -a/--account is allowed only if you are a member of that account.
• -s1/--submit-time-start, -s2/--submit-time-end, -s3/--submit-time-exact filter by submit time.
  • Times can be UNIX timestamps (seconds) or UTC datetimes like YYYY-MM-DD HH:MM:SS (quote values that contain spaces).

If you do not pass -a/--account, the tool automatically queries all your accounts/projects by default.

Output options

• -f/--format selects sum (default) or list.
  • sum aggregates totals across all matching jobs.
  • list returns per-job rows and includes job-level errors.
• -o/--output selects table (default), json, or csv.
  • csv writes a file. Use --output-path to control the path or directory.
• -x/--calculate-if-missing retries missing energy calculations (may take longer).

Examples

# All your jobs on a cluster in the last ~182 days (default window)
get_energy -c <cluster_name> --all

# Single job, sum output in JSON
get_energy -c <cluster_name> -j 123456 -o json

# Jobs in a specific account (must be your account)
get_energy -c <cluster_name> -a my_project --all

# Jobs submitted in a specific range (timestamps or human-readable UTC datetimes)
get_energy -c <cluster_name> --all -s1 "2025-01-01 00:00:00" -s2 "2025-02-01 00:00:00"

# CSV export to a specific file
get_energy -c <cluster_name> --all -o csv --output-path energy_cluster.csv

SCS energy and CO2e emissions per project

Use SCS to view aggregated energy consumption and CO2e emissions at the project/account level. Visible only for PI of project (depending on SCS permissions).

RS Web/Grafana energy and CO2e emissions per job

Use RS Web (and optionally linked Grafana dashboards) to view per-job energy consumption and CO2e emissions.

Step-by-step (RS Web)

1. Open: https://extranet.it4i.cz/rsweb/karolina
2. Click the My Jobs tab
3. Open the detail of a finished job
4. In the Job overview section you will find:
   • Emission = job emissions
   • Entity = job energy
   • Grafana graph(s)