Cc-Energy-Manager on ClusterCockpit

Commands

Mon, 01 Jan 0001 00:00:00 +0000

Build

make

This produces the cc-energy-manager binary in the repository root.

Run

./cc-energy-manager [options]

Options

Flag	Default	Description
`-config <path>`	`./config.json`	Path to the JSON configuration file
`-loglevel <level>`	`warn`	Logging verbosity: `debug`, `info`, `warn`, `err`, `fatal`, `crit`
`-logdate`	`false`	Prefix every log line with date and time
`-once`	`false`	Run all collectors once and then exit (useful for testing)

Example

./cc-energy-manager -config /etc/cc-energy-manager/config.json -loglevel info -logdate

Signals

cc-energy-manager handles the following UNIX signals for graceful shutdown:

Configuration

Mon, 01 Jan 0001 00:00:00 +0000

Configuration is provided as a JSON file. The default path is ./config.json in the working directory; an alternative path can be specified with the -config flag.

The configuration has four required top-level sections: receivers, sinks, controller, and clusters.

Receivers Section

A named map of receiver configurations. Each receiver defines a source from which cc-energy-manager ingests metric messages.

"receivers": {
 "<name>": {
 "type": "nats",
 "address": "nats-server.example.org",
 "port": "4222",
 "subject": "metrics.subject"
 }
}

Fields (NATS receiver):

type (string, required): Receiver type. Currently "nats".
address (string, required): Hostname or IP of the NATS server.
port (string, required): Port of the NATS server.
subject (string, required): NATS subject to subscribe to.

Sinks Section

A named map of sink configurations. Each sink defines a destination for processed metric messages.

cc-energy-manager

Mon, 01 Jan 0001 00:00:00 +0000

Reference information regarding the ClusterCockpit component “cc-energy-manager” (GitHub Repo).

Overview

cc-energy-manager is a daemon that dynamically adjusts power limits on compute nodes of an HPC cluster to automatically optimize energy consumption. It is part of the ClusterCockpit ecosystem and integrates with cc-metric-collector for metrics and cc-node-controller for applying power limit changes.

Problem and Motivation

With large HPC systems, power draw is an ever-growing concern for grid infrastructure and environmental footprint. Modern CPUs and GPUs expose integrated power management that allows lowering maximum power limits (the opposite of overclocking). When a power limit is reduced, the chip’s internal power management lowers clock speeds to stay within budget — reducing both power draw and performance.