Compartir a través de

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

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 版本的日志

  • 检查一个特定的工作区：

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

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

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

  • 跨多个工作区检查：

    1. 在 Azure 门户中转到 监视器 。

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

      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/
ARM1 中的 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/

1通过 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 响应格式处理响应。

  • Last updated on