你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

从数据收集器 API 和已启用自定义字段的表迁移到基于 DCR 的自定义日志收集

  • 项目

本文介绍如何在 Azure Monitor 中从数据收集器 API 或自定义字段迁移到基于 DCR 的自定义日志收集。 它包括在 Log Analytics 工作区中创建的自定义表所需的配置，以便日志引入 API 和工作区转换可以使用这些表。

重要

如果使用 Azure 门户配置基于 DCR 的自定义日志，则无需按照本文操作，因为将为你执行配置。 本文仅适用于使用资源管理器模板 API 进行配置的情况。

背景

若要将表用于日志引入 API 或工作区转换，必须将其配置为支持新功能。 完成本文中所述的过程后，将执行以下操作：

  • 表将重新配置为启用所有基于 DCR 的自定义日志功能。 这包括 DCR 和 DCE 支持以及使用新的表控制平面进行管理。
  • 任何以前定义的自定义字段都将停止填充。
  • 数据收集器 API 将继续工作，但不会创建任何新列。 数据将仅填充到迁移之前创建的任何列中。
  • 架构和历史数据将保留，可以通过与以前相同的方式进行访问。

适用的方案

仅当以下所有条件适用时，本文才适用：

如果所有这些条件都不成立，则可以在不遵循此处所述过程的情况下使用基于 DCR 的日志收集。

迁移过程

如果使用基于 DCR 的日志收集所针对的表符合上述条件，则必须执行以下步骤：

  1. 按照以下过程配置数据收集规则 (DCR)：使用资源管理器模板将自定义日志发送到 Azure Monitor 日志或使用资源管理器模板将工作区数据收集规则中的转换添加到 Azure Monitor。

  2. 如果使用日志引入 API，还应配置数据收集终结点 (DCE) 以及将数据发送到 API 的代理或组件。

  3. 针对表发出以下 API 调用。 此调用是幂等的，因此如果表已迁移，将不会产生任何影响。

    POST https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}/migrate?api-version=2021-12-01-preview

  4. 停止使用数据收集器 API 并开始使用新的日志引入 API。

后续步骤