大网数据广告活动
Azure 监控与自动化

排查 Azure 自动化混合 Runbook 辅助角色问题

· 52CE 我爱测

本文介绍如何排查和解决 Azure 自动化混合 Runbook 辅助角色出现的问题。

本文介绍如何排查和解决 Azure 自动化混合 Runbook 辅助角色的问题。 如需常规信息,请参阅混合 Runbook 辅助角色概述。

常规

混合 Runbook 辅助角色依靠代理与 Azure 自动化帐户通信,以注册辅助角色、接收 Runbook 作业和报告状态。 对于 Windows,此代理是适用于 Windows 的 Log Analytics 代理。 对于 Linux,此代理是适用于 Linux 的 Log Analytics 代理。

场景:Runbook 执行失败

问题

Runbook 执行失败并出现以下错误消息:

The job action 'Activate' cannot be run, because the process stopped unexpectedly. The job action was attempted three times.

Runbook 在尝试执行三次后很快暂停。 在某些情况下,Runbook 可能会中断,无法正常完成。 相关错误消息可能不包括任何附加信息。

原因

下面是可能的原因:

  • Runbook 无法使用本地资源进行身份验证。
  • 混合辅助角色在代理或防火墙后面。
  • 配置为运行混合 Runbook 辅助角色的计算机不满足最低硬件要求。
解决方法

验证计算机是否在端口443上有到 azure-automation.net 的出站访问权限 * 。

运行混合 Runbook 辅助角色的计算机应满足最低硬件要求,然后才能将辅助角色配置为托管此功能。 它们使用的 Runbook 和后台进程可能会导致系统过度使用,造成 Runbook 作业延迟或超时。

确认将要运行混合 Runbook 辅助角色功能的计算机满足最低硬件要求。 如果满足,请监视 CPU 和内存使用,以确定混合 Runbook 辅助角色进程的性能和 Windows 之间的任何关联。 出现内存或 CPU 压力可能意味着需要升级资源。 也可以选择其他支持最低要求的计算资源,并在工作负荷需求指示需要增加时进行扩展。

在 Microsoft-SMA 事件日志中检查附带“Win32 Process Exited with code [4294967295]”说明的相应事件。 此错误的原因是尚未在 Runbook 中配置身份验证,或者未为混合 Runbook 辅助角色组指定运行方式凭据。 在在混合 Runbook 辅助角色上运行 Runbook 中查看 Runbook 权限,确认是否已正确配置 Runbook 的身份验证。

场景:混合 Runbook 辅助角色中发生事件 15011

问题

混合 Runbook 辅助角色收到表示查询结果无效的事件 15011。 当辅助角色尝试与 SignalR 服务器建立连接时出现以下错误。

[AccountId={c7d22bd3-47b2-4144-bf88-97940102f6ca}] [Uri=https://cc-jobruntimedata-prod-su1.azure-automation.net/notifications/hub][Exception=System.TimeoutException: Transport timed out trying to connect at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw() at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task) at JobRuntimeData.NotificationsClient.JobRuntimeDataServiceSignalRClient.<Start>d__45.MoveNext()

原因

未为自动化功能部署(例如更新管理)正确配置混合 Runbook 辅助角色。 部署包含的某个部件会将 VM 连接到 Log Analytics 工作区。 PowerShell 脚本将在订阅中查找具有所提供名称的工作区。 在此示例中,该 Log Analytics 工作区位于其他订阅中。 脚本找不到该工作区,因此尝试创建一个工作区,但该名称已被占用。 因此,部署失败。

解决方法

可以采用两种做法来解决此问题:

  • 修改 PowerShell 脚本,以在另一个订阅中查找 Log Analytics 工作区。 如果你将来打算部署许多混合 Runbook 辅助角色计算机,则非常适合使用此解决方法。

  • 手动将辅助角色计算机配置为在业务流程协调程序沙盒中运行。 然后在该辅助角色上运行在 Azure 自动化帐户中创建的 Runbook,以测试功能。

场景:从混合辅助角色组中自动删除 Windows Azure VM

问题

当辅助角色计算机长期关闭时,看不到混合 Runbook 辅助角色或 VM。

原因

混合 Runbook 辅助角色计算机有 30 天以上无法 ping 通 Azure 自动化。 因此,自动化清除了混合 Runbook 辅助角色组或系统辅助角色组。

解决方法

启动辅助角色计算机,然后将其重新注册到 Azure 自动化。 有关如何安装 Runbook 环境和连接到 Azure 自动化的说明,请参阅部署 Windows 混合 Runbook 辅助角色。

场景:在混合 Runbook 辅助角色上的证书存储中找不到证书

问题

混合 Runbook 辅助角色上运行的 runbook 失败并显示以下错误消息:

Connect-AzAccount : No certificate was found in the certificate store with thumbprint 0000000000000000000000000000000000000000
At line:3 char:1
+ Connect-AzAccount -ServicePrincipal -Tenant $Conn.TenantID -Appl ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : CloseError: (:) [Connect-AzAccount],ArgumentException
+ FullyQualifiedErrorId : Microsoft.Azure.Commands.Profile.ConnectAzAccountCommand

原因

尝试在混合 Runbook 辅助角色上运行的 Runbook 中使用运行方式帐户时,如果运行方式帐户证书不存在,则会发生此错误。 默认情况下,混合 Runbook 辅助角色在本地没有证书资产。 运行方式帐户需要此资产才能正常运行。

解决方法

如果混合 Runbook 辅助角色是 Azure VM,则可改用使用托管标识的 Runbook 身份验证。 此方案允许使用 Azure VM 的托管标识而非运行方式帐户向 Azure 资源进行身份验证,从而简化了身份验证。 如果混合 Runbook 辅助角色是本地计算机,需要在此计算机上安装运行方式帐户证书。 若要了解如何安装证书,请参阅 在混合 Runbook 辅助角色上运行 Runbook 中有关如何运行 PowerShell Runbook Export-RunAsCertificateToHybridWorker 的步骤。

场景:在注册混合 Runbook 辅助角色期间发生错误 403

问题

辅助角色的初始注册阶段失败并出现以下错误 (403):

Forbidden: You don't have permission to access / on this server.

原因

以下问题是可能的原因:

  • 在代理设置中错误键入了工作区 ID 或工作区密钥(主密钥)。
  • 混合 Runbook 辅助角色无法下载配置,导致帐户链接错误。 当 Azure 在计算机上启用功能时,它仅支持特定的区域链接 Log Analytics 工作区和自动化帐户。 此外,还可能在计算机上设置了错误的日期或时间。 如果时间比当前时间快/慢 15 分钟,则功能部署会失败。
解决方法
错误键入了工作区 ID 或密钥

若要验证是否错误键入了代理的工作区 ID 或工作区密钥,请参阅添加或删除工作区 – Windows 代理(适用于 Windows 代理)或者添加或删除工作区 – Linux 代理(适用于 Linux 代理)。 确保从 Azure 门户中选择完整字符串,然后小心复制并粘贴该字符串。

未下载配置

Log Analytics 工作区和自动化帐户必须位于链接的区域中。 有关支持的区域列表,请参阅 Azure 自动化和 Log Analytics 工作区映射。

可能还需要更新计算机的日期或时区。 如果选择自定义时间范围,请确保该范围采用 UTC,它可能与你的本地时区不同。

方案:混合 Runbook 辅助角色上的 Set-AzStorageBlobContent 失败

问题

Runbook 在尝试执行时失败 Set-AzStorageBlobContent ,并且你收到以下错误消息:

Set-AzStorageBlobContent : Failed to open file xxxxxxxxxxxxxxxx: Illegal characters in path

原因

此错误是由调用的长文件名行为引起的, [System.IO.Path]::GetFullPath() 后者将添加 UNC 路径。

解决方法

作为一种解决方法,你可以使用以下内容创建一个名为的配置文件 OrchestratorSandbox.exe.config :

<configuration>
  <runtime>
    <AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false" />
  </runtime>
</configuration>

将此文件放在与可执行文件相同的文件夹中 OrchestratorSandbox.exe 。 例如,

%ProgramFiles%\Microsoft Monitoring Agent\Agent\AzureAutomation\7.3.702.0\HybridAgent

Note: 如果升级代理,此配置文件将被删除,并需要重新创建。

Linux

Linux 混合 Runbook 辅助角色依靠适用于 Linux 的 Log Analytics 代理与自动化帐户通信,以注册辅助角色、接收 Runbook 作业和报告状态。 如果辅助角色注册失败,以下是一些可能导致此错误的原因。

场景:Linux 混合 Runbook 辅助角色在为 Runbook 签名时收到密码提示

问题

针对 Linux 混合 Runbook 辅助角色运行 sudo 命令时检索到意外的密码提示。

原因

未在 sudoers 文件中正确配置适用于 Linux 的 Log Analytics 代理的 nxautomationuser 帐户。 需要为混合 Runbook 辅助角色适当配置帐户权限和其他数据,才能让它为 Linux Runbook 辅助角色中的 Runbook 签名。

解决方法

场景:适用于 Linux 的 Log Analytics 代理未运行

问题

适用于 Linux 的 Log Analytics 代理未运行。

原因

如果该代理未运行,会导致 Linux 混合 Runbook 辅助角色无法与 Azure 自动化通信。 该代理可能会出于各种原因而未运行。

解决方法

输入命令 ps -ef | grep python 以验证该代理是否正在运行。 应该会看到与下面类似的输出。 使用 nxautomation 用户帐户的 Python 进程。 如果未启用 Azure 自动化功能,则以下任何进程都不会运行。

nxautom+   8567      1  0 14:45 ?        00:00:00 python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/main.py /var/opt/microsoft/omsagent/state/automationworker/oms.conf rworkspace:<workspaceId> <Linux hybrid worker version>
nxautom+   8593      1  0 14:45 ?        00:00:02 python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/hybridworker.py /var/opt/microsoft/omsagent/state/automationworker/worker.conf managed rworkspace:<workspaceId> rversion:<Linux hybrid worker version>
nxautom+   8595      1  0 14:45 ?        00:00:02 python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/hybridworker.py /var/opt/microsoft/omsagent/<workspaceId>/state/automationworker/diy/worker.conf managed rworkspace:<workspaceId> rversion:<Linux hybrid worker version>

以下列表显示针对 Linux 混合 Runbook 辅助角色启动的进程。 这些进程全部位于 /var/opt/microsoft/omsagent/state/automationworker/ 目录中。

  • oms.conf:辅助角色管理器进程。 它直接从 DSC 启动。
  • worker.conf:自动注册的混合辅助角色进程。 它由辅助角色管理器启动。 此进程由更新管理使用且对用户而言是透明的。 如果未在计算机上启用更新管理,则不会显示此进程。
  • diy/worker.conf:DIY 混合辅助角色进程。 DIY 混合辅助角色进程用于执行混合 Runbook 辅助角色的用户 Runbook。 它仅与使用不同配置的自动注册混合辅助角色进程在主要细节上有所不同。 如果禁用 Azure 自动化,并且 DIY Linux 混合辅助角色未注册,则不会显示此进程。

如果该代理未运行,请运行以下命令以启动该服务:sudo /opt/microsoft/omsagent/bin/service_control restart。

场景:指定的类不存在

如果在 /var/opt/microsoft/omsconfig/omsconfig.log 中看到错误消息 The specified class does not exist..,则需要更新适用于 Linux 的 Log Analytics 代理。 运行以下命令以重新安装该代理。

wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh -w <WorkspaceID> -s <WorkspaceKey>

Windows

Windows 混合 Runbook 辅助角色依靠适用于 Windows 的 Log Analytics 代理与自动化帐户通信,以注册辅助角色、接收 Runbook 作业和报告状态。 如果辅助角色注册失败,请参考本部分所述的一些可能原因。

场景:适用于 Windows 的 Log Analytics 代理未运行。

问题

healthservice 未在混合 Runbook 辅助角色计算机上运行。

原因

如果适用于 Windows 的 Log Analytics 服务未运行,则混合 Runbook 辅助角色无法与 Azure 自动化通信。

解决方法

在 PowerShell 中输入以下命令,验证代理是否正在运行:Get-Service healthservice。 如果该服务已停止,请在 PowerShell 中输入以下命令启动该服务:Start-Service healthservice。

场景:Operations Manager 日志中出现事件 4502

问题

在 Application and Service Logs\Operations Manager 事件日志中看到事件 4502,以及包含 Microsoft.EnterpriseManagement.HealthService.AzureAutomation.HybridAgent 并附带以下说明的事件消息:The certificate presented by the service \<wsid\>.oms.opinsights.azure.com was not issued by a certificate authority used for Microsoft services. Please contact your network administrator to see if they are running a proxy that intercepts TLS/SSL communication.

原因

这可能是因为代理或网络防火墙阻止与 Microsoft Azure 通信。 验证计算机是否在端口443上有到 azure-automation.net 的出站访问权限 * 。

解决方法

日志存储在每个混合辅助角色本地的 C:\ProgramData\Microsoft\System Center\Orchestrator\7.2\SMA\Sandboxes 中。 可以在 Application and Services Logs\Microsoft-SMA\Operations 和 Application and Services Logs\Operations Manager 事件日志中验证是否出现了任何警告或错误事件。 这些日志会指出发生影响了在 Azure 自动化中启用角色的连接问题或其他类型的问题,或者在正常操作时遇到的问题。 在排查 Log Analytics 代理问题时如需更多帮助,请参阅排查 Log Analytics Windows 代理的问题。

混合辅助角色将 Runbook 输出和消息发送到 Azure 自动化,其发送方式与云中运行的 Runbook 作业发送输出和消息的方式相同。 可以像使用 Runbook 时一样启用“详细”流和“进度”流。

方案: Orchestrator.Sandbox.exe 无法通过代理连接到 Microsoft 365

问题

在 Windows 混合 Runbook 辅助角色上运行的脚本不能按预期方式连接到 Orchestrator 沙盒上的 Microsoft 365。 脚本使用 Connect-MsolService 进行连接。

即使调整 Orchestrator.Sandbox.exe.config 来设置代理和“绕过列表”,沙盒仍然无法正常连接。 包含相同代理和“绕过列表”设置的某个 Powershell_ise.exe.config 文件看起来却能按预期方式工作。 Service Management Automation (SMA) 日志和 PowerShell 日志未提供有关代理的任何信息。

原因

与服务器上的 Active Directory 联合身份验证服务 (AD FS) 建立连接不能绕过代理。 请记住,PowerShell 沙盒是以已登录用户的身份运行的。 但是,业务流程协调程序沙盒已经过大幅的自定义,可能会忽略 Orchestrator.Sandbox.exe.config 文件设置。 其中包含用于处理计算机或 Log Analytics 代理程序代理设置的特殊代码,但不包含用于处理其他自定义代理设置的代码。

解决方法

可以通过迁移脚本以使用 Azure Active Directory 模块而不是使用 PowerShell cmdlet 的 MSOnline 模块,来解决业务流程协调程序沙盒的问题。 有关详细信息,请参阅从业务流程协调程序迁移到 Azure 自动化 (Beta)。

若要继续使用 MSOnline 模块 cmdlet,请将脚本更改为使用 Invoke-Command。 指定 ComputerName 和 Credential 参数的值。

$Credential = Get-AutomationPSCredential -Name MyProxyAccessibleCredential
Invoke-Command -ComputerName $env:COMPUTERNAME -Credential $Credential 
{ Connect-MsolService … }

此项代码更改会在指定凭据的上下文中启动全新的 PowerShell 会话。 然后,流量应该可以流经对活动用户进行身份验证的代理服务器。

Note: 如果使用此解决方法,则不需要操作沙盒配置文件。 即使成功地使配置文件能够与脚本配合工作,每次更新混合 Runbook 辅助角色代理后,也仍会擦除该文件。

场景:混合 Runbook 辅助角色未提供报告

问题

混合 Runbook 辅助角色计算机在运行,但是在工作区中未看到该计算机的检测信号数据。

以下示例查询显示了工作区中的计算机及其上次检测信号:

Heartbeat
| summarize arg_max(TimeGenerated, *) by Computer
原因

此问题可能是由于混合 Runbook 辅助角色上的高速缓存损坏导致的。

解决方法

若要解决此问题,请登录到混合 Runbook 辅助角色并运行以下脚本。 此脚本将停止适用于 Windows 的 Log Analytics 代理,删除其缓存,并重启服务。 此操作会强制混合 Runbook 辅助角色从 Azure 自动化重新下载其配置。

Stop-Service -Name HealthService

Remove-Item -Path 'C:\Program Files\Microsoft Monitoring Agent\Agent\Health Service State' -Recurse

Start-Service -Name HealthService

场景:无法添加 Windows 混合 Runbook 辅助角色

问题

尝试使用 Add-HybridRunbookWorker cmdlet 添加混合 Runbook 辅助角色时收到以下消息:

Machine is already registered

原因

如果计算机已注册到一个不同的自动化帐户,或者在将混合 Runbook 辅助角色从计算机中删除后尝试重新添加它,则可能会导致此问题。

解决方法

若要解决此问题,请删除以下注册表项,重启 HealthService,然后再次尝试运行 Add-HybridRunbookWorker cmdlet。

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\HybridRunbookWorker

场景:无法添加 Linux 混合 Runbook 辅助角色

问题

尝试使用 sudo python /opt/microsoft/omsconfig/.../onboarding.py --register python 脚本添加混合 Runbook 辅助角色时收到以下消息:

Unable to register, an existing worker was found. Please deregister any existing worker and try again.

此外,尝试使用 sudo python /opt/microsoft/omsconfig/.../onboarding.py --deregister python 脚本取消注册混合 Runbook 辅助角色:

Failed to deregister worker. [response_status=404]

原因

如果计算机已注册到一个不同的自动化帐户,并且 Azure 混合辅助角色组已被删除,或者在将混合 Runbook 辅助角色从计算机中删除后尝试重新添加它,则可能会出现此问题。

解决方法

若要解决此问题,请执行下列操作:

  1. 删除代理 sudo sh onboard_agent.sh --purge。

  2. 运行以下命令:

    sudo mv -f /home/nxautomation/state/worker.conf /home/nxautomation/state/worker.conf_old
    sudo mv -f /home/nxautomation/state/worker_diy.crt /home/nxautomation/state/worker_diy.crt_old
    sudo mv -f /home/nxautomation/state/worker_diy.key /home/nxautomation/state/worker_diy.key_old
    
  3. 重新载入代理 sudo sh onboard_agent.sh -w <workspace id> -s <workspace key> -d opinsights.azure.com。

  4. 等待文件夹 /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker 填充。

  5. 重新尝试 sudo python /opt/microsoft/omsconfig/.../onboarding.py --register Python 脚本。

后续步骤

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

  • 通过 Azure 论坛获取 Azure 专家的解答。
  • 连接到 @AzureSupport,这是用于改进客户体验的官方 Microsoft Azure 帐户。 Azure 支持人员会将你连接到 Azure 社区,从中可以获得解答、支持和专家建议。
  • 提出 Azure 支持事件。 请转到 Azure 支持站点并选择“获取支持”。

历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 mgoedtel)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Azure 中文运维文档历史快照
适用范围
历史中文快照 2022-08-12;详见原文产品版本;文档日期 02/11/2021
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。