k8s.io/kubernetes@v1.29.3/pkg/scheduler/internal/cache/debugger/dumper.go (about)

     1  /*
     2  Copyright 2018 The Kubernetes Authors.
     3  
     4  Licensed under the Apache License, Version 2.0 (the "License");
     5  you may not use this file except in compliance with the License.
     6  You may obtain a copy of the License at
     7  
     8      http://www.apache.org/licenses/LICENSE-2.0
     9  
    10  Unless required by applicable law or agreed to in writing, software
    11  distributed under the License is distributed on an "AS IS" BASIS,
    12  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    13  See the License for the specific language governing permissions and
    14  limitations under the License.
    15  */
    16  
    17  package debugger
    18  
    19  import (
    20  	"fmt"
    21  	"strings"
    22  
    23  	"k8s.io/klog/v2"
    24  
    25  	"k8s.io/api/core/v1"
    26  	"k8s.io/kubernetes/pkg/scheduler/framework"
    27  	internalcache "k8s.io/kubernetes/pkg/scheduler/internal/cache"
    28  	"k8s.io/kubernetes/pkg/scheduler/internal/queue"
    29  )
    30  
    31  // CacheDumper writes some information from the scheduler cache and the scheduling queue to the
    32  // scheduler logs for debugging purposes.
    33  type CacheDumper struct {
    34  	cache    internalcache.Cache
    35  	podQueue queue.SchedulingQueue
    36  }
    37  
    38  // DumpAll writes cached nodes and scheduling queue information to the scheduler logs.
    39  func (d *CacheDumper) DumpAll(logger klog.Logger) {
    40  	d.dumpNodes(logger)
    41  	d.dumpSchedulingQueue(logger)
    42  }
    43  
    44  // dumpNodes writes NodeInfo to the scheduler logs.
    45  func (d *CacheDumper) dumpNodes(logger klog.Logger) {
    46  	dump := d.cache.Dump()
    47  	nodeInfos := make([]string, 0, len(dump.Nodes))
    48  	for name, nodeInfo := range dump.Nodes {
    49  		nodeInfos = append(nodeInfos, d.printNodeInfo(name, nodeInfo))
    50  	}
    51  	// Extra blank line added between node entries for readability.
    52  	logger.Info("Dump of cached NodeInfo", "nodes", strings.Join(nodeInfos, "\n\n"))
    53  }
    54  
    55  // dumpSchedulingQueue writes pods in the scheduling queue to the scheduler logs.
    56  func (d *CacheDumper) dumpSchedulingQueue(logger klog.Logger) {
    57  	pendingPods, s := d.podQueue.PendingPods()
    58  	var podData strings.Builder
    59  	for _, p := range pendingPods {
    60  		podData.WriteString(printPod(p))
    61  	}
    62  	logger.Info("Dump of scheduling queue", "summary", s, "pods", podData.String())
    63  }
    64  
    65  // printNodeInfo writes parts of NodeInfo to a string.
    66  func (d *CacheDumper) printNodeInfo(name string, n *framework.NodeInfo) string {
    67  	var nodeData strings.Builder
    68  	nodeData.WriteString(fmt.Sprintf("Node name: %s\nDeleted: %t\nRequested Resources: %+v\nAllocatable Resources:%+v\nScheduled Pods(number: %v):\n",
    69  		name, n.Node() == nil, n.Requested, n.Allocatable, len(n.Pods)))
    70  	// Dumping Pod Info
    71  	for _, p := range n.Pods {
    72  		nodeData.WriteString(printPod(p.Pod))
    73  	}
    74  	// Dumping nominated pods info on the node
    75  	nominatedPodInfos := d.podQueue.NominatedPodsForNode(name)
    76  	if len(nominatedPodInfos) != 0 {
    77  		nodeData.WriteString(fmt.Sprintf("Nominated Pods(number: %v):\n", len(nominatedPodInfos)))
    78  		for _, pi := range nominatedPodInfos {
    79  			nodeData.WriteString(printPod(pi.Pod))
    80  		}
    81  	}
    82  	return nodeData.String()
    83  }
    84  
    85  // printPod writes parts of a Pod object to a string.
    86  func printPod(p *v1.Pod) string {
    87  	return fmt.Sprintf("name: %v, namespace: %v, uid: %v, phase: %v, nominated node: %v\n", p.Name, p.Namespace, p.UID, p.Status.Phase, p.Status.NominatedNodeName)
    88  }