从日志查询 API 批量操作及 beta 版本迁移

2025-10-23

Azure Monitor 日志查询 API 正在弃用 batch 查询操作和 beta API 版本。根据以下时间线提供对这些功能的支持：

支持截止日期	弃用	迁移步骤
2026 年 3 月 31 日	日志查询 API `beta` 版本	将路径更改为`betav1`
2028 年 3 月 31 日	日志查询 API `batch` 操作	将批处理查询拆分为单个查询

检查日志查询 API beta 版本是否使用

注释

Azure 门户中当前没有直接 UI，用于显式标记已弃用的 beta API 版本的使用情况。

启用查询审核

在 Log Analytics 工作区中创建诊断设置，然后选择：

日志： 审计
目标详细信息： 发送到 Log Analytics 工作区

通过查询审核，您可以使用LAQueryLogs表来检测 API 使用模式。具体而言，查找那些 RequestTarget 或 RequestClientApp 字段表明使用 beta API 的条目。

检查 API beta 版本的日志

检查一个特定的工作区：

在 Azure 门户中转到 Log Analytics 工作区 。

在日志中，运行以下查询：

LAQueryLogs
| where TimeGenerated > ago(30d)
| where RequestTarget contains "/beta/"
| project TimeGenerated, RequestClientApp, RequestTarget, QueryText

跨多个工作区检查：

在 Azure 门户中转到 监视器 。

在日志中，运行以下查询：

union 
  workspace("workspace-id-1").LAQueryLogs,
  workspace("workspace-id-2").LAQueryLogs,
  workspace("workspace-id-3").LAQueryLogs
| where TimeGenerated > ago(30d)
| where RequestTarget contains "/beta/"
| project TimeGenerated, RequestClientApp, RequestTarget, QueryText

将`beta`路径更改至`v1`

若要从 beta 日志查询 API 的版本迁移，请将 API 调用中的路径从 beta 更改为 v1。

操作组参考	URI 示例
Log Analytics `query` `metadata`	`https://api.loganalytics.azure.cn/beta/` `https://api.loganalytics.io/beta/`
ARM¹ 中的 Log Analytics `query` `metadata`	`https://management.chinacloudapi.cn/.../api/query?api-version=2017-01-01-preview` `https://management.chinacloudapi.cn/.../api/metadata?api-version=2017-01-01-preview`
Application Insights `query` `metadata` `metrics` `events`	`https://api.applicationinsights.azure.cn/beta/` `https://api.applicationinsights.io/beta/`

¹通过 ARM 的 Log Analytics 查询应迁移到日志查询 API v1请求格式。

将批处理查询拆分为单个查询

若要迁移批处理 API 调用，请拆分之前在消息正文中作为 requests 数组一部分发送的每个查询，并改用 query 中的部分。

如果使用 Azure SDK 客户端库启动批处理查询，请使用相应的方法拆分批处理查询以单独查询的形式运行。

生态系统	包装
.NET	Azure.Monitor.Query
Go	azlogs
Java	azure-monitor-query
JavaScript	@azure/monitor-query
Python	azure-monitor-query

调整以使用日志查询 API 响应格式处理响应。

通过