Troubleshooting Queues

Troubleshooting the status of a LocalQueue or ClusterQueue

Why no workloads are admitted in the LocalQueue?

The status of the LocalQueue includes details of any configuration problems on the LocalQueue, as part of the Active condition.

Run the following command to see the status of the LocalQueue:

kubectl get localqueue -n my-namespace my-local-queue -o yaml

The status of the LocalQueue will be similar to the following:

status:
  admittedWorkloads: 0
  conditions:
  - lastTransitionTime: "2024-05-03T18:57:32Z"
    message: Can't submit new workloads to clusterQueue
    reason: ClusterQueueIsInactive
    status: "False"
    type: Active

In the example above, the Active condition has status False because the ClusterQueue is not active.

Why no workloads are admitted in the ClusterQueue?

The status of the ClusterQueue includes details of any configuration problems on the ClusterQueue, as part of the Active condition.

Run the following command to see the status of the ClusterQueue:

kubectl get clusterqueue my-clusterqueue -o yaml

The status of the ClusterQueue will be similar to the following:

status:
  admittedWorkloads: 0
  conditions:
  - lastTransitionTime: "2024-05-03T18:22:30Z"
    message: 'Can''t admit new workloads: FlavorNotFound'
    reason: FlavorNotFound
    status: "False"
    type: Active

In the example above, the Active condition has status False because the configured flavor does not exist. Read Administer ClusterQueues to learn how to configure a ClusterQueue.

If the ClusterQueue is properly configured, the status will be similar to the following:

status:
  admittedWorkloads: 1
  conditions:
  - lastTransitionTime: "2024-05-03T18:35:28Z"
    message: Can admit new workloads
    reason: Ready
    status: "True"
    type: Active

If the ClusterQueue has the Active condition with status True, and you still don’t observe workloads being admitted, then the problem is more likely to be in the individual workloads. Read Troubleshooting jobs to learn why individual jobs cannot be admitted.