排查功能部署问题Troubleshoot feature deployment issues

在 VM 上部署 Azure 自动化更新管理功能时,可能会收到错误消息。You might receive error messages when you deploy the Azure Automation Update Management feature on your VMs. 本文描述了可能会发生的错误及其解决方法。This article describes the errors that might occur and how to resolve them.

已知问题Known issues

场景:需要取消注册或重新注册才能重命名已注册的节点Scenario: Renaming a registered node requires unregister or register again

问题Issue

已向 Azure 自动化注册节点,但之后更改了操作系统计算机名。A node is registered to Azure Automation, and then the operating system computer name is changed. 来自该节点的报表继续显示原始名称。Reports from the node continue to appear with the original name.

原因Cause

重命名已注册的节点不会更新 Azure 自动化中的节点名称。Renaming registered nodes doesn't update the node name in Azure Automation.

解决方法Resolution

从 Azure 自动化 State Configuration 中注销节点,然后重新注册它。Unregister the node from Azure Automation State Configuration, and then register it again. 该时间之前发布到服务的报表将不再可用。Reports published to the service before that time will no longer be available.

场景:不支持通过 HTTPS 代理重新注册证书Scenario: Re-signing certificates via HTTPS proxy isn't supported

问题Issue

如果通过代理连接,而且该代理会终止 HTTPS 流量,然后使用新的证书重新加密该流量,那么服务将禁止该连接。When you connect through a proxy that terminates HTTPS traffic and then re-encrypts the traffic using a new certificate, the service doesn't allow the connection.

原因Cause

Azure 自动化不支持对用于加密流量的证书重新签名。Azure Automation doesn't support re-signing certificates used to encrypt traffic.

解决方法Resolution

此问题目前没有解决方法。There's currently no workaround for this issue.

常规错误General errors

场景:功能部署失败,显示“无法启用解决方案”消息Scenario: Feature deployment fails with the message "The solution cannot be enabled"

问题Issue

你尝试在 VM 上启用某项功能时收到下列消息之一:You receive one of the following messages when you attempt to enable a feature on a 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

原因Cause

此错误是由于 VM 或工作区上的权限或者用户权限错误或缺失而导致的。This error is caused by incorrect or missing permissions on the VM or workspace, or for the user.

解决方法Resolution

请确保你有适当的功能部署权限,然后尝试再次部署该功能。Ensure that you have correct feature deployment permissions, and then try to deploy the feature again. 如果收到错误消息“The solution cannot be enabled on this VM because the permission to read the workspace is missing”,请参阅以下 故障排除信息If you receive the error message The solution cannot be enabled on this VM because the permission to read the workspace is missing, see the following troubleshooting information.

场景:功能部署失败,显示“未能配置自动化帐户进行诊断日志记录”Scenario: Feature deployment fails with the message "Failed to configure automation account for diagnostic logging"

问题Issue

此错误代码表示已保存的用于将此功能作为目标的搜索计算机组查询格式错误。This error code means that the saved search computer group query used to target the feature isn't formatted correctly.

原因Cause

你或者系统更改了查询。You might have altered the query, or the system might have altered it.

解决方法Resolution

可删除对该功能的查询,然后再次启用该功能,这将重新创建查询。You can delete the query for the feature and then enable the feature again, which re-creates the query. 可在工作区的“已保存的搜索”下找到该查询。The query can be found in your workspace under Saved searches. 查询名称为 MicrosoftDefaultComputerGroup,查询的类别是所关联的功能的名称。The name of the query is MicrosoftDefaultComputerGroup, and the category of the query is the name of the associated feature. 如果启用了多项功能,则 MicrosoftDefaultComputerGroup 查询会在“已保存的搜索”下显示多次 。If multiple features are enabled, the MicrosoftDefaultComputerGroup query shows multiple times under Saved searches.

场景:PolicyViolationScenario: PolicyViolation

问题Issue

此错误代码指出因违反一项或多项策略,部署失败。This error code indicates that the deployment failed due to violation of one or more policies.

原因Cause

某项策略在阻止操作完成。A policy is blocking the operation from completing.

解决方法Resolution

要成功部署该功能,你必须考虑更改所指出的策略。To successfully deploy the feature, you must consider altering the indicated policy. 由于可定义很多不同类型的策略,因此所需的更改由所违反的策略而定。Because there are many different types of policies that can be defined, the changes required depend on the policy that's violated. 例如,如果在资源组上定义了一项策略,该策略拒绝更改某些所含资源的内容,那么你可选择下列解决方案之一:For example, if a policy is defined on a resource group that denies permission to change the contents of some contained resources, you might choose one of these fixes:

  • 将该策略完全删除。Remove the policy altogether.
  • 试着为其他资源组启用该功能。Try to enable the feature for a different resource group.
  • 将该策略的目标改为特定资源,例如自动化帐户。Retarget the policy to a specific resource, for example, an Automation account.
  • 修改该策略根据配置要拒绝的一组资源。Revise the set of resources that the policy is configured to deny.

请查看 Azure 门户右上角的通知,或转到包含自动化帐户的资源组,然后选择“设置”下的“部署”,查看失败的部署 。Check the notifications in the upper-right corner of the Azure portal, or go to the resource group that contains your Automation account and select Deployments under Settings to view the failed deployment. 要详细了解 Azure Policy,请参阅 Azure Policy 概述To learn more about Azure Policy, see Overview of Azure Policy.

问题Issue

你在尝试取消链接某个工作区时收到以下错误消息:You receive the following error message when you try to unlink a workspace:

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

原因Cause

如果你依赖自动化帐户的 Log Analytics 工作区和保持链接状态的 Log Analytics 工作区中仍有功能处于活动状态,那么会出现此错误。This error occurs when you still have features active in your Log Analytics workspace that depend on your Automation account and Log Analytics workspace being linked.

解决方法Resolution

如果你正在使用以下功能,则请从工作区中删除这些功能的资源:Remove the resources for the following features from your workspace if you're using them:

  • 更新管理Update Management

删除功能资源后,可取消链接工作区。After you remove the feature resources, you can unlink your workspace. 有必要从工作区和 Azure 自动化帐户中清除来自这些功能的所有现有项目:It's important to clean up any existing artifacts from these features from your workspace and your Automation account:

  • 对于“更新管理”功能,请从自动化帐户中删除“更新部署(计划)”。For Update Management, remove Update Deployments (Schedules) from your Automation account.

Windows 扩展的 Log Analytics 故障Log Analytics for Windows extension failures

备注

从 Microsoft Operations Management Suite (OMS) 过渡到 Azure Monitor 期间,Windows 或 Linux 的 OMS 代理称为 Windows 或 Linux 的 Log Analytics 代理。As part of the ongoing transition from Microsoft Operations Management Suite (OMS) to Azure Monitor, the OMS Agent for Windows or Linux will be referred to as the Log Analytics agent for Windows and Log Analytics agent for Linux.

安装适用于 Windows 扩展的 Log Analytics 代理时可能会因各种原因而失败。An installation of the Log Analytics agent for Windows extension can fail for a variety of reasons. 以下部分描述了可能会在适用于 Windows 扩展的 Log Analytics 代理的部署期间导致出现故障的功能部署问题。The following section describes feature deployment issues that can cause failures during deployment of the Log Analytics agent for Windows extension.

备注

Microsoft Monitoring Agent (MMA) 的 Azure 自动化中目前使用“Windows 的 Log Analytics 代理”这个名称。Log Analytics agent for Windows is the name used currently in Azure Automation for the Microsoft Monitoring Agent (MMA).

场景:在 WebClient 请求期间发生异常Scenario: An exception occurred during a WebClient request

VM 上适用于 Windows 扩展的 Log Analytics 无法与外部资源通信,因此部署失败。The Log Analytics for Windows extension on the VM is unable to communicate with external resources and the deployment fails.

问题Issue

下面是返回的错误消息示例:The following are examples of error messages that are returned:

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.

原因Cause

导致此错误的部分潜在原因包括:Some potential causes of this error are:

  • VM 中配置的某个代理仅允许使用特定端口。A proxy configured in the VM only allows specific ports.
  • 某个防火墙设置已阻止访问所需的端口和地址。A firewall setting has blocked access to the required ports and addresses.

解决方法Resolution

确保已打开正确的端口和地址用于通信。Ensure that you have the proper ports and addresses open for communication. 有关端口和地址的列表,请参阅规划网络For a list of ports and addresses, see Planning your network.

场景:因暂时性环境问题导致安装失败Scenario: Install failed because of transient environment issues

在部署期间,由于正在进行其他安装或有操作阻止安装,导致适用于 Windows 扩展的 Log Analytics 安装失败。The installation of the Log Analytics for Windows extension failed during deployment because of another installation or action blocking the installation.

问题Issue

下面是可能返回的错误消息示例:The following are examples of error messages that might be returned:

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'

原因Cause

导致此错误的部分潜在原因包括:Some potential causes of this error are:

  • 另一项安装正在进行。Another installation is in progress.
  • 模板部署期间触发了系统重启。The system is triggered to reboot during template deployment.

解决方法Resolution

此错误必定是暂时性的。This error is transient in nature. 请重试部署,以安装该扩展。Retry the deployment to install the extension.

场景:安装超时Scenario: Installation timeout

由于超时,适用于 Windows 扩展的 Log Analytics 未完成安装。The installation of the Log Analytics for Windows extension didn't complete because of a timeout.

问题Issue

下面是可能返回的错误消息示例:The following is an example of an error message that might be returned:

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

原因Cause

安装期间 VM 的负载较重,因此出现此类型的错误。This type of error occurs because the VM is under a heavy load during installation.

解决方法Resolution

请尝试在 VM 负载较低时安装适用于 Windows 扩展的 Log Analytics 代理。Try to install the Log Analytics agent for Windows extension when the VM is under a lower load.

后续步骤Next steps

如果未在此处看到你遇到的问题,或者无法解决你遇到的问题,请尝试以下途径之一以获取其他支持:If you don't see your problem here or you can't resolve your issue, try one of the following channels for additional support: