Migrate to the Change Analysis API powered by Azure Resource Graph

Important

Azure Monitor Change Analysis (classic) will be retired on October 31, 2025. The experience will be replaced by the Change Analysis API powered by Azure Resource Graph. Learn more about the future of Change Analysis (classic) and how to migrate to Resource Graph.

How to migrate

You can migrate your services to the Change Analysis API powered by Resource Graph in one of two ways, depending on your integration scenario.

Via PowerShell or the Azure CLI

If you're using PowerShell or the Azure CLI for resource changes, refer to Get resource changes to migrate to the Change Analysis API powered by Resource Graph.

To query the Change Analysis API powered by Resource Graph:

  1. Install the Graph Query extension for Resource Graph. You're prompted to install this extension via the command line if it isn't already installed.

  2. Use Kusto Query Language (KQL). Resource Graph queries use the full power of KQL, which provides granular filtering so that you can see specific values. The classic method returns all values.

To review how you’re using the classic experience, refer to the following links. You can perform queries within a specified time range and scope them by subscription, resource group, or resource.

Learn more by using the Resource Graph guidance.

Via SDK

If you're calling the Change Analysis REST API directly (without CLI or PowerShell) via the Resource Graph .NET SDK or the Change Analysis .NET SDK, use the following links:

What the Change Analysis API powered by Resource Graph provides

At a high level, the updated Change Analysis API offers:

  • Real-time insights: Monitor changes occurring on your resources directly within the Azure portal.
  • Granular filtering: Filter changes based on the type of change, such as creation, updates, deletions, subscriptions, resource groups, and timeframes.
  • Grouping capabilities: Group changes by various parameters, such as subscription, resource group, type, resource, change type, client type, and more.
  • Change actor identification: Gain visibility into the individuals responsible for making changes and the methods used for those modifications.
  • Cross-query: Join across tables to look for changes based on dynamic values in the current resources' configurations, such as tags and location.
  • Alerting: With the Resource Graph Log Analytics connector, create alerts on your changes, such as when a change to a resource was made through the Azure portal.

Learn more about the Change Analysis API powered by Resource Graph.

Compare Azure Monitor Change Analysis (classic) and the Change Analysis API powered by Resource Graph

Feature/experience Azure Monitor Change Analysis (classic) Change Analysis APIs from Resource Graph
Time range 14 days 14 days
Supported resource types Use Change Analysis (classic) in Azure Monitor to find web app issues Supported Resource Manager resource types
Web app in-app data (app settings, file changes, environmental variables) Yes No
Automatic onboarding for data collection No Yes
Resource type Microsoft.ChangeAnalysis/changes and Microsoft.ChangeAnalysis/ resourcechanges Microsoft.Resources/ resources
Change Actor No Yes
Resource Graph query support No Yes
Granular filtering (including Change Type and Change Actor filters) No Yes
Grouping No Yes
Integration with Power BI No Yes

Learn more about the Change Analysis API powered by Resource Graph: