Skip to content

Commit ef012d2

Browse files
authored
Update troubleshoot-performance-ingress.md
1 parent ff8ac77 commit ef012d2

1 file changed

Lines changed: 11 additions & 9 deletions

File tree

support/azure/azure-kubernetes/load-bal-ingress-c/troubleshoot-performance-ingress.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -5,17 +5,19 @@ ms.reviewer: claudiogodoy
55
ms.service: azure-kubernetes-service
66
ms.date: 05/24/2025
77
---
8-
# Managed NGINX ingress controller guidance
8+
# Troubleshoot issues in Managed NGINX ingress controller
99

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.
1111

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.
1313

1414
## Prerequisites
1515

1616
Before you start, make sure that you have the following tool installed:
1717

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.
1921

2022
## Symptoms
2123

@@ -57,14 +59,14 @@ To troubleshoot the issue, follow these steps.
5759
nginx Deployment/nginx cpu: 133%/70% 1 2 2 80m
5860
```
5961

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:
6163

62-
- `HPA` has reached the maximum number of pods.
64+
- The `HPA` reached the maximum number of pods.
6365
- No nodes are available to use to schedule the pods.
6466

6567
### Step 2: Look for pods in a pending state
6668

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:
6870

6971
```console
7072
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
7577

7678
### Step 3: Check whether limits are applied to the NGINX deployment
7779

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:
7981

8082
1. Describe the NGINX deployment:
8183

@@ -145,7 +147,7 @@ The following configuration options directly affect the `HPA` behavior.
145147
kubectl get hpa -n app-routing-system
146148
```
147149

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.
149151

150152
## References
151153

0 commit comments

Comments
 (0)