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.
| Column | Value | Where it’s defined |
|---|---|---|
TARGET | The number of Nodes you want in the Node Pool. You set this value, or the autoscaler sets it within minNodes and maxNodes. | spec.targetNodes |
CURRENT | The number of Nodes that have been booted and registered with the Node Pool and are present in the cluster. | status.currentNodes |
INPROGRESS | The number of Nodes that have been assigned to the Node Pool but haven’t yet booted or registered with the Node Pool. | status.inProgress |
QUEUED | The number of Nodes that have been requested but not yet assigned, because they are waiting for capacity. | status.queuedNodes |
VALIDATED | The result of the most recent Node Pool configuration validation. | status.conditions |
CAPACITY | The result of the most recent capacity check for the instance type. | status.conditions |
QUOTA | The result of the most recent quota check for the instance type and zone. | status.conditions |
Example output
The following is an example output from runningkubectl get nodepool.
Example output
| Node Pool | State | What the status shows |
|---|---|---|
example-nodepool | Healthy | CURRENT matches TARGET, and capacity and quota are both satisfied. |
nodepool-2 | Waiting for capacity | Short one Node. One Node is QUEUED, and CAPACITY shows QueuedAwaitingCapacity. |
nodepool-3 | Delivering | Short one Node. One Node is INPROGRESS and still booting. |
- The
VALIDATED,CAPACITY, andQUOTAcolumns summarize the Node Pool’s conditions. - In a healthy, fully delivered Node Pool,
CURRENTequalsTARGET, and bothINPROGRESSandQUEUEDare0. - 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:
| Column | Value | Where it’s defined |
|---|---|---|
TARGET-RACKS | The number of racks requested for the Node Pool. | status.rackStatus.target |
CURRENT-RACKS | The number of racks present in the cluster for the Node Pool. | status.rackStatus.current |
QUEUED-RACKS | The number of racks queued and waiting for capacity to join the Node Pool. | status.rackStatus.queued |
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.
| Condition | Status values you act on | What it tells you |
|---|---|---|
Validated | Valid, Invalid | Whether the Node Pool configuration is accepted. Invalid blocks delivery, for example an unsupported instance type. |
Capacity | Sufficient, Partial, NoneAvailable, QueuedAwaitingCapacity | Whether enough Nodes of the requested instance type are available to fill the request. |
Quota | Under, Over, NotSet | Whether the request fits within your organization’s quota for the instance type and zone. |
AtTarget | TargetMet, UnderTarget, OverTarget | Whether the Node Pool has the requested number of Nodes. |
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.
| Event or condition | What it means | What to do |
|---|---|---|
QueuedAwaitingCapacity (Capacity condition) | The Node Pool requested more Nodes than are currently free in the zone, so the request is queued. CKS fills queued requests automatically as capacity becomes available. Quota: Under means you are allowed to request more Nodes, not that they are available right now. For rack-scale instance types such as GB200 and GB300, Nodes deliver in complete rack units, so the pool can queue while it waits for a full rack even when some capacity exists in the zone. | Confirm the Quota condition is Under. If the queued count does not change for an extended period after you scale, contact support. |
CWInsufficientCapacity (event) | Not enough Nodes of the requested instance type are available in the zone to fully satisfy targetNodes. CKS keeps the Nodes it could assign, continues retrying, and assigns the rest automatically as capacity returns. The Capacity condition shows Partial or NoneAvailable. | Confirm the Quota condition is Under. If you have a reservation for this instance type and zone and capacity does not arrive, contact support. |
CWOverQuota (event) | Your targetNodes request exceeds your organization’s quota for that instance type and zone. The Node Pool is filled up to the quota limit, and the rest of the request is not queued. The Quota condition shows Over. Quota applies per organization, per instance type, per zone, so every Node Pool that uses the same instance type in the same zone counts against the same quota. | Lower targetNodes to within quota, or contact support to request more quota. When moving Nodes between Node Pools, scale down the source pool before you scale up the destination to avoid CWOverQuota. |
CWNodeDeliverFail (event) | A Node failed to be allocated to the Node Pool because of a misconfiguration or an internal issue. This is a delivery problem, not a capacity shortage, even when CWInsufficientCapacity also appears. CKS retries delivery automatically. | Repeated delivery failures can disable the Node Pool, which produces a CWNodePoolDisabled event. If delivery failures persist or the Node Pool is disabled, contact support. |