Troubleshoot common issues in AKS enabled by Azure Arc

This section describes how to find solutions for issues you encounter when using AKS enabled by Azure Arc.

Open a support request

To open a support request, see the Get support article for information about how to use the Azure portal to get support or open a support request for AKS Arc.

Known issues

The following sections describe known issues for AKS enabled by Azure Arc:

AKS Arc CRUD operation	Issue	Fix status
AKS cluster create	Can't create AKS cluster or scale node pool because of issues with AKS Arc images	Partially fixed in 2503 release
AKS steady state	AKS Arc telemetry pod consumes too much memory and CPU	Active
AKS steady state	Disk space exhaustion on control plane VMs due to accumulation of kube-apiserver audit logs	Active
AKS cluster delete	Deleted AKS Arc cluster still visible on Azure portal	Active
AKS cluster upgrade	AKS Arc cluster stuck in "Upgrading" state	Fixed in 2505 release
AKS cluster delete	Can't fully delete AKS Arc cluster with PodDisruptionBudget (PDB) resources	Fixed in 2503 release
Azure portal	Can't see VM SKUs on Azure portal	Fixed in 2411 release
MetalLB Arc extension	Connectivity issues with MetalLB	Fixed in 2411 release

Guides to diagnose and troubleshoot Kubernetes CRUD failures

AKS Arc operation	Issue
General network validation errors	Troubleshoot network validation errors
Create validation	Control plane configuration validation errors
Create validation	K8sVersionValidation error
Create validation	KubeAPIServer unreachable error
Network configuration issues	Use diagnostic checker
Kubernetes steady state	Resolve issues due to out-of-band deletion of storage volumes
Kubernetes steady state	Repeated Entra authentication prompts when running kubectl with Kubernetes RBAC
Release validation	Azure Advisor upgrade recommendation message
Network validation	Network validation error due to .local domain
Network validation	Troubleshoot BGP with FRR in AKS Arc environments

Next steps

What is AKS enabled by Azure Arc?