Azure Kubernetes Service Diagnostics (preview) overview
Troubleshooting Azure Kubernetes Service (AKS) cluster issues plays an important role in maintaining your cluster, especially if your cluster is running mission-critical workloads. AKS Diagnostics (preview) is an intelligent, self-diagnostic experience that:
- Helps you identify and resolve problems in your cluster.
- Is cloud-native.
- Requires no extra configuration or billing cost.
AKS preview features are available on a self-service, opt-in basis. Previews are provided "as is" and "as available," and they're excluded from the service-level agreements and limited warranty. AKS previews are partially covered by customer support on a best-effort basis. As such, these features aren't meant for production use. For more information, see the following support articles:
Open AKS Diagnostics
To access AKS Diagnostics:
Sign in to the Azure portal
From All services in the Azure portal, select Kubernetes Service.
Select Diagnose and solve problems in the left navigation, which opens AKS Diagnostics.
Choose a category that best describes the issue of your cluster, like Cluster Node Issues, by:
- Using the keywords in the homepage tile.
- Typing a keyword that best describes your issue in the search bar.
View a diagnostic report
After you click on a category, you can view a diagnostic report specific to your cluster. Diagnostic reports intelligently call out any issues in your cluster with status icons. You can drill down on each topic by clicking More Info to see a detailed description of:
- Recommended actions
- Links to helpful docs
- Logging data
Diagnostic reports generate based on the current state of your cluster after running various checks. They can be useful for pinpointing the problem of your cluster and understanding next steps to resolve the issue.
The following diagnostic checks are available in Cluster Insights.
Cluster Node Issues
Cluster Node Issues checks for node-related issues that cause your cluster to behave unexpectedly. Specifically:
- Node readiness issues
- Node failures
- Insufficient resources
- Node missing IP configuration
- Node CNI failures
- Node not found
- Node power off
- Node authentication failure
- Node kube-proxy stale
Create, read, update & delete (CRUD) operations
CRUD Operations checks for any CRUD operations that cause issues in your cluster. Specifically:
- In-use subnet delete operation error
- Network security group delete operation error
- In-use route table delete operation error
- Referenced resource provisioning error
- Public IP address delete operation error
- Deployment failure due to deployment quota
- Operation error due to organization policy
- Missing subscription registration
- VM extension provisioning error
- Subnet capacity
- Quota exceeded error
Identity and security management
Identity and Security Management detects authentication and authorization errors that prevent communication to your cluster. Specifically,
- Node authorization failures
- 401 errors
- 403 errors