安装 Azure Monitor 代理

本文提供在 Azure 虚拟机上安装 Azure Monitor 代理当前可采用的不同选项,还提供用于创建数据收集规则关联的选项,这些规则将定义代理应收集的数据。

先决条件

安装 Azure Monitor 代理之前,需要满足以下先决条件。

重要

Azure Monitor 代理当前不支持专用链接。

虚拟机扩展详细信息

Azure Monitor 代理以 Azure VM 扩展方式实现,详细信息如下表所示。 可以使用任何方法来安装虚拟机扩展,其中包括本文中所述的方法。

属性 Windows Linux
Publisher Microsoft.Azure.Monitor Microsoft.Azure.Monitor
类型 AzureMonitorWindowsAgent AzureMonitorLinuxAgent
TypeHandlerVersion 1.0 1.5

扩展版本

强烈建议更新到正式发布版本,而不要使用预览版或中间版本。

发布日期 发行说明 Windows Linux
2021 年 6 月 宣布正式发布。
  • 除指标目标之外的所有功能现已正式发布
  • 生产质量、安全性和符合性
  • 在所有公共区域推出
  • 针对更高 EPS 的性能和缩放性方面的改进
了解详细信息
1.0.12.0 1.9.1.0
2021 年 7 月
  • 直接代理支持
  • Log Analytics 网关支持
了解详细信息
1.1.1.0 1.10.5.0
2021 年 8 月 修复了允许将 Azure Monitor 指标用作唯一目标的问题 1.1.2.0 1.10.9.01
2021 年 9 月
  • 修复了重启代理时导致数据丢失的问题
  • 针对 Arc Windows 服务器解决了 1.1.3.1 中引入的回归2
1.1.3.2 1.12.2.0 2

1 不要使用 AMA Linux 版本 1.10.7.0 2 已知回归在已启用 Arc 的服务器上无法正常工作

使用 Azure 门户安装

要使用 Azure 门户安装 Azure Monitor 代理,请按照在 Azure 门户中创建数据收集规则的过程进行操作。 这样可以将数据收集规则与一个或多个 Azure 虚拟机相关联。 代理将安装到尚未安装该代理的任何虚拟机上。

使用资源管理器模板安装

可以使用资源管理器模板在 Azure 虚拟机上安装 Azure Monitor 代理,以及创建数据收集规则关联。 创建关联之前,必须先创建任何数据收集规则。

有关安装代理和创建关联的示例模板,请参阅以下内容:

使用任何部署资源管理器模板的方法安装模板,例如以下命令。

New-AzResourceGroupDeployment -ResourceGroupName "<resource-group-name>" -TemplateFile "<template-filename.json>" -TemplateParameterFile "<parameter-filename.json>"

使用 PowerShell 安装

可以使用 PowerShell 命令添加虚拟机扩展,由此在 Azure 虚拟机上安装 Azure Monitor 代理。

Azure 虚拟机

使用以下 PowerShell 命令在 Azure 虚拟机上安装 Azure Monitor 代理。

Set-AzVMExtension -Name AMAWindows -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion 1.0

使用 Azure CLI 安装

可以使用 Azure CLI 命令添加虚拟机扩展,由此在 Azure 虚拟机上安装 Azure Monitor 代理。

Azure 虚拟机

使用以下 CLI 命令在 Azure 虚拟机上安装 Azure Monitor 代理。

az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id>

使用 Azure Policy 安装

创建虚拟机时,使用以下策略和策略计划自动安装代理并将其与数据收集规则关联。

内置策略计划

查看代理安装的先决条件

以下针对 Windows 和 Linux 虚拟机的策略计划包含可执行以下操作的各个策略:

  • 在虚拟机上安装 Azure Monitor 代理扩展。
  • 创建并部署关联,以将虚拟机链接到数据收集规则。

Partial screenshot from the Azure Policy Definitions page showing two built-in policy initiatives for configuring the Azure Monitor agent.

内置策略

可以根据需要选择使用各自策略计划中的各个策略。 例如,如果只想自动安装代理,可使用计划中的第一个策略,如下所示。

Partial screenshot from the Azure Policy Definitions page showing policies contained within the initiative for configuring the Azure Monitor agent.

补救

这些计划或策略将在创建时应用于每个虚拟机。 修正任务会将计划中的策略定义部署到现有资源,以便为任何已创建的资源配置 Azure Monitor 代理。

使用 Azure 门户创建分配时,可以选择同时创建修正任务。 有关修正的详细信息,请参阅使用 Azure Policy 修正不合规资源

Screenshot that shows initiative remediation for the Azure Monitor agent.

诊断设置

诊断设置从 Azure 资源收集资源日志和指标并将其路由到多个位置。 典型的位置是 Log Analytics 工作区,该工作区允许使用日志查询日志警报分析数据。 使用 Azure Policy 可在每次创建资源时自动创建诊断设置。

后续步骤