Scheduler Queue Test

The Kubernetes master node's scheduler queue manages pending pods. When a pod is created, it enters this queue if it lacks an assigned node. The scheduler evaluates the pod's requirements (e.g., resources, constraints) and the cluster's state to match the pod to the most suitable node. Once scheduled, the pod leaves the queue for deployment.

Monitoring the scheduler queue ensures efficient resource utilization, prevents bottlenecks, and identifies scheduling delays. It helps maintain cluster performance, quickly detects issues, and ensures timely deployment of pending pods.

This test monitors the scheduler queues and reveals key metrics like total number of queues added, work items present, work items processed etc. These metrics are crucial to ensuring uninterrupted operation of the scheduler and queues. By analyzing the metrics the administrators can ensure that clients are able to connect to the server and take preemptive actions.

Target of the test : A Kubernetes Master Node

Agent deploying the test : A remote agent

Outputs of the test : One set of results for each client of target Kubernetes Master node being monitored.

Configurable parameters for the test

Parameter	Description
Test Period	How often should the test be executed.
Host	The IP address of the host for which this test is to be configured.
Port	Specify the port at which the specified Host listens. By default, this is 6443.
Timeout	Specify the duration (in seconds) beyond which the test will timeout in the Timeout text box. The default value is 10 seconds.
Metric URL	Each of the Kubernetes system components expose monitoring metrics through /metrics endpoint of the HTTP server. For components that don't expose endpoint by default, refer official Kubernetes distribution documentation site. Specify the metric URL textbox.

Measurements made by the test

Measurement	Description	Measurement Unit	Interpretation
Queue added	Indicates the number of queues added during the last measurement period.	Number	Adding a queue can improve visibility and control over the scheduling process. Monitoring the queue regularly will ensure smoother operations and help identify any potential delays or resource allocation issues early.
Work items processed in queue	Indicates the work items in the Kubernetes scheduler queue are pending pods waiting to be assigned to nodes.	Number	Once assigned, the pod exits the queue and is deployed to the chosen node.
Total time taken to process a work items in queue	Indicates the total time taken to process work items in the queue.	Milliseconds	The scheduler processes work items in milliseconds to a few seconds.
Average time taken to process a work in queue	Indicates the average time taken to process a work item in the queue.	Milliseconds
Work items present in queue	Indicates the number of work items present in the queue at present.	Number
Total time taken by work items present in queue	Indicates the total time taken for processing all work items in the queue.	Milliseconds
Average time taken by a work item present in queue	Indicates the avarage time taken for processing all work items in the queue.	Milliseconds