Node Pool fields
The Node Pool fields show the desired state and status of the Nodes in a Node Pool. To see these fields, runkubectl get nodepool.
Example output
The following is an example output from runningkubectl get nodepool.
Example output
- The
VALIDATED,CAPACITY, andQUOTAcolumns summarize the Node Pool’s conditions. - In a healthy, fully delivered Node Pool,
CURRENTequalsTARGET, and bothINPROGRESSandQUEUEDare0. PREFILLcounts the Nodes marked for prefill and being replaced. It is0unless prefill is enabled and one or more Nodes are being replaced. To see the prefill state of an individual Node, check itsPrefillcondition. See Prefill condition reasons.- While a Node Pool is scaling up, the difference between
CURRENTandTARGETis split betweenINPROGRESS(Nodes that are booting) andQUEUED(Nodes that are waiting for capacity). Note that a new Node can take up to 20 minutes to boot before it counts towardCURRENT.
Rack-based Node Pool fields
For rack-based instance types such as GB200 and GB300, the Node Pool also tracks rack counts, where each rack contains 18 Nodes. These fields are populated only for rack-based instance types and appear only in the wide output. To see them, usekubectl get nodepool -o wide:
Node Pool full status
For the full status of a single Node Pool, including its conditions and recent events, usedescribe:
Example command
[NODE-POOL-NAME] with the name of your Node Pool.
Each condition answers one question about the Node Pool. The conditions most useful for diagnosing missing Nodes are the following.
A healthy Node Pool shows
Validated: Valid, Capacity: Sufficient, Quota: Under, and AtTarget: TargetMet.
For the complete list of conditions and every possible status value, see Node Pool conditions.
Common capacity and quota states
The bottom ofkubectl describe nodepool [NODE-POOL-NAME] lists recent events. The following events and condition states explain most cases where a Node Pool does not reach its target.
Quota events and conditions: