Skip to content

Commit 6723c87

Browse files
authored
Update troubleshoot-node-auto-provision.md
1 parent 41a3cf2 commit 6723c87

1 file changed

Lines changed: 9 additions & 8 deletions

File tree

support/azure/azure-kubernetes/extensions/troubleshoot-node-auto-provision.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,13 @@ title: Troubleshoot the Node Auto-provisioning managed add-on
33
description: Learn how to troubleshoot Node Auto-provisisioning in Azure Kubernetes Service (AKS).
44
ms.service: azure-kubernetes-service
55
ms.date: 09/05/2025
6-
editor: wdarko1
6+
editor: bsoghigian
77
ms.reviewer:
88
#Customer intent: As an Azure Kubernetes Service user, I want to troubleshoot problems that involve Node Auto-provisioining managed add-on so that I can successfully provision, scale, and manage my nodes and workloads on Azure Kubernetes Service (AKS).
99
ms.custom: sap:Extensions, Policies and Add-Ons
1010
---
1111

12-
# Troubleshoot the node auto provisioning (NAP) in Azure Kubernetes Service (AKS)
12+
# Troubleshoot node auto provisioning (NAP) in Azure Kubernetes Service (AKS)
1313

1414
This article discusses how to troubleshoot Node auto provisioning(NAP), a managed add-on based on the open source [Karpenter](https://karpenter.sh) project. NAP automatically provisions and manages nodes in response to pending pod pressure, and manages scaling events at the virtual machine, or node level.
1515
When you enable Node Auto-provisioning, you might experience problems that are associated with the configuration of the infrastructure autoscaler. This article will help you troubleshoot errors and resolve common problems that affect NAP but aren't covered in the official Karpenter [FAQ][karpenter-faq] and [troubleshooting guide][karpenter-troubleshooting].
@@ -26,7 +26,7 @@ Ensure the following tools are installed and configured. They're used in the fol
2626

2727
### Nodes Not Being Removed
2828

29-
**Symptoms**: Underutilized nodes remain in the cluster longer than expected.
29+
**Symptoms**: Underutilized or empty nodes remain in the cluster longer than expected.
3030

3131
**Debugging Steps**:
3232

@@ -49,8 +49,8 @@ kubectl get events | grep -i "disruption\|consolidation"
4949
**Common Causes**:
5050
- Pods without proper tolerations
5151
- DaemonSets preventing drain
52-
- Pod disruption budgets(PDBs) not properly set
53-
- Nodes marked with `do-not-disrupt` annotation
52+
- Pod disruption budgets(PDBs) are not properly set
53+
- Nodes are marked with `do-not-disrupt` annotation
5454

5555
**Solutions**:
5656
- Add proper tolerations to pods
@@ -81,7 +81,7 @@ kubectl get pods -n kube-system | grep -E "azure-cni|kube-proxy"
8181
3. **If using azure cni with overlay or cilium**
8282
Validate your nodes have these labels
8383

84-
```
84+
```azurecli-interactive
8585
kubernetes.azure.com/azure-cni-overlay: "true"
8686
kubernetes.azure.com/network-name: aks-vnet-<redacted>
8787
kubernetes.azure.com/network-resourcegroup: <redacted>
@@ -145,7 +145,8 @@ kubectl logs -n kube-system -l k8s-app=azure-cns --tail=100
145145

146146
### DNS Service IP Issues
147147

148-
**Note**: The `--dns-service-ip` parameter is only supported for NAP (Node Auto Provisioning) clusters and is not available for self-hosted Karpenter installations.
148+
>[!NOTE]
149+
>The `--dns-service-ip` parameter is only supported for NAP (Node Auto Provisioning) clusters and is not available for self-hosted Karpenter installations.
149150
150151
**Symptoms**: Pods can't resolve DNS names or kubelet fails to register with API server due to DNS resolution failures.
151152

@@ -259,5 +260,5 @@ az vm list-usage --location <region> --query "[?currentValue >= limit]"
259260

260261

261262
[aks-firewall-requirements]: /azure/aks/limit-egress-traffic#azure-global-required-network-rules
262-
[karpenter-troubleshooting]: h[ttps://keda.sh/docs/latest/troubleshooting/](https://karpenter.sh/docs/troubleshooting/)
263+
[karpenter-troubleshooting]: https://karpenter.sh/docs/troubleshooting/
263264
[karpenter-faq]: https://karpenter.sh/docs/faq/

0 commit comments

Comments
 (0)