管理前置和后置维护配置事件

适用于:✔️ Windows VM ✔️ Linux VM ✔️ 本地环境 ✔️ 已启用 Azure Arc 的服务器 ✔️ Azure VM。

本文介绍了如何在 Azure 更新管理器中管理维护前和维护后事件。

管理前期事件和后期事件

查看预维护和后期维护事件

若要查看预维护和后期维护事件,请执行以下步骤:

  1. 登录到 Azure 门户,然后转到“Azure 更新管理器”

  2. “管理”下,选择“计算机”“维护配置”

  3. 在“维护配置”页上,选择要向其添加预维护和后期维护事件的维护配置

  4. 选择“概述”并检查维护事件。 可以看到与配置关联的预维护和后期维护事件计数。

    显示如何查看和配置预维护和后期维护事件的屏幕截图。

  5. 选择预维护和后期维护事件的计数以查看事件列表和事件类型。

    显示如何查看预维护和后期维护事件的屏幕截图。

编辑预维护和后期维护事件

若要编辑预维护和后期维护事件,请执行以下步骤:

  1. 按照“查看预维护和后期维护事件”中列出的步骤操作。
  2. 在所选事件页中,选择要编辑的预维护和后期维护事件。
  3. 在所选预维护和后期维护事件页中,可以编辑使用的事件处理程序/终结点或终结点的位置。

管理预维护/后期维护事件和计划运行

若要检查从事件网格将预维护和后期维护事件传送到终结点是否成功,请执行以下步骤:

  1. 登录到 Azure 门户,然后转到“Azure 更新管理器”
  2. 在“管理”下,选择“计算机”。
  3. 从顶部的功能区中选择“维护配置”。
  4. 在“维护配置”页上,选择要查看添加预维护和后期维护事件的维护配置。
  5. 在所选“维护配置”页上,在 ToC 中的“设置”下,选择“事件”
  6. 在“基本信息”部分,可以查看所选事件订阅下所有事件的指标。 在图中,“已发布事件数”指标的计数应与“匹配的事件数”指标的计数匹配。 这两个值还应与“发送的事件数”计数相对应。
  7. 要查看特定于预处理或后处理事件的指标,请从网格中选择事件的名称。 此处,“匹配的事件数”指标的计数应与“发送的事件数”计数相匹配。
  8. 若要查看事件的触发时间,请将鼠标悬停在折线图上。 了解详细信息

注意

Azure 事件网格遵循至少一次发送范例。 这意味着,在特殊情况下,可以多次为给定事件调用事件处理程序。 建议确保事件处理程序操作是幂等的。 换句话说,如果多次执行事件处理程序,则它不应有任何负面影响。 实现幂等性可确保应用程序在面对潜在的重复事件调用时的可靠性。

检查终结点是否已在预维护和后期维护事件中触发和完成

  1. 登录到 Azure 门户,转到“Azure 自动化*帐户”

  2. 在自动化帐户中的“流程自动化”下,选择“Runbook”

  3. 在事件网格中选择链接到 Webhook 的预维护和后期维护脚本。

  4. 在“概述”中,可以查看 Runbook 作业的状态。 触发时间应在计划开始时间之前大约 30 分钟。 作业完成后,可以返回到同一部分,确认状态是否为“已完成”。 例如,确保 VM 已打开或关闭。

    显示如何检查 Runbook 作业状态的屏幕截图。

    有关如何从自动化帐户的活动日志和作业状态中检索详细信息的详细信息,请参阅在 Azure 自动化中管理 Runbook

在计划开始运行之前取消该计划运行

若要取消计划运行,前期事件中的取消 API 必须在计划维护配置开始时间前至少已触发 10 分钟。 必须在前期事件(即 Runbook 脚本或 Azure 函数代码)中调用该取消 API。

若要取消计划维护运行

  1. 登录到 Azure 门户,然后转到“Azure 更新管理器”
  2. 在 ToC 中的“管理”下,选择“历史记录”。
  3. 选择“按维护运行 ID”选项卡,然后选择要查看其历史记录的维护运行 ID。
  4. 选择“取消计划更新”。 在开始维护配置之前,此选项已启用 10 分钟。

可以从以下 ARG 查询获取维护运行中的计算机列表。 还可以通过选择查看详细信息来查看相关 ID:

maintenanceresources  
| where type =~ "microsoft.maintenance/maintenanceconfigurations/applyupdates"  
| where properties.correlationId has "/subscriptions/your- subscription -id/resourcegroups/your- ResourceGroupName/providers/microsoft.maintenance/maintenanceconfigurations/mc-name/providers/microsoft.maintenance/applyupdates/"  
| order by name desc

注意

Azure 更新管理器或维护配置不会进行监视并将自动取消计划。 如果用户未能取消,计划运行将在用户定义的维护时段中继续安装更新。

计划后运行

查看预维护和后期维护事件的历史记录

  1. 登录到 Azure 门户,然后转到“Azure 更新管理器”
  2. 在“管理”下,选择“历史记录”
  3. 选择“按维护运行 ID ”选项卡,选择要查看其历史记录的维护运行 ID。
  4. 选择所选维护运行 ID 的此历史记录页中的“事件”选项卡。
  5. 可以查看事件和事件名称的计数以及事件类型和终结点详细信息。

调试预维护和后期维护事件

若要查看通过 Webhook 创建的事件的作业历史记录,请执行以下步骤:

  1. 查找要查看其作业日志的事件名称。
  2. 在“作业历史记录”列中,选择“查看与事件名称对应的 runbook 历史记录。 这会带你转到 Runbook 所在的自动化帐户。
  3. 选择与预维护和后期维护事件关联的特定 Runbook 名称。 在概述页中,可以查看 Runbook 的最新作业以及执行和状态详细信息。

查看已取消的计划运行的状态

  1. 登录到 Azure 门户,然后转到“Azure 更新管理器”
  2. 在“管理”下,选择“历史记录”
  3. 选择“按维护运行 ID ”选项卡,然后选择要查看其状态记录的维护运行 ID。
  4. 请参阅状态以查看状态。 如果已取消维护运行,则状态将显示为已取消。 选择状态以查看详细信息。

取消有两种类型:

  • 用户取消:从脚本或代码调用取消 API 时。
  • 系统取消:当系统因内部错误调用取消 API 时。 仅当系统无法在计划的补丁安装作业前 30 分钟将后期维护事件发送到客户的终结点时,才会执行此操作。 在这种情况下,由于系统运行前期事件失败,将取消即将到来的计划维护配置。

若要确认取消是否由用户或系统使用,可以从上述 ARG 查询中查看维护运行 ID 的状态,具体请参阅详细信息。 错误消息会显示用户或系统是否已取消计划运行,并在状态字段确认维护运行的状态。

显示如何查看取消状态的屏幕截图。

上图显示了用户取消的示例,其中错误消息将为“使用 YYYY-MM-DD 的取消 API 维护取消”。 如果系统因任何原因而取消维护运行,JSON 中的错误消息将为“由于 YYYY-MM-DD 内部平台故障而取消维护”

删除预维护和后期维护事件

若要删除预维护和后期维护事件,请执行以下步骤:

  1. 登录到 Azure 门户,然后转到“Azure 更新管理器”

  2. “管理”下,选择“计算机”“维护配置”

  3. 在“维护配置”页上,选择要向其添加预维护和后期维护事件的维护配置

  4. 在所选“维护配置”页上的“设置”下,选择“事件”

  5. 选择要从网格中删除的事件名称

  6. 在所选事件页上,选择“删除”

    显示如何删除预维护和后期维护事件的屏幕截图。

后续步骤

  • 有关 Azure 更新管理器中的前置和后置事件的概述,请参阅此文
  • 若要了解如何创建预维护和后期维护事件,请参阅预维护和后期维护配置事件
  • 若要了解如何使用预维护和后期维护事件来通过 Webhook 打开和关闭 VM,请参阅此处
  • 若要了解如何使用预维护和后期维护事件来通过 Azure Functions 打开和关闭 VM,请参阅此处