安装 Azure Monitor 代理
本文提供在 Azure 虚拟机上安装 Azure Monitor 代理当前可采用的不同选项,还提供用于创建数据收集规则关联的选项,这些规则将定义代理应收集的数据。
先决条件
安装 Azure Monitor 代理之前,需要满足以下先决条件。
- 必须在 Azure 虚拟机上启用托管系统标识。 如果在使用 Azure 门户创建和分配数据收集规则的过程中安装代理,系统标识将自动启用。
- 必须在虚拟机的虚拟网络上启用 AzureResourceManager 服务标记。
- 虚拟机必须具有以下 HTTPS 终结点的访问权限:
- *.ods.opinsights.azure.cn
- *.ingest.monitor.azure.com
- *.control.monitor.azure.com
重要
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 月 | 宣布正式发布。
|
1.0.12.0 | 1.9.1.0 |
2021 年 7 月 |
|
1.1.1.0 | 1.10.5.0 |
2021 年 8 月 | 修复了允许将 Azure Monitor 指标用作唯一目标的问题 | 1.1.2.0 | 1.10.9.01 |
2021 年 9 月 |
|
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 代理扩展。
- 创建并部署关联,以将虚拟机链接到数据收集规则。
内置策略
可以根据需要选择使用各自策略计划中的各个策略。 例如,如果只想自动安装代理,可使用计划中的第一个策略,如下所示。
补救
这些计划或策略将在创建时应用于每个虚拟机。 修正任务会将计划中的策略定义部署到现有资源,以便为任何已创建的资源配置 Azure Monitor 代理。
使用 Azure 门户创建分配时,可以选择同时创建修正任务。 有关修正的详细信息,请参阅使用 Azure Policy 修正不合规资源。
诊断设置
诊断设置从 Azure 资源收集资源日志和指标并将其路由到多个位置。 典型的位置是 Log Analytics 工作区,该工作区允许使用日志查询和日志警报分析数据。 使用 Azure Policy 可在每次创建资源时自动创建诊断设置。
后续步骤
- 创建数据收集规则,通过代理收集数据并将其发送给 Azure Monitor。