Kueue
Buoy detects Kueue by its group, kueue.x-k8s.io. Four kinds get dedicated detail tabs: Workload, ClusterQueue, LocalQueue, and ResourceFlavor. No mutation actions are exposed today; the tabs are read-only surfaces tuned for diagnosing admission decisions and queue health.
Workload
The Workload tab summarizes the queue admission state for a single job.
| Section | Contents |
|---|---|
| Spec | Queue name, priority class, pod sets (name, replica count, requests). |
| Conditions | The Kueue condition set: QuotaReserved, Admitted, PodsReady, Finished, Evicted, Requeued. |
| Admission | The cluster queue the workload was admitted into, plus per-podSet assignments of flavor and topology. |
| Admission Checks | Per-check state (Pending, Ready, Retry, Rejected) and the message Kueue surfaced. |
| Requeue State | Requeue count and the next requeue timestamp. |
| Reclaimable Pods | Pods that Kueue is willing to reclaim if quota becomes tight. |
The conditions section is the primary place to look when a workload is stuck. If Admitted is false, the corresponding condition’s message explains why.
ClusterQueue
| Section | Contents |
|---|---|
| Preemption | Preemption policies and class weights. |
| Fair Sharing | The weighted share (Kueue 0.7+). |
| Flavors | Referenced ResourceFlavors and the resource pools that route to them. |
| Status | Pending and admitted workload counts, plus the standard conditions table. |
LocalQueue
Shows the parent ClusterQueue, the configured priority class, pending and admitted workload counts, and the conditions table.
ResourceFlavor
Shows the node labels and taints that pods admitted under this flavor need to tolerate, the Karpenter NodeClass reference when set, and any topology-aware scheduling domains.
Cross-Link from Scheduling
A pod gated by kueue.x-k8s.io/admission shows a banner on its Scheduling tab. Buoy looks up the controlling Workload via the kueue.x-k8s.io/job-uid label and reports the queue, admission status, and a link to the Workload detail view. See scheduling.md.