Edit

Share via

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 steady state Storage provisioning issue impacting cluster and node pool creation Active
AKS cluster delete Deleted AKS Arc cluster still visible on Azure portal Active
AKS steady state AKS Arc telemetry pod consumes too much memory and CPU Fixed in 2507 release
AKS cluster create Can't create AKS cluster or scale node pool because of issues with AKS Arc images Fixed in 2507 release
AKS steady state Disk space exhaustion on control plane VMs due to accumulation of kube-apiserver audit logs Fixed in 2507 release
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
MetalLB Arc extension MetalLB speaker pods don't run on nodes tainted with CriticalAddonsOnly=true:NoSchedule Active

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?