从Log Analytics代理自定义日志表迁移到基于 Azure Monitor 代理 DCR 的自定义日志表

本文介绍如何从旧版Log Analytics代理（MMA）迁移自定义文本日志表。 迁移后的表随后可用作目标表，用于存储 Azure Monitor 代理（AMA）通过数据收集规则（DCR）收集的自定义文本日志。

背景

必须将 Log Analytics 代理自定义文本日志配置为支持新的 DCR 功能，以允许 AMA 写入该表。 考虑以下情况：

• 将重新配置该表，以启用基于 DCR 的自定义日志的所有功能。
• AMA 可以将数据写入表中的任何列。
• Log Analytics代理自定义文本日志无法写入该表。

若要继续从 Log Analytics 代理和 AMA 编写自定义数据，每个代理必须有自己的自定义日志表。 在 Log Analytics 中处理数据的数据查询必须联接这两个表，直到迁移完成；届时，你就可以移除该联接。

迁移

仅当满足以下条件时，才应遵循这些步骤：

• 使用自定义日志向导创建了原始表。
• 你将保留表中的现有数据。
• 无需Log Analytics代理将数据发送到现有表。
• 你将专门使用 DCR 为 AMA 自定义文本日志 编写新数据，并可能配置 引入时间转换。

过程

1. 按照使用 AMA 收集文本日志中的说明配置你的数据收集规则（DCR）。

2. 若要从 DCR 启用引入并在Azure门户中管理表，请针对现有的自定义日志表发出以下 API 调用。 此调用只会在第一次运行时更改该表。 再次运行它不起作用。 迁移是单向迁移，因此无法将表迁移回Log Analytics代理。

   • Azure CLI
   • PowerShell
   • REST

   以下的 Azure CLI 示例使用 az monitor log-analytics workspace table migrate 命令。

   subscriptionId="aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
   resourceGroupName="myResourceGroup"
   workspaceName="myWorkspace"
   tableName="myTable"
   
   az account set --subscription "$subscriptionId"
   
   az monitor log-analytics workspace table migrate \
     --resource-group "$resourceGroupName" \
     --workspace-name "$workspaceName" \
     --table-name "$tableName"
   

   注释

   Azure CLI命令使用当前 CLI 上下文中的Azure 资源管理器终结点，因此无需在命令语法中指定 management.chinacloudapi.cn。

   Variable	示例值	Purpose
   主持人	management.chinacloudapi.cn	隐式 ARM 终结点
   subscriptionId	aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e	用户输入
   resourceGroupName	myResourceGroup	用户输入
   工作区名称	myWorkspace	用户输入
   tableName	myTable	用户输入
   apiVersion	2025-07-01	引用

3. 停止Log Analytics代理自定义文本日志收集并开始使用 AMA 自定义文本日志。

后续步骤

• 通过 Azure portal 进行发送自定义日志的教程介绍。
• 为自定义文本数据创建引入时间转换