你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure 更新管理器中的查询日志概述
从更新评估和安装等操作创建的日志由 Azure 更新管理器存储在 Azure Resource Graph 中。 Resource Graph 是 Azure 中的一项服务，旨在成为 Azure 服务详细信息的存储区，无需任何成本或部署要求。 更新管理器使用 Resource Graph 来存储其结果。 可以查看资源过去 30 天的更新历史记录。
本文介绍更新管理器中的日志结构，以及如何使用 Azure Resource Graph 资源管理器 来分析日志，以支持报表、可视化和导出需求。
日志结构
更新管理器将其所有操作的结果作为日志发送到 Azure Resource Graph，这些日志可用于 30 天。 下面列出了要发送到 Azure Resource Graph 的日志的结构。
修补程序评估结果
表 patchassessmentresources 包含与计算机修补程序评估相关的资源。 下表描述了该评估的属性。
| properties | 说明 |
|---|---|
ID |
转发结果的 Azure 资源管理器 ID。 它类似于来宾 OS 评估的 REST API 路径。 通常为 <resourcePath>/patchAssessmentResults/latest 或 <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>. |
NAME |
如果 ID 为类型 <resourcePath>/patchAssessmentResults/latest，则记录包含完成评估操作的唯一 GUID。 如果 <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>，则记录包含更新名称或标签。 |
TYPE |
指定评估的日志类型。 如果类型为 patchassessmentresults，则记录会提供具有数字聚合统计信息的 OS 评估摘要。 如果类型为 patchassessmentresults/softwarepatches，则记录描述可用于资源的特定 OS 更新。 |
TENANTID |
已启用 Azure VM 或已启用 Azure Arc 的服务器资源的 Azure 租户 ID。 |
KIND |
特意留空以备将来使用。 |
LOCATION |
Azure VM 或已启用 Azure Arc 的服务器资源的 Azure 云区域。 |
RESOURCEGROUP |
托管 Azure VM 或已启用 Azure Arc 的服务器资源的 Azure 资源组。 |
SUBSCRIPTIONID |
Azure VM 或已启用 Azure Arc 的服务器资源的 Azure 订阅 ID。 |
MANAGEDBY |
特意留空以备将来使用。 |
SKU |
特意留空以备将来使用。 |
PLAN |
特意留空以备将来使用。 |
PROPERTIES |
捕获操作的详细信息（JSON 格式）。 有关详细信息，请参阅此表。 |
TAGS |
为已启用 Azure VM 或已启用 Azure Arc 的服务器资源定义的 Azure 标记。 |
IDENTITY |
特意留空以备将来使用。 |
ZONES |
特意留空以备将来使用。 |
EXTENDEDLOCATION |
特意留空以备将来使用。 |
patchassessmentresources 属性的说明
如果资源类型的属性为 patchassessmentresources，则它包括下表中的信息。
| 值 | 说明 |
|---|---|
rebootPending |
用于指定特定更新是否需要操作系统重新启动才能完成安装的标志。 由计算机的 OS 更新服务或包管理器提供。 如果 OS 包管理器或更新服务不需要重启，则该字段的值将设置为 false。 |
patchServiceUsed |
计算机上用于安装更新的 OS 服务。 WU-WSUS用于 Windows 更新 服务或 Windows Server 更新服务。 对于 Linux，值为 OS 包管理器，例如 YUM、APT 或 Zypper。 |
osType |
表示操作系统的类型： Windows 或 Linux。 |
startDateTime |
表示 OS 更新评估任务在计算机上开始执行的时间戳 (UTC)。 |
lastModifiedDateTime |
表示上次更新记录的时间戳 (UTC)。 |
startedBy |
标识用户或 Azure 服务是否触发了 OS 更新安装。 有关操作的详细信息，请参阅 Azure 活动日志。 |
errorDetails |
从计算机的 OS 包管理器或更新服务执行更新安装时生成的前五条错误消息。 |
availablePatchCountByClassification |
根据特定更新所属的类别根据 OS 供应商进行的 OS 更新数。 计算机的 OS 更新服务或包管理器生成信息。 如果 OS 包管理器或更新服务未提供类别的详细信息，则该值为 Others （适用于 Linux）或 Updates （对于 Windows Server）。 |
如果资源类型的属性为 patchassessmentresults/softwarepatches，则它包括下表中的信息。
| 值 | 说明 |
|---|---|
lastModifiedDateTime |
表示上次更新记录的时间戳 (UTC)。 |
publishedDateTime |
表示 OS 供应商何时提供特定更新的时间戳。 计算机的 OS 更新服务或包管理器生成信息。 如果 OS 包管理器或更新服务未提供 OS 供应商提供更新时间的详细信息，则值为 null。 |
classifications |
特定更新属于 OS 供应商的类别。 计算机的 OS 更新服务或包管理器生成信息。 如果 OS 包管理器或更新服务未提供类别的详细信息，则该值为 Others （适用于 Linux）或 Updates （对于 Windows Server）。 |
rebootRequired |
值指示特定更新是否需要 OS 重新启动才能完成安装。 计算机的 OS 更新服务或包管理器生成信息。 如果 OS 包管理器或更新服务不需要重新启动，则值为 false。 |
rebootBehavior |
如果更新管理器可以重新启动目标计算机，则 OS 更新安装中设置的行为会在配置更新部署时运行作业。 |
patchName |
计算机的 OS 包管理器或更新服务为特定更新生成的名称或标签。 |
Kbid |
如果计算机的 OS 为 Windows Server，则值将包含 Windows 更新服务提供的更新的唯一 KB ID。 |
version |
如果计算机的 OS 是 Linux，则该值包括 Linux 包管理器提供的更新的版本详细信息。 例如 1.0.1.el7.3。 |
修补程序安装结果
表 patchinstallationresources 包含与计算机修补程序评估相关的资源。 下表描述了该评估的属性。
| properties | 说明 |
|---|---|
ID |
转发结果的 Azure 资源管理器 ID。 它类似于来宾 OS 评估的 REST API 路径。 通常为 <resourcePath>/patchInstallationResults/<GUID> 或 <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>. |
NAME |
如果 ID 为类型 <resourcePath>/patchInstallationResults，则记录包含完成更新操作的唯一 GUID。 如果 <resourcePath>/patchInstallationResults/softwarePatches/<update>，则记录包含计算机上安装的更新名称或标签。 |
TYPE |
指定评估的日志类型。 如果类型为 patchinstallationresults，则记录将提供 OS 安装摘要和数字聚合统计信息。 如果类型为 patchinstallationresults/softwarepatches，则记录将描述可为资源安装的特定 OS 更新。 |
TENANTID |
已启用 Azure VM 或已启用 Azure Arc 的服务器资源的 Azure 租户 ID。 |
KIND |
特意留空以备将来使用。 |
LOCATION |
Azure VM 或已启用 Azure Arc 的服务器资源的 Azure 云区域。 |
RESOURCEGROUP |
托管 Azure VM 或已启用 Azure Arc 的服务器资源的 Azure 资源组。 |
SUBSCRIPTIONID |
Azure VM 或已启用 Azure Arc 的服务器资源的 Azure 订阅 ID。 |
MANAGEDBY |
特意留空以备将来使用。 |
SKU |
特意留空以备将来使用。 |
PLAN |
特意留空以备将来使用。 |
PROPERTIES |
捕获操作的详细信息（JSON 格式）。 有关详细信息，请参阅此表。 |
TAGS |
为已启用 Azure VM 或已启用 Azure Arc 的服务器资源定义的 Azure 标记。 |
IDENTITY |
特意留空以备将来使用。 |
ZONES |
特意留空以备将来使用。 |
EXTENDEDLOCATION |
特意留空以备将来使用。 |
patchinstallationresults 属性的说明
如果资源类型的属性为 patchinstallationresults，则它包括下表中的信息。
| 值 | 说明 |
|---|---|
installationActivityId |
OS 更新安装运行的唯一 GUID。 |
maintenanceWindowExceeded |
如果更新安装运行超过定义的维护时段，则值为 True 或 False。 |
lastModifiedDateTime |
表示上次更新记录的时间戳 (UTC)。 |
notSelectedPatchCount |
未选择在更新部署中安装的但在计算机上可用的 OS 更新数。 |
installedPatchCount |
已在更新部署中指定的且已成功安装的 OS 更新数。 |
excludedPatchCount |
已排除在更新部署中安装的但在计算机上可用的 OS 更新数。 |
pendingPatchCount |
已在更新部署中指定的、仍在等待安装的 OS 更新数。 |
patchServiceUsed |
计算机上用于安装更新的 OS 服务。 WU-WSUS用于 Windows 更新 服务或 Windows Server 更新服务。 对于 Linux，值为 OS 包管理器，例如 YUM、APT 或 Zypper。 |
failedPatchCount |
已在更新部署中指定的但无法成功安装的 OS 更新数。 |
startDateTime |
表示 OS 更新安装任务在计算机上开始执行的时间戳 (UTC)。 |
rebootStatus |
如果需要重启 OS 以完成更新安装，则 OS 更新服务或包管理器中的信息。 状态值为 NotNeeded （无需重启）、 Required （完成需要 OS 重启）、 Started （重新启动已启动）、 Failed （OS 无法重启），以及 Completed （已成功重启）。 |
startedBy |
标识用户或 Azure 服务是否触发了 OS 更新安装。 有关操作的详细信息，请参阅 Azure 活动日志。 |
status |
OS 更新安装运行的状态。 值可以是 NotStarted、 InProgress、 Failed、 Succeeded和 CompletedWithWarnings。 如果一个或多个 OS 更新安装未成功，则更新安装运行被视为 Failed 状态。 |
osType |
表示操作系统的类型： Windows 或 Linux。 |
errorDetails |
包括从计算机的 OS 包管理器或更新服务运行更新安装时生成的前五条错误消息。 |
maintenanceRunId |
此值用作自动 VM 来宾修补或计划运行 ID 的维护运行标识符，而不是定期更新。 |
如果资源类型的属性为 patchinstallationresults/softwarepatches，则它包括下表中的信息。
| 值 | 说明 |
|---|---|
installationState |
特定 OS 更新的安装状态。 值为 Installed、Failed、Pending、NotSelected 和 Excluded。 |
lastModifiedDateTime |
表示上次更新记录的时间戳 (UTC)。 |
publishedDateTime |
表示 OS 供应商何时提供特定更新的时间戳。 计算机的 OS 更新服务或包管理器生成信息。 如果 OS 包管理器或更新服务未提供 OS 供应商提供更新时间的详细信息，则值为 null。 |
classifications |
特定更新根据计算机的 OS 更新服务或包管理器提供的 OS 供应商所属的类别。 如果 OS 包管理器或更新服务未提供类别的详细信息，则字段的值为 Others （适用于 Linux）和 Updates （对于 Windows Server）。 |
rebootRequired |
用于指定特定更新是否需要操作系统重新启动才能完成安装（由计算机的 OS 更新服务或包管理器提供）的标志。 如果 OS 包管理器或更新服务未提供有关需要重启 OS 的信息，则字段的值将设置为 false。 |
rebootBehavior |
OS 更新安装中设置的行为按用户运行作业，以允许更新管理器重新启动 OS。 |
patchName |
计算机 OS 包管理器或更新服务提供的特定更新的名称或标签。 |
Kbid |
如果计算机的 OS 为 Windows Server，则值将包含 Windows 更新服务提供的更新的唯一 KB ID。 |
version |
如果计算机的 OS 是 Linux，则该值包括 Linux 包管理器提供的更新的版本详细信息。 例如 1.0.1.el7.3。 |
维护资源
表 maintenanceresources 包含与维护配置相关的资源。 下表描述了该评估的属性。
| properties | 说明 |
|---|---|
ID |
转发结果的 Azure 资源管理器 ID。 它类似于 用于创建维护配置的 REST API 路径。 |
NAME |
如果 ID 为类型 <resourcePath>/applyupdates，则记录包含维护运行的唯一 GUID。 如果 <resourcePath>/configurationassignments，则记录包含将维护配置分配给 Azure 或 Azure Arc VM。 |
TYPE |
指定评估的日志类型。 如果类型为 applyupdates，则记录提供计算机级别的维护运行记录的详细信息。 如果类型为 configurationassignments，则记录描述 Azure VM 或 Azure Arc VM 与维护配置之间的链接。 |
TENANTID |
已启用 Azure VM 或已启用 Azure Arc 的服务器资源的 Azure 租户 ID。 |
KIND |
特意留空以备将来使用。 |
LOCATION |
Azure VM 或已启用 Azure Arc 的服务器资源的纯云区域存在。 |
RESOURCEGROUP |
托管 Azure VM 或已启用 Azure Arc 的服务器资源的 Azure 资源组。 |
SUBSCRIPTIONID |
Azure VM 或已启用 Azure Arc 的服务器资源的 Azure 订阅 ID。 |
MANAGEDBY |
特意留空以备将来使用。 |
SKU |
特意留空以备将来使用。 |
PLAN |
特意留空以备将来使用。 |
PROPERTIES |
捕获操作的详细信息（JSON 格式）。 有关详细信息，请参阅此表。 |
TAGS |
为已启用 Azure VM 或已启用 Azure Arc 的服务器资源定义的 Azure 标记。 |
IDENTITY |
特意留空以备将来使用。 |
ZONES |
特意留空以备将来使用。 |
EXTENDEDLOCATION |
特意留空以备将来使用。 |
applyupdates 属性的说明
如果资源类型的属性为 applyupdates，则它包括下表中的信息。
| 值 | 说明 |
|---|---|
maintenanceConfigurationId |
应用的维护配置的 Azure 资源管理器 ID。 |
maintenanceScope |
已应用的维护配置的维护范围。 |
resourceId |
Azure 资源管理器 ARC/Azure VM 的模板资源 ID。 |
correlationId |
计划维护/计划运行的运行 ID。 此信息可用于查找属于同一计划的所有 VM。 |
startDateTime |
计划的开始日期和时间。 |
endDateTime |
计划的结束日期和时间。 |
如果资源类型的属性为 configurationassignments，则它包括下表中的信息。
| 值 | 说明 |
|---|---|
resourceId |
ARC/Azure VM 的 Azure 资源管理器资源 ID |
maintenanceConfigurationId |
应用的维护配置的 Azure 资源管理器 ID |