Migrate from Container insights recommended alerts to Prometheus alerts

Author: bwren

articles/azure-monitor/containers/container-insights-metric-alerts.md

@@ -94,59 +94,16 @@ The configuration change can take a few minutes to finish before it takes effect
 
 ## Metric alert rules
 
+> [!IMPORTANT]
+> Metric alerts (preview) is retiring. Please refer to the migration guidance at [Migrate from Container insights recommended alerts to Prometheus recommended alert rules (preview)](container-insights-recommended-alerts-migrate.md) and take the recommended actions to migrate to Prometheus metric alerts (preview) before 14 March 2026.
+
 [Metric alert rules](../alerts/alerts-types.md#metric-alerts) use [custom metric data from your Kubernetes cluster](container-insights-custom-metrics.md).
 
 ### Prerequisites
 
   - You might need to enable collection of custom metrics for your cluster. See [Metrics collected by Container insights](container-insights-custom-metrics.md).
   - See the supported regions for custom metrics at [Supported regions](../essentials/metrics-custom-overview.md#supported-regions).
 
-### Enable and configure alert rules
-
-#### [Azure portal](#tab/azure-portal)
-
-#### Enable alert rules
-
-1. On the **Insights** menu for your cluster, select **Recommended alerts**.
-
-    :::image type="content" source="media/container-insights-metric-alerts/command-bar-recommended-alerts.png" lightbox="media/container-insights-metric-alerts/command-bar-recommended-alerts.png" alt-text="Screenshot that shows recommended alerts option in Container insights.":::
-
-1. Toggle the **Status** for each alert rule to enable. The alert rule is created and the rule name updates to include a link to the new alert resource.
-
-    :::image type="content" source="media/container-insights-metric-alerts/recommended-alerts-pane-enable.png" lightbox="media/container-insights-metric-alerts/recommended-alerts-pane-enable.png" alt-text="Screenshot that shows a list of recommended alerts and options for enabling each.":::
-
-1. Alert rules aren't associated with an [action group](../alerts/action-groups.md) to notify users that an alert has been triggered. Select **No action group assigned** to open the **Action Groups** page. Specify an existing action group or create an action group by selecting **Create action group**.
-
-    :::image type="content" source="media/container-insights-metric-alerts/select-action-group.png" lightbox="media/container-insights-metric-alerts/select-action-group.png" alt-text="Screenshot that shows selecting an action group.":::
-
-#### Edit alert rules
-
-To edit the threshold for a rule or configure an [action group](../alerts/action-groups.md) for your Azure Kubernetes Service (AKS) cluster.
-
-1. From Container insights for your cluster, select **Recommended alerts**.
-2. Select the **Rule Name** to open the alert rule.
-3. See [Create an alert rule](../alerts/alerts-create-new-alert-rule.md?tabs=metric) for information on the alert rule settings.
-
-#### Disable alert rules
-
-1. From Container insights for your cluster, select **Recommended alerts**.
-1. Change the status for the alert rule to **Disabled**.
-
-### [Resource Manager](#tab/resource-manager)
-
-For custom metrics, a separate ARM template is provided for each alert rule.
-
-#### Enable alert rules
-
-1. Download one or all of the available templates that describe how to create the alert from [GitHub](https://github.com/microsoft/Docker-Provider/tree/ci_dev/alerts/recommended_alerts_ARM).
-1. Create and use a [parameters file](../../azure-resource-manager/templates/parameter-files.md) as a JSON to set the values required to create the alert rule.
-1. Deploy the template by using any standard methods for installing ARM templates. For guidance, see [ARM template samples for Azure Monitor](../resource-manager-samples.md).
-
-#### Disable alert rules
-
-To disable custom alert rules, use the same ARM template to create the rule, but change the `isEnabled` value in the parameters file to `false`.
-
----
 
 ## Alert rule details
 

articles/azure-monitor/containers/container-insights-recommended-alerts-migrate.md

@@ -0,0 +1,25 @@
+---
+title: Migrate from Container insights recommended alerts to Prometheus recommended alert rules (preview) 
+description: Describes how to migrate from Container insights recommended alerts to Prometheus recommended alert rules (preview) .
+ms.topic: conceptual
+ms.date: 03/07/2023
+ms.reviewer: aul
+---
+
+# Migrate from Container insights recommended alerts to Prometheus recommended alert rules (preview) 
+Container insights recommended alerts (custom metrics) (preview) will retire on 14 March 2026. If you are using this feature to monitor your Kubernetes cluster and would like to continue proactively identifying issues related to your Kubernetes cluster, transition to Prometheus recommended alert rules (preview) before 14 March 2026.
+
+This guide walks through migrating from Container insights recommended alerts (custom metrics) (preview) to Prometheus recommended alert rules (preview) and retire Container insights recommended alerts (custom metrics) (preview) from  Kubernetes clusters. 
+
+## Configure Prometheus recommended alert rules (preview) 
+
+Follow the steps at [Enable alert rules](container-insights-metric-alerts.md#enable-alert-rules) provides step-by-step instructions to configure Prometheus recommended alert rules (preview). 
+
+## Remove Container insights recommended alerts (custom metrics) (preview) from clusters
+Once you have configured Prometheus metric alerts, offboard from Container insights recommended alerts (custom metrics) (preview) to avoid duplicate alerts. Follow the steps at [Disable alert rules](container-insights-metric-alerts.md#disable-alert-rules) to remove Container insights recommended alerts (custom metrics) (preview) feature from your clusters. 
+
+
+## Next steps
+
+- Read about the [different alert rule types in Azure Monitor](../alerts/alerts-types.md).
+- Read about [alerting rule groups in Azure Monitor managed service for Prometheus](../essentials/prometheus-rule-groups.md).

articles/azure-monitor/containers/container-insights-troubleshoot.md

@@ -179,6 +179,10 @@ The solution to this issue is to clean up the existing resources of the Containe
 
 If the preceding steps didn't resolve the installation of Azure Monitor Containers Extension issues, create a support ticket to send to Microsoft for further investigation.
 
+## Duplicate alerts being received
+You may have enabled Prometheus alert rules without disabling Container insights recommended alerts. See [Migrate from Container insights recommended alerts to Prometheus recommended alert rules (preview)](container-insights-recommended-alerts-migrate.md).
+
+
 ## Next steps
 
 When monitoring is enabled to capture health metrics for the AKS cluster nodes and pods, these health metrics are available in the Azure portal. To learn how to use Container insights, see [View Azure Kubernetes Service health](container-insights-analyze.md).