Azure Update Manager 中的查詢記錄概觀
從更新評量和安裝等作業建立的記錄會由 Azure Update Manager 儲存在 Azure Resource Graph 中 。 Resource Graph 是 Azure 中的服務,其設計目的是要成為 Azure 服務詳細資料的存放區,而不需要任何成本或部署需求。 Update Manager 會使用 Resource Graph 來儲存其結果。 您可以從資源檢視過去 30 天的更新歷程記錄。
本文說明來自更新管理員的記錄結構,以及如何使用 Azure Resource Graph 總 管來分析它們,以支援您的報告、視覺化和匯出需求。
記錄結構
更新管理員會將其所有作業的結果傳送至 Azure Resource Graph 作為記錄,記錄可供 30 天使用。 這裡列出要傳送至 Azure Resource Graph 的記錄結構。
修補程式評估結果
此資料表 patchassessmentresources
包含與電腦修補程式評估相關的資源。 下表描述其屬性。
屬性 | 說明 |
---|---|
ID |
Azure Resource Manager 識別碼轉送結果。 這類似于 客體 OS 評量的 REST API 路徑。 通常為 <resourcePath>/patchAssessmentResults/latest 或 <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update> 。 |
NAME |
如果識別碼的類型為 <resourcePath>/patchAssessmentResults/latest ,則記錄會包含評估作業完成的唯一 GUID。 如果 <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update> 為 ,則記錄會包含更新名稱或標籤。 |
TYPE |
指定評估的記錄類型。 如果類型為 patchassessmentresults ,則記錄會提供具有數值匯總統計資料的 OS 評量摘要。 如果類型為 patchassessmentresults/softwarepatches ,則記錄會描述資源可用的特定 OS 更新。 |
TENANTID |
Azure VM 或已啟用 Azure Arc 的伺服器資源的 Azure 租使用者識別碼。 |
KIND |
刻意保留空白以供日後使用。 |
LOCATION |
Azure VM 或已啟用 Azure Arc 的伺服器資源所在的 Azure 雲端區域。 |
RESOURCEGROUP |
裝載 Azure VM 或已啟用 Azure Arc 的伺服器資源的 Azure 資源群組。 |
SUBSCRIPTIONID |
Azure VM 或已啟用 Azure Arc 的伺服器資源的 Azure 訂用帳戶識別碼。 |
MANAGEDBY |
刻意保留空白以供日後使用。 |
SKU |
刻意保留空白以供日後使用。 |
PLAN |
刻意保留空白以供日後使用。 |
PROPERTIES |
擷取 JSON 格式作業的詳細資料。 如需詳細資訊,請遵循此資料表。 |
TAGS |
針對 Azure VM 或已啟用 Azure Arc 的伺服器資源定義的 Azure 標籤。 |
IDENTITY |
刻意保留空白以供日後使用。 |
ZONES |
刻意保留空白以供日後使用。 |
EXTENDEDLOCATION |
刻意保留空白以供日後使用。 |
patchassessmentresources 屬性的描述
如果資源類型的 屬性是 patchassessmentresources
,它就會包含下表中的資訊。
值 | Description |
---|---|
rebootPending |
旗標,指定特定更新是否需要作業系統重新開機才能完成安裝。 如機器的 OS 更新服務或套件管理員所提供。 如果您的 OS 套件管理員或更新服務不需要重新開機,欄位的值會設定為 false 。 |
patchServiceUsed |
電腦上用來安裝更新的 OS 服務。 WU-WSUS 適用于 Windows Update 服務或 Windows Server Update Service。 針對 Linux,它是 OS 套件管理員,例如 YUM 、 APT 或 Zypper 。 |
osType |
表示作業系統的類型: Windows 或 Linux 。 |
startDateTime |
時間戳記 (UTC)表示作業系統更新評估工作在機器上開始執行時。 |
lastModifiedDateTime |
時間戳記 (UTC) 表示上次更新記錄的時間。 |
startedBy |
識別使用者或 Azure 服務是否觸發作業系統更新安裝。 如需作業的詳細資訊,請參閱 Azure 活動記錄 。 |
errorDetails |
從電腦的 OS 套件管理員或更新服務執行更新安裝時產生的前五個錯誤訊息。 |
availablePatchCountByClassification |
依特定更新所屬類別的 OS 更新數目,以 OS 廠商為基礎。 電腦的 OS 更新服務或套件管理員會產生資訊。 如果 OS 套件管理員或更新服務未提供類別的詳細資料,則此值為 Others (適用于 Linux) 或 Updates (適用于 Windows Server)。 |
如果資源類型的 屬性是 patchassessmentresults/softwarepatches
,它就會包含下表中的資訊。
值 | Description |
---|---|
lastModifiedDateTime |
時間戳記 (UTC) 表示上次更新記錄的時間。 |
publishedDateTime |
時間戳記,表示 OS 廠商提供特定更新的時機。 電腦的 OS 更新服務或套件管理員會產生資訊。 如果您的 OS 套件管理員或更新服務未提供 OS 廠商提供更新時的詳細資料,則值為 null。 |
classifications |
特定更新根據 OS 廠商所屬的類別。 電腦的 OS 更新服務或套件管理員會產生資訊。 如果您的 OS 套件管理員或更新服務未提供類別的詳細資料,則此值為 Others (適用于 Linux) 或 Updates (適用于 Windows Server)。 |
rebootRequired |
值指出特定更新是否需要作業系統重新開機才能完成安裝。 電腦的 OS 更新服務或套件管理員會產生資訊。 如果您的 OS 套件管理員或更新服務不需要重新開機,則值為 false 。 |
rebootBehavior |
如果 Update Manager 可以重新開機目的電腦,則作業系統更新安裝中設定的行為會在設定更新部署時執行作業。 |
patchName |
電腦 OS 套件管理員或更新服務所產生的特定更新名稱或標籤。 |
Kbid |
如果電腦的 OS 是 Windows Server,則值會包含 Windows Update 服務所提供更新的唯一 KB 識別碼。 |
version |
如果電腦的 OS 是 Linux,此值會包含 Linux 套件管理員所提供的更新版本詳細資料。 例如: 1.0.1.el7.3 。 |
修補程式安裝結果
此資料表 patchinstallationresources
包含與電腦修補程式評估相關的資源。 下表描述其屬性。
屬性 | 說明 |
---|---|
ID |
Azure Resource Manager 識別碼轉送結果。 這類似于 客體 OS 評量的 REST API 路徑。 通常為 <resourcePath>/patchInstallationResults/<GUID> 或 <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update> 。 |
NAME |
如果識別碼的類型為 <resourcePath>/patchInstallationResults ,則記錄會包含完成更新作業的唯一 GUID。 如果 <resourcePath>/patchInstallationResults/softwarePatches/<update> 為 ,則記錄會包含電腦上安裝的更新名稱或標籤。 |
TYPE |
指定評估的記錄類型。 如果類型為 patchinstallationresults ,則記錄會提供具有數值匯總統計資料的 OS 安裝摘要。 如果類型為 patchinstallationresults/softwarepatches ,則記錄會描述為資源所安裝的特定 OS 更新。 |
TENANTID |
Azure VM 或已啟用 Azure Arc 的伺服器資源的 Azure 租使用者識別碼。 |
KIND |
刻意保留空白以供日後使用。 |
LOCATION |
Azure VM 或已啟用 Azure Arc 的伺服器資源所在的 Azure 雲端區域。 |
RESOURCEGROUP |
裝載 Azure VM 或已啟用 Azure Arc 的伺服器資源的 Azure 資源群組。 |
SUBSCRIPTIONID |
Azure VM 或已啟用 Azure Arc 的伺服器資源的 Azure 訂用帳戶識別碼。 |
MANAGEDBY |
刻意保留空白以供日後使用。 |
SKU |
刻意保留空白以供日後使用。 |
PLAN |
刻意保留空白以供日後使用。 |
PROPERTIES |
擷取 JSON 格式作業的詳細資料。 如需詳細資訊,請遵循此資料表。 |
TAGS |
針對 Azure VM 或已啟用 Azure Arc 的伺服器資源定義的 Azure 標籤。 |
IDENTITY |
刻意保留空白以供日後使用。 |
ZONES |
刻意保留空白以供日後使用。 |
EXTENDEDLOCATION |
刻意保留空白以供日後使用。 |
patchinstallationresults 屬性的描述
如果資源類型的 屬性是 patchinstallationresults
,它就會包含下表中的資訊。
值 | Description |
---|---|
installationActivityId |
作業系統更新安裝執行的唯一 GUID。 |
maintenanceWindowExceeded |
值是 True ,如果更新安裝執行超過定義的維護期間,則為 或 False 。 |
lastModifiedDateTime |
時間戳記 (UTC) 表示上次更新記錄的時間。 |
notSelectedPatchCount |
未在更新部署中選取要安裝之電腦上可用的 OS 更新數目。 |
installedPatchCount |
已成功安裝于更新部署中指定的作業系統更新數目。 |
excludedPatchCount |
電腦上可用的 OS 更新數目,並排除在更新部署中安裝。 |
pendingPatchCount |
仍在等待在更新部署中指定的作業系統更新數目。 |
patchServiceUsed |
電腦上用來安裝更新的 OS 服務。 WU-WSUS 適用于 Windows Update 服務或 Windows Server Update Service。 針對 Linux,它是 OS 套件管理員,例如 YUM 、 APT 或 Zypper 。 |
failedPatchCount |
無法順利安裝于更新部署中指定的作業系統更新數目。 |
startDateTime |
時間戳記 (UTC)表示作業系統更新安裝工作在機器上開始執行時。 |
rebootStatus |
如果作業系統需要重新開機才能完成更新安裝,則來自 OS 更新服務或套件管理員的資訊。 狀態值是 NotNeeded (不需要重新開機)、 Required (需要重新開機才能完成)、 Started (已起始重新開機)、 Failed (無法重新開機 OS),以及 Completed (已成功重新開機)。 |
startedBy |
識別使用者或 Azure 服務是否觸發作業系統更新安裝。 如需作業的詳細資訊,請參閱 Azure 活動記錄 。 |
status |
作業系統更新安裝執行的狀態。 值可以是 NotStarted 、 InProgress 、 Failed 、 Succeeded 、 和 CompletedWithWarnings 。 如果一或多個作業系統更新安裝失敗,則更新安裝執行會被視為 Failed 狀態。 |
osType |
表示作業系統的類型: Windows 或 Linux 。 |
errorDetails |
包含從電腦的 OS 套件管理員或更新服務執行更新安裝時所產生的前五個錯誤訊息。 |
maintenanceRunId |
此值會作為自動 VM 客體修補或排程執行識別碼的維護執行識別碼,而不是週期性更新。 |
如果資源類型的 屬性是 patchinstallationresults/softwarepatches
,它就會包含下表中的資訊。
值 | Description |
---|---|
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。 |
patchName |
電腦作業系統套件管理員或更新服務所提供的特定更新名稱或標籤。 |
Kbid |
如果電腦的 OS 是 Windows Server,則值會包含 Windows Update 服務所提供更新的唯一 KB 識別碼。 |
version |
如果電腦的 OS 是 Linux,此值會包含 Linux 套件管理員所提供的更新版本詳細資料。 例如: 1.0.1.el7.3 。 |
維護資源
資料表 maintenanceresources
包含與維護組態相關的資源。 下表描述其屬性。
屬性 | 說明 |
---|---|
ID |
Azure Resource Manager 識別碼轉送結果。 它類似于建立維護設定的 REST API 路徑。 |
NAME |
如果識別碼的類型為 <resourcePath>/applyupdates ,則記錄會包含維護執行的唯一 GUID。 如果 <resourcePath>/configurationassignments 為 ,則記錄會包含將維護組態指派給 Azure 或 Azure Arc VM。 |
TYPE |
指定評估的記錄類型。 如果類型為 applyupdates ,則記錄會提供機器層級維護執行記錄的詳細資料。 如果類型為 configurationassignments ,則記錄會描述 Azure VM 或 Azure Arc VM 與維護設定之間的連結。 |
TENANTID |
Azure VM 或已啟用 Azure Arc 的伺服器資源的 Azure 租使用者識別碼。 |
KIND |
刻意保留空白以供日後使用。 |
LOCATION |
Azure VM 或已啟用 Azure Arc 的伺服器資源所在的純雲端區域。 |
RESOURCEGROUP |
裝載 Azure VM 或已啟用 Azure Arc 的伺服器資源的 Azure 資源群組。 |
SUBSCRIPTIONID |
Azure VM 或已啟用 Azure Arc 的伺服器資源的 Azure 訂用帳戶識別碼。 |
MANAGEDBY |
刻意保留空白以供日後使用。 |
SKU |
刻意保留空白以供日後使用。 |
PLAN |
刻意保留空白以供日後使用。 |
PROPERTIES |
擷取 JSON 格式作業的詳細資料。 如需詳細資訊,請遵循此資料表。 |
TAGS |
針對 Azure VM 或已啟用 Azure Arc 的伺服器資源定義的 Azure 標籤。 |
IDENTITY |
刻意保留空白以供日後使用。 |
ZONES |
刻意保留空白以供日後使用。 |
EXTENDEDLOCATION |
刻意保留空白以供日後使用。 |
applyupdates 屬性的描述
如果資源類型的 屬性是 applyupdates
,它就會包含下表中的資訊。
值 | Description |
---|---|
maintenanceConfigurationId |
已套用維護組態的 Azure Resource Manager 識別碼。 |
maintenanceScope |
套用維護組態的維護範圍。 |
resourceId |
ARC/Azure VM 的 Azure Resource Manager 範本資源識別碼。 |
correlationId |
排程維護/排程執行的執行識別碼。 此資訊可用來尋找屬於相同排程的所有 VM。 |
startDateTime |
排程的開始日期和時間。 |
endDateTime |
排程的結束日期和時間。 |
如果資源類型的 屬性是 configurationassignments
,它就會包含下表中的資訊。
值 | Description |
---|---|
resourceId |
ARC/Azure VM 的 Azure Resource Manager 資源識別碼 |
maintenanceConfigurationId |
套用維護組態的 Azure Resource Manager 識別碼 |
下一步
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應