Retirement: Pod name dimension in AKS pod platform metrics

Beginning September 30, 2027, support for the pod name dimension on the following Azure Monitor platform metrics is retiring, and these metrics are transitioning to aggregate pod counters:

• Number of pods by phase (kube_pod_status_phase)
• Number of pods in Ready state (kube_pod_status_ready)

After this change:

• Metric names remain unchanged.
• Aggregate pod counts remain available.
• Namespace-level monitoring scenarios remain supported.
• The pod name dimension will no longer be available for filtering, grouping, or alerting.

During the deprecation period, AKS will maintain both the existing and the new aggregate implementations. Both are populated with data, existing monitoring experiences will continue to function, and you will have at least one year of historical data in the aggregate implementation before retirement.
You may be affected if any dashboard, workbook, alert, automation, or monitoring workflow:

• Uses kube_pod_status_phase or kube_pod_status_ready and filters on the pod name dimension.
• Splits or groups results by the pod name dimension.

Recommended action:

• If you use aggregate pod counts, no action is required.
• If you use the pod name dimension, update dashboards, alerts, workbooks, and automation before September 30, 2027. For pod-level monitoring and troubleshooting, we recommend using Azure Monitor Managed Prometheus and Kubernetes-native pod metrics.

Help and support
If you have questions, get answers from community experts in Microsoft Q&A.