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

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

背景

必须配置 Log Analytics 代理的自定义文本日志，以支持使 AMA 能够写入该表的新 DCR 功能。 请考虑以下几点：

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

为了继续从Log Analytics代理和 AMA 编写自定义数据，每个代理都需要自己的自定义日志表。 Log Analytics中的数据查询必须联接这两个表，直到迁移完成，此时可以删除联接。

迁移

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

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

过程

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 进行发送自定义日志的教程介绍。
• 为自定义文本数据创建引入时间转换