Copyright 2022 The Volcano Authors.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package usage
import (
"time"
"volcano.sh/volcano/pkg/scheduler/metrics/source"
"k8s.io/klog/v2"
k8sFramework "k8s.io/kubernetes/pkg/scheduler/framework"
"volcano.sh/volcano/pkg/scheduler/api"
"volcano.sh/volcano/pkg/scheduler/framework"
)
const (
PluginName = "usage"
thresholdSection = "thresholds"
MetricsActiveTime = 5 * time.Minute
NodeUsageCPUExtend = "the CPU load of the node exceeds the upper limit."
NodeUsageMemoryExtend = "the memory load of the node exceeds the upper limit."
)
actions: "enqueue, allocate, backfill"
tiers:
- plugins:
- name: usage
enablePredicate: false # If the value is false, new pod scheduling is not disabled when the node load reaches the threshold. If the value is true or left blank, new pod scheduling is disabled.
arguments:
usage.weight: 5
cpu.weight: 1
memory.weight: 1
thresholds:
cpu: 80
mem: 80
*/
const AVG string = "average"
type usagePlugin struct {
pluginArguments framework.Arguments
usageWeight int
cpuWeight int
memoryWeight int
usageType string
cpuThresholds float64
memThresholds float64
period string
}
func New(args framework.Arguments) framework.Plugin {
var plugin = &usagePlugin{
pluginArguments: args,
usageWeight: 5,
cpuWeight: 1,
memoryWeight: 1,
usageType: AVG,
cpuThresholds: 80,
memThresholds: 80,
period: source.NODE_METRICS_PERIOD,
}
args.GetInt(&plugin.usageWeight, "usage.weight")
args.GetInt(&plugin.cpuWeight, "cpu.weight")
args.GetInt(&plugin.memoryWeight, "memory.weight")
argsValue, ok := plugin.pluginArguments[thresholdSection]
if !ok {
klog.Errorf("Failed to obtain thresholds information, usage plugin arguments is %v", plugin.pluginArguments)
return plugin
}
thresholdArgs, ok := argsValue.(map[interface{}]interface{})
if !ok {
klog.Errorf("Failed to convert the thresholds information, thresholds args values is %v", argsValue)
return plugin
}
for resourceName, threshold := range thresholdArgs {
resource, _ := resourceName.(string)
value, _ := threshold.(int)
switch resource {
case "cpu":
plugin.cpuThresholds = float64(value)
case "mem":
plugin.memThresholds = float64(value)
}
}
return plugin
}
func (up *usagePlugin) Name() string {
return PluginName
}
func (up *usagePlugin) OnSessionOpen(ssn *framework.Session) {
klog.V(5).Infof("Enter usage plugin ...")
defer func() {
klog.V(5).Infof("Leaving usage plugin ...")
}()
if klog.V(4).Enabled() {
for node, nodeInfo := range ssn.Nodes {
klog.V(4).Infof("node:%v, cpu usage:%v, mem usage:%v, metrics time is %v",
node, nodeInfo.ResourceUsage.CPUUsageAvg, nodeInfo.ResourceUsage.MEMUsageAvg, nodeInfo.ResourceUsage.MetricsTime)
}
}
predicateFn := func(task *api.TaskInfo, node *api.NodeInfo) error {
predicateStatus := make([]*api.Status, 0)
usageStatus := &api.Status{Plugin: PluginName}
now := time.Now()
if up.period == "" || now.Sub(node.ResourceUsage.MetricsTime) > MetricsActiveTime {
klog.V(4).Infof("The period(%s) is empty or the usage metrics data is not updated for more than %v minutes, "+
"Usage plugin filter for task %s/%s on node %s pass, metrics time is %v. ", up.period, MetricsActiveTime, task.Namespace, task.Name, node.Name, node.ResourceUsage.MetricsTime)
return nil
}
klog.V(4).Infof("predicateFn cpuUsageAvg:%v,predicateFn memUsageAvg:%v", up.cpuThresholds, up.memThresholds)
if node.ResourceUsage.CPUUsageAvg[up.period] > up.cpuThresholds {
klog.V(3).Infof("Node %s cpu usage %f exceeds the threshold %f", node.Name, node.ResourceUsage.CPUUsageAvg[up.period], up.cpuThresholds)
usageStatus.Code = api.UnschedulableAndUnresolvable
usageStatus.Reason = NodeUsageCPUExtend
predicateStatus = append(predicateStatus, usageStatus)
return api.NewFitErrWithStatus(task, node, predicateStatus...)
}
if node.ResourceUsage.MEMUsageAvg[up.period] > up.memThresholds {
klog.V(3).Infof("Node %s mem usage %f exceeds the threshold %f", node.Name, node.ResourceUsage.MEMUsageAvg[up.period], up.memThresholds)
usageStatus.Code = api.UnschedulableAndUnresolvable
usageStatus.Reason = NodeUsageMemoryExtend
predicateStatus = append(predicateStatus, usageStatus)
return api.NewFitErrWithStatus(task, node, predicateStatus...)
}
klog.V(4).Infof("Usage plugin filter for task %s/%s on node %s pass.", task.Namespace, task.Name, node.Name)
return nil
}
nodeOrderFn := func(task *api.TaskInfo, node *api.NodeInfo) (float64, error) {
score := 0.0
now := time.Now()
if up.period == "" || now.Sub(node.ResourceUsage.MetricsTime) > MetricsActiveTime {
klog.V(4).Infof("The period(%s) is empty or the usage metrics data is not updated for more than %v minutes, "+
"Usage plugin score for task %s/%s on node %s is 0, metrics time is %v. ", up.period, MetricsActiveTime, task.Namespace, task.Name, node.Name, node.ResourceUsage.MetricsTime)
return 0, nil
}
cpuUsage, exist := node.ResourceUsage.CPUUsageAvg[up.period]
klog.V(4).Infof("Node %s cpu usage is %f.", node.Name, cpuUsage)
if !exist {
return 0, nil
}
cpuScore := (100 - cpuUsage) / 100 * float64(up.cpuWeight)
memoryUsage, exist := node.ResourceUsage.MEMUsageAvg[up.period]
klog.V(4).Infof("Node %s memory usage is %f.", node.Name, memoryUsage)
if !exist {
return 0, nil
}
memoryScore := (100 - memoryUsage) / 100 * float64(up.memoryWeight)
score = (cpuScore + memoryScore) / float64(up.cpuWeight+up.memoryWeight)
score *= float64(k8sFramework.MaxNodeScore * int64(up.usageWeight))
klog.V(4).Infof("Node %s score for task %s is %f.", node.Name, task.Name, score)
return score, nil
}
ssn.AddPredicateFn(up.Name(), predicateFn)
ssn.AddNodeOrderFn(up.Name(), nodeOrderFn)
}
func (up *usagePlugin) OnSessionClose(ssn *framework.Session) {}