Edit

Share via


Migrate from Logs Query API batch operation and beta version

The Azure Monitor Logs Query API is deprecating the batch query operation and the beta API version. Support for these features is available according to the following timelines:

Support cutoff date Deprecation Migration steps
March 31, 2026 Logs Query API beta version Change beta path to v1
March 31, 2028 Logs Query API batch operation Split batch queries into single queries

Change beta path to v1

To migrate from the beta version of the Logs Query API, change the path in your API calls from beta to v1.

Operation group reference URI examples
Log Analytics
query
metadata
https://api.loganalytics.azure.com/beta/
https://api.loganalytics.io/beta/
Log Analytics via ARM1
query
metadata
https://management.azure.com/.../api/query?api-version=2017-01-01-preview
https://management.azure.com/.../api/metadata?api-version=2017-01-01-preview
Application Insights
query
metadata
metrics
events
https://api.applicationinsights.azure.com/beta/
https://api.applicationinsights.io/beta/

1Log Analytics queries via ARM should migrate to the Logs Query API v1 request format.

Split batch queries to single queries

To migrate batch API calls, split every query that you previously sent as part of the requests array in the body of the message and use the query section in the request format instead.

If you use an Azure SDK client library to initiate batch queries, split batched queries to run as separate queries using the corresponding methods.

Ecosystem Package
.NET Azure.Monitor.Query
Go azlogs
Java azure-monitor-query
JavaScript @azure/monitor-query
Python azure-monitor-query

Make adjustments to handle the response using the Logs Query API response format.