You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: support/azure/azure-kubernetes/load-bal-ingress-c/troubleshoot-performance-ingress.md
+11-9Lines changed: 11 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,17 +5,19 @@ ms.reviewer: claudiogodoy
5
5
ms.service: azure-kubernetes-service
6
6
ms.date: 05/24/2025
7
7
---
8
-
# Managed NGINX ingress controller guidance
8
+
# Troubleshoot issues in Managed NGINX ingress controller
9
9
10
-
The [Managed NGINX ingress controller](/azure/aks/app-routing) is a routing add-on that enables routing HTTP and HTTPS traffic to applications that run on an [Azure Kubernetes Service (AKS)](/azure/aks/) cluster.
10
+
The [Managed NGINX ingress controller](/azure/aks/app-routing) is a routing add-on that enables the routing of HTTP and HTTPS traffic to applications that run on an [Azure Kubernetes Service (AKS)](/azure/aks/) cluster.
11
11
12
-
The routing system might be the root cause of performance-related problems. This article provides step-by-step guidance to troubleshoot NGINX ingress controller performance issues. This aricle also discusses common symptoms, root cause analysis, and configuration adjustments.
12
+
The routing system might be the root cause of performance-related problems. This article provides step-by-step guidance to troubleshoot NGINX ingress controller performance issues. This article also discusses common symptoms, root cause analysis, and configuration adjustments.
13
13
14
14
## Prerequisites
15
15
16
16
Before you start, make sure that you have the following tool installed:
17
17
18
-
-**Kubernetes CLI (`kubectl`)**: Use Azure CLI, and run the `az aks install-cli` command.
18
+
- Kubernetes CLI (`kubectl`)
19
+
20
+
Use Azure CLI, and run the `az aks install-cli` command.
19
21
20
22
## Symptoms
21
23
@@ -57,14 +59,14 @@ To troubleshoot the issue, follow these steps.
57
59
nginx Deployment/nginx cpu: 133%/70% 1 2 2 80m
58
60
```
59
61
60
-
The **TARGETS** column shows the CPU threshold at which the `HPA` is triggered to scale up the pods. There are a few possibilities for this behavior:
62
+
The **TARGETS** column shows the CPU threshold at which the `HPA` is triggered to scale up the pods. There are several possibile causes of this behavior:
61
63
62
-
- `HPA` has reached the maximum number of pods.
64
+
- The `HPA` reached the maximum number of pods.
63
65
- No nodes are available to use to schedule the pods.
64
66
65
67
### Step 2: Look for pods in a pending state
66
68
67
-
If your evaluation reveals that `NGINX HPA` hasn't reached the maximum number of pods, the [kube-scheduler](https://kubernetes.io/docs/concepts/scheduling-eviction/kube-scheduler/#kube-scheduler) might not be able to find available nodes to use to schedule the `NGINX pods`. To find pending pods, run the following command:
69
+
If your evaluation reveals that `NGINX HPA` didn't reach the maximum number of pods, the [kube-scheduler](https://kubernetes.io/docs/concepts/scheduling-eviction/kube-scheduler/#kube-scheduler) might not be able to find available nodes to use to schedule the `NGINX pods`. To find pending pods, run the following command:
68
70
69
71
```console
70
72
kubectl get pod --field-selector=status.phase=Pending -n app-routing-system
@@ -75,7 +77,7 @@ If your evaluation reveals that `NGINX HPA` hasn't reached the maximum number of
75
77
76
78
### Step 3: Check whether limits are applied to the NGINX deployment
77
79
78
-
Any misconfiguration on the `NGINX` [resource limits or requests](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/) can cause the `HPA` to scale up more pods than what's necessary. To check the limits, follow these steps:
80
+
Any misconfiguration on the `NGINX` [resource limits or requests](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/) can cause the `HPA` to scale up more pods than it needs. To check the limits, follow these steps:
79
81
80
82
1. Describe the NGINX deployment:
81
83
@@ -145,7 +147,7 @@ The following configuration options directly affect the `HPA` behavior.
145
147
kubectl get hpa -n app-routing-system
146
148
```
147
149
148
-
The HPA automatically updates based on your new configuration. The NGINX ingress controller scales according to the specified parameters.
150
+
The HPA automatically updates, based on your new configuration. The NGINX ingress controller scales according to the specified parameters.
0 commit comments