Compartir a través de

排查功能部署问题

在 VM 上部署 Azure 自动化更新管理功能时,可能会收到错误消息。 本文描述了可能会发生的错误及其解决方法。

已知问题

场景:需要取消注册或重新注册才能重命名已注册的节点

问题

已向 Azure 自动化注册节点,但之后更改了操作系统计算机名。 来自该节点的报表继续显示原始名称。

原因

重命名已注册的节点不会更新 Azure 自动化中的节点名称。

解决方法

从 Azure 自动化 State Configuration 中注销节点,然后重新注册它。 该时间之前发布到服务的报表将不再可用。

场景:不支持通过 HTTPS 代理重新注册证书

问题

如果通过代理连接,而且该代理会终止 HTTPS 流量,然后使用新的证书重新加密该流量,那么服务将禁止该连接。

原因

Azure 自动化不支持对用于加密流量的证书重新签名。

解决方法

此问题目前没有解决方法。

常规错误

场景:功能部署失败,显示“无法启用解决方案”消息

问题

你尝试在 VM 上启用某项功能时收到下列消息之一:

The solution cannot be enabled due to missing permissions for the virtual machine or deployments
The solution cannot be enabled on this VM because the permission to read the workspace is missing

原因

此错误是由于 VM 或工作区上的权限或者用户权限错误或缺失而导致的。

解决方法

请确保你有适当的功能部署权限,然后尝试再次部署该功能。 如果收到错误消息“The solution cannot be enabled on this VM because the permission to read the workspace is missing”,请参阅以下 故障排除信息

场景:功能部署失败,显示“未能配置自动化帐户进行诊断日志记录”

问题

你尝试在 VM 上启用某项功能时收到以下消息:

Failed to configure automation account for diagnostic logging

原因

如果定价层与订阅的计费模型不匹配,则可能导致此错误。 有关详细信息,请参阅在 Azure Monitor 中监视使用情况和预估成本

解决方法

手动创建 Log Analytics 工作区,然后重复功能部署过程,选择刚才创建的工作区。

场景:ComputerGroupQueryFormatError

问题

此错误代码表示已保存的用于将此功能作为目标的搜索计算机组查询格式错误。

原因

你或者系统更改了查询。

解决方法

可删除对该功能的查询,然后再次启用该功能,这将重新创建查询。 可在工作区的“已保存的搜索”下找到该查询。 查询名称为 MicrosoftDefaultComputerGroup,查询的类别是所关联的功能的名称。 如果启用了多项功能,则 MicrosoftDefaultComputerGroup 查询会在“已保存的搜索”下显示多次 。

场景:PolicyViolation

问题

此错误代码指出因违反一项或多项 Azure Policy 分配而导致部署失败。

原因

Azure Policy 分配阻止操作完成。

解决方法

要成功部署该功能,你必须考虑更改所指的策略定义。 由于可定义很多不同类型的策略定义,因此所需的更改由所违反的策略定义而定。 例如,如果为某个资源组上分配了一个策略定义,该策略拒绝授予权限以更改某些所含资源的内容,那么你可选择下列解决方案之一:

  • 完全删除策略分配。
  • 试着为其他资源组启用该功能。
  • 将策略分配重新定向到特定资源,例如自动化帐户。
  • 修改该策略定义根据配置要拒绝访问的一组资源。

请查看 Azure 门户右上角的通知,或转到包含自动化帐户的资源组,然后选择“设置”下的“部署”,查看失败的部署 。 要详细了解 Azure Policy,请参阅 Azure Policy 概述

问题

你在尝试取消链接某个工作区时收到以下错误消息:

The link cannot be updated or deleted because it is linked to Update Management Solutions.

原因

如果你依赖自动化帐户的 Log Analytics 工作区和保持链接状态的 Log Analytics 工作区中仍有功能处于活动状态,那么会出现此错误。

解决方法

如果你正在使用以下功能,则请从工作区中删除这些功能的资源:

  • 更新管理

删除功能资源后,可取消链接工作区。 有必要从工作区和 Azure 自动化帐户中清除来自这些功能的所有现有项目:

  • 对于“更新管理”功能,请从自动化帐户中删除“更新部署(计划)”。

Windows 扩展的 Log Analytics 故障

注意

从 Microsoft Operations Management Suite 过渡到 Azure Monitor 期间,Windows 或 Linux 的 Operations Management Suite 代理称为 Windows 或 Linux 的 Log Analytics 代理。

安装适用于 Windows 扩展的 Log Analytics 代理时可能会因各种原因而失败。 以下部分描述了可能会在适用于 Windows 扩展的 Log Analytics 代理的部署期间导致出现故障的功能部署问题。

注意

Microsoft Monitoring Agent (MMA) 的 Azure 自动化中目前使用“Windows 的 Log Analytics 代理”这个名称。

场景:在 WebClient 请求期间发生异常

VM 上适用于 Windows 扩展的 Log Analytics 无法与外部资源通信,因此部署失败。

问题

下面是返回的错误消息示例:

Please verify the VM has a running VM agent, and can establish outbound connections to Azure storage.
'Manifest download error from https://<endpoint>/<endpointId>/Microsoft.EnterpriseCloud.Monitoring_MicrosoftMonitoringAgent_australiaeast_manifest.xml. Error: UnknownError. An exception occurred during a WebClient request.

原因

导致此错误的部分潜在原因包括:

  • VM 中配置的某个代理仅允许使用特定端口。
  • 某个防火墙设置已阻止访问所需的端口和地址。

解决方法

确保已打开正确的端口和地址用于通信。 有关端口和地址的列表,请参阅规划网络

场景:因暂时性环境问题导致安装失败

在部署期间,由于正在进行其他安装或有操作阻止安装,导致适用于 Windows 扩展的 Log Analytics 安装失败。

问题

下面是可能返回的错误消息示例:

The Microsoft Monitoring Agent failed to install on this machine. Please try to uninstall and reinstall the extension. If the issue persists, please contact support.
'Install failed for plugin (name: Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent, version 1.0.11081.4) with exception Command C:\Packages\Plugins\Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent\1.0.11081.4\MMAExtensionInstall.exe of Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent has exited with Exit code: 1618'
'Install failed for plugin (name: Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent, version 1.0.11081.2) with exception Command C:\Packages\Plugins\Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent\1.0.11081.2\MMAExtensionInstall.exe of Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent has exited with Exit code: 1601'

原因

导致此错误的部分潜在原因包括:

  • 另一项安装正在进行。
  • 模板部署期间触发了系统重启。

解决方法

此错误必定是暂时性的。 请重试部署,以安装该扩展。

场景:安装超时

由于超时,适用于 Windows 扩展的 Log Analytics 未完成安装。

问题

下面是可能返回的错误消息示例:

Install failed for plugin (name: Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent, version 1.0.11081.4) with exception Command C:\Packages\Plugins\Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent\1.0.11081.4\MMAExtensionInstall.exe of Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent has exited with Exit code: 15614

原因

安装期间 VM 的负载较重,因此出现此类型的错误。

解决方法

请尝试在 VM 负载较低时安装适用于 Windows 扩展的 Log Analytics 代理。

后续步骤

如果你的问题未在本文中列出,或者无法解决问题,请尝试通过以下渠道之一获取更多支持: