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:
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.
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.
- PowerShell:
Get-AzChangeAnalysis(Az.ChangeAnalysis) - Azure CLI:
az change-analysis
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:
Resource Graph Change Analysis SDK:
ResourceGraphExtensionsClass (Azure.ResourceManager.ResourceGraph)Here are some code samples for the resources table:
azure-sdk-for-net/sdk/resourcegraph/Azure.ResourceManager.ResourceGraph/samples/Generated/Samples/Sample_TenantResourceExtensions.csClassic SDK:
ChangeAnalysisExtensionsClass
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 |
Related content
Learn more about the Change Analysis API powered by Resource Graph: