Skip to content

Kepler Model Server API

Getting Powers from Estimator

module: estimator (src/estimate/estimator.py)

/tmp/estimator.socket

Parameters of PowerRequest

key value description
metrics list of string list of available input features (measured metrics)
output_type either of the following values: AbsPower (for node-level power model), DynPower (for container-level power model) the requested model type
trainer_name (optional) string filter model with trainer name.
filter (optional) string expression in the form attribute1:threshold1; attribute2:threshold2.

Getting Power Models from Model Server

module: server (src/server/model_server.py)

:8100/model
POST

Parameters of ModelRequest

key value description
metrics list of string list of available input features (measured metrics)
output_type either of the following values: AbsPower (for node-level power model), DynPower (for container-level power model) the requested model type
weight boolean return model weights in json format if true. Otherwise, return model in zip file format.
trainer_name (optional) string filter model with trainer name.
node_type (optional) string filter model with node type.
filter (optional) string expression in the form attribute1:threshold1; attribute2:threshold2.

Offline Trainer

module: offline trainer (src/train/offline_trainer.py)

:8102/train
POST

Parameters of TrainRequest

key value description
name string pipeline/model name
energy_source valid key in PowerSourceMap target energy source to train for
trainer TrainAttribute attributes for training
prome_response json prom response with workload for power model training
  • TrainAttribute

    key value description
    abs_trainers list of available trainer class names trainer classes in the pipeline to train for absolute power
    dyn_trainers list of available trainer class names trainer classes in the pipeline to train for dynamic power
    isolator valid isolator class name isolator class of the pipeline to isolate the target data to train for dynamic power
    isolator_args dict mapping between isolator-specific argument name and value

Posting Model Weights [WIP]

module: server (src/server/model_server.py)

/metrics
GET

Online Trainer [WIP]

module: online trainer (src/train/online_trainer.py) running as a sidecar to server

periodically query prometheus metric server on SAMPLING INTERVAL

Profiler [WIP]

module: profiler (src/profile/profiler.py)

Copyright Contributors to the Kepler's project.

The Linux Foundation® (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see Trademark Usage.