OS Manuals

/usr/bin/kepler

Prometheus exporter that measures energy consumption

From kepler-fips 0.13.0-r0 (enterprise-packages), captured 2026-11-08 by running kepler --help (exit 0). permalink

usage: kepler [<flags>]

Power consumption monitoring exporter for Prometheus.


Flags:
  --[no-]help                    Show context-sensitive help (also try --help-long and --help-man).
  --config.file=CONFIG.FILE      Path to YAML configuration file
  --log.level=info               Logging level: debug, info, warn, error
  --log.format=text              Logging format: text or json
  --host.sysfs=/sys              Host sysfs path
  --host.procfs=/proc            Host procfs path
  --monitor.interval=5s          Interval for monitoring resources (processes, container, vm,
                                 etc...); 0 to disable
  --monitor.max-terminated=500   Maximum number of terminated workloads to track; 0 to disable,
                                 -1 for unlimited
  --[no-]debug.pprof             Enable pprof debug endpoints
  --web.config-file=""           Web config file path
  --web.listen-address=:28282 ...
                                 Web server listen addresses
  --[no-]exporter.stdout         Enable stdout exporter
  --[no-]exporter.prometheus     Enable Prometheus exporter
  --metrics=METRICS ...          Metrics levels to export (node,process,container,vm,pod)
  --[no-]kube.enable             Monitor kubernetes
  --kube.config=KUBE.CONFIG      Path to a kubeconfig. Only required if out-of-cluster.
  --kube.node-name=KUBE.NODE-NAME
                                 Name of kubernetes node on which kepler is running.
  --kube.pod-name=KUBE.POD-NAME  Name of the pod kepler is running in. Needed with the pod namespace
                                 to attribute kepler's own processes when it runs in a private
                                 cgroup namespace.
  --kube.pod-namespace=KUBE.POD-NAMESPACE
                                 Namespace of the pod kepler is running in.
  --kube.container-name=KUBE.CONTAINER-NAME
                                 Name of kepler's container in its pod.
  --[no-]experimental.platform.redfish.enabled
                                 Enable experimental Redfish BMC power monitoring
  --experimental.platform.redfish.node-name=EXPERIMENTAL.PLATFORM.REDFISH.NODE-NAME
                                 Node name for experimental Redfish platform power monitoring
  --experimental.platform.redfish.config-file=EXPERIMENTAL.PLATFORM.REDFISH.CONFIG-FILE
                                 Path to experimental Redfish BMC configuration file
  --[no-]experimental.hwmon.force-enabled
                                 Force hwmon as the power meter, skipping RAPL auto-detection
  --experimental.hwmon.zones=EXPERIMENTAL.HWMON.ZONES ...
                                 Hwmon zone filter (power labels to monitor)
  --[no-]experimental.gpu.enabled
                                 Enable experimental GPU power monitoring
  --experimental.gpu.idle-power=0
                                 GPU idle power in Watts (0 = auto-detect from idle observations)
  --experimental.gpu.dcgm-endpoint=""
                                 dcgm-exporter metrics endpoint URL for MIG power attribution
                                 (auto-discovered if empty)
  --experimental.gpu.metrics-cache-ttl=2s
                                 dcgm-exporter metrics cache TTL for MIG power attribution (0s to
                                 disable cache)
Options (21)
OptionDescriptionSource
--config.file CONFIG.FILEPath to YAML configuration filehelp
--log.level infoLogging level: debug, info, warn, errorhelp
--log.format textLogging format: text or jsonhelp
--host.sysfs /sysHost sysfs pathhelp
--host.procfs /procHost procfs pathhelp
--monitor.interval 5sInterval for monitoring resources (processes, container, vm, etc...);help
--monitor.max-terminated 500Maximum number of terminated workloads to track;help
--web.config-file ""Web config file pathhelp
--web.listen-address :28282Web server listen addresseshelp
--metrics METRICSMetrics levels to export (node,process,container,vm,pod)help
--kube.config KUBE.CONFIGPath to a kubeconfig.help
--kube.node-name KUBE.NODE-NAMEName of kubernetes node on which kepler is running.help
--kube.pod-name KUBE.POD-NAMEName of the pod kepler is running in.help
--kube.pod-namespace KUBE.POD-NAMESPACENamespace of the pod kepler is running in.help
--kube.container-name KUBE.CONTAINER-NAMEName of kepler's container in its pod.help
--experimental.platform.redfish.node-name EXPERIMENTAL.PLATFORM.REDFISH.NODE-NAMENode name for experimental Redfish platform power monitoringhelp
--experimental.platform.redfish.config-filePath to experimental Redfish BMC configuration filehelp
--experimental.hwmon.zones EXPERIMENTAL.HWMON.ZONESHwmon zone filter (power labels to monitor)help
--experimental.gpu.idle-power 0GPU idle power in Watts (0 = auto-detect from idle observations)help
--experimental.gpu.dcgm-endpoint ""dcgm-exporter metrics endpoint URL for MIG power attribution (auto-discovered if empty)help
--experimental.gpu.metrics-cache-ttl 2sdcgm-exporter metrics cache TTL for MIG power attribution (0s to disable cache)help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.