Azure Monitor Agent基于数据收集规则的安装时长、状态查询及显示问题咨询

安装耗时 #

• 单台Azure虚拟机/VMSS实例：通常分钟级别（5-15分钟左右），具体取决于网络环境和虚拟机配置。
• 批量部署（数十台以上）：耗时随实例数量递增，一般在小时级别内完成；极端情况（如网络受限、资源配额不足）下可能延长，但极少达到天级别。

安装状态查询方法 #

1. Azure 门户操作 #

• 进入目标虚拟机/VMSS页面，在左侧菜单监控板块下找到数据收集规则，查看已关联的DCR及agent状态；
• 或进入Log Analytics工作区，在代理管理中查看已连接的agent列表。

2. PowerShell 命令 #

# 查询Windows系统VM的Azure Monitor Agent状态
Get-AzVmExtension -ResourceGroupName "你的资源组名" -VMName "你的VM名" -Name "AzureMonitorWindowsAgent"

# 查询Linux系统VM的Azure Monitor Agent状态
Get-AzVmExtension -ResourceGroupName "你的资源组名" -VMName "你的VM名" -Name "AzureMonitorLinuxAgent"

返回结果中ProvisioningState为Succeeded即表示安装成功。

3. Azure CLI 命令 #

# 查询Windows系统VM的Azure Monitor Agent状态
az vm extension show --resource-group "你的资源组名" --vm-name "你的VM名" --name "AzureMonitorWindowsAgent"

# 查询Linux系统VM的Azure Monitor Agent状态
az vm extension show --resource-group "你的资源组名" --vm-name "你的VM名" --name "AzureMonitorLinuxAgent"

重点关注provisioningState字段的取值。

4. Log Analytics 日志查询 #

若agent已成功上报数据，可在目标工作区运行以下Kusto查询验证：

Heartbeat
| where Computer == "你的VM名称"
| where Category == "Azure Monitor Agent"
| take 10

返回结果则说明agent已正常工作。

Agent未在Log Analytics Workspace显示的排查步骤 #

• 检查DCR关联配置：确认数据收集规则已正确绑定到目标VM/VMSS，且规则中包含向该Workspace推送数据的设置；
• 验证agent安装结果：通过上述PowerShell/CLI命令确认agent的ProvisioningState为Succeeded，若失败根据错误信息排查问题；
• 查看agent本地日志：Windows系统日志路径为事件查看器 > 应用程序和服务日志 > Microsoft > AzureMonitorAgent；Linux系统日志路径为/var/log/azure/Microsoft.Azure.Monitor.AzureMonitorAgent/，检查是否存在连接或认证类错误；
• 确认Workspace权限：确保VM的系统分配身份（或用户分配身份）拥有Log Analytics工作区的Log Analytics Contributor或Monitoring Metrics Publisher权限；
• 等待数据 ingestion 延迟：agent安装成功后，首次数据上报可能存在5-10分钟的延迟，可稍作等待后再查看。

内容的提问来源于stack exchange，提问作者Janne Rajala