Use the voluntary migration tool to migrate your classic alert rules

As previously announced, classic alerts in Azure Monitor are being retired in September 2019 (was originally July 2019). A migration tool is available in the Azure portal to customers who use classic alert rules and who want to trigger migration themselves. This article explains how to use the migration tool to voluntarily migrate your classic alert rules before the automatic migration starts in September 2019.

Note

Due to delay in roll-out of migration tool, the retirement date for classic alerts migration has been extended to August 31st, 2019 from the originally announced date of June 30th, 2019.

Benefits of new alerts

Classic alerts are being replaced by new, unified alerting in Azure Monitor. The new alerts platform has the following benefits:

  • You can alert on a variety of multidimensional metrics for many more Azure services.
  • The new metric alerts support multi-resource alert rules that greatly reduce the overhead of managing many rules.
  • The unified notification mechanism, which supports:
    • Action groups, a modular notification mechanism that works with all new alert types (metric, log, and activity log).
    • New notification mechanisms like SMS, voice, and ITSM Connector.
  • The unified alert experience brings all the alerts on different signals (metric, log, and activity log) into one place.

Before you migrate

The migration process converts classic alert rules to new, equivalent alert rules, and creates action groups. In preparation, be aware of the following points:

  • Both the notification payload format and the APIs to create and manage new alert rules are different from those of the classic alert rules because they support more features. Learn how to prepare for the migration.

  • Some classic alert rules cannot be migrated by using the tool. Learn which rules cannot be migrated and what to do with them.

    Note

    The migration process won't impact the evaluation of your classic alert rules. They'll continue to run and send alerts until they're migrated and the new alert rules take effect.

How to use the migration tool

To trigger the migration of your classic alert rules in the Azure portal, follow these steps:

  1. In Azure portal, select Monitor.

  2. Select Alerts, and then select Manage alert rules or View classic alerts.

  3. Select Migrate to new rules to go to the migration landing page. This page shows a list of all your subscriptions and their migration status:

    migration-landing

    All subscriptions that can be migrated by using the tool are marked as Ready to migrate.

    Note

    The migration tool is rolling out in phases to all the subscriptions that use classic alert rules. In the early phases of the rollout, you might see some subscriptions marked as not ready for migration.

  4. Select one or more subscriptions, and then select Preview migration.

    The resulting page shows the details of classic alert rules that will be migrated for one subscription at a time. You can also select Download the migration details for this subscription to get the details in a CSV format.

    migration-preview

  5. Specify one or more email addresses to be notified of migration status. You'll receive email when the migration is complete or if any action is needed from you.

  6. Select Start Migration. Read the information shown in the confirmation dialog box and confirm that you're ready to start the migration process.

    Important

    After you initiate migration for a subscription, you won't be able to edit or create classic alert rules for that subscription. This restriction ensures that no changes to your classic alert rules are lost during migration to the new rules. Although you won't be able to change your classic alert rules, they'll still continue to run and to provide alerts until they've been migrated. After the migration is complete for your subscription, you can't use classic alert rules anymore.

    migration-confirm

  7. When migration is complete, or if action is required from you, you'll receive an email at the addresses that you provided earlier. You can also periodically check the status at the migration landing page in the portal.

Frequently asked questions

Why is my subscription listed as not ready for migration?

The migration tool is rolling out to customers in phases. In the early phases, most or all of your subscriptions might be marked as Not ready for migration.

When a subscription becomes ready for migration, the subscription owner will receive an email message stating that the tool is available. Keep an eye out for this message.

Who can trigger the migration?

Users who have the Monitoring Contributor role assigned to them at the subscription level are able to trigger the migration. Learn more about Role-Based Access Control for the migration process.

How long will the migration take?

Migration is completed for most subscriptions in under an hour. You can keep track of the migration progress on the migration landing page. During the migration, be assured that your alerts are still running either in the classic alerts system or in the new one.

What can I do if I run into a problem during migration?

See the troubleshooting guide for help with problems you might face during migration. If any action is needed from you to complete the migration, you'll be notified at the email addresses you provided when you set up the tool.

Next steps