Mengakses data operasi Azure Update Manager menggunakan Azure Resource Graph
Log yang dibuat dari operasi seperti penilaian pembaruan dan penginstalan disimpan oleh Azure Update Manager di Azure Resource Graph. Resource Graph adalah layanan di Azure yang dirancang menjadi penyimpanan untuk detail layanan Azure tanpa persyaratan biaya atau penyebaran apa pun. Manajer Pembaruan menggunakan Resource Graph untuk menyimpan hasilnya. Anda dapat melihat riwayat penilaian pembaruan terbaru selama 7 hari terakhir dan memperbarui riwayat penginstalan selama 30 hari terakhir dari Resource Graph.
Artikel ini menjelaskan struktur log dari Update Manager dan bagaimana Anda dapat menggunakan Azure Resource Graph Explorer untuk menganalisisnya guna mendukung kebutuhan pelaporan, visualisasi, dan ekspor Anda.
Struktur log
Manajer Pembaruan mengirimkan hasil semua operasinya ke Azure Resource Graph sebagai log, yang tersedia selama 30 hari. Tercantum di sini adalah struktur log yang dikirim ke Azure Resource Graph.
Hasil penilaian patch
Tabel patchassessmentresources ini mencakup sumber daya yang terkait dengan penilaian patch mesin. Tabel berikut menjelaskan propertinya.
| Properti | Deskripsi |
|---|---|
ID |
ID Azure Resource Manager meneruskan hasilnya. Ini mirip dengan jalur REST API untuk penilaian OS Tamu. Biasanya, <resourcePath>/patchAssessmentResults/latest atau <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>. |
NAME |
Jika ID berjenis <resourcePath>/patchAssessmentResults/latest, maka rekaman berisi GUID unik untuk operasi penilaian selesai. Jika <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>, maka rekaman berisi nama atau label pembaruan. |
TYPE |
Menentukan jenis log untuk penilaian. Jika jenisnya adalah patchassessmentresults, maka catatan menyediakan ringkasan penilaian OS dengan statistik agregat numerik. Jika jenisnya adalah patchassessmentresults/softwarepatches, maka catatan menjelaskan pembaruan OS tertentu yang tersedia untuk sumber daya. |
TENANTID |
ID penyewa Azure untuk sumber daya server yang didukung Azure Arc atau VM Azure. |
KIND |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
LOCATION |
Region cloud Azure tempat sumber daya server yang didukung Azure Arc atau VM Azure berada. |
RESOURCEGROUP |
Grup sumber daya Azure yang menghosting sumber daya server yang didukung Azure Arc atau VM Azure. |
SUBSCRIPTIONID |
ID langganan Azure untuk sumber daya server yang didukung Azure Arc atau VM Azure. |
MANAGEDBY |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
SKU |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
PLAN |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
PROPERTIES |
Mengambil detail operasi dalam format JSON. Informasi selengkapnya mengikuti tabel ini. |
TAGS |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
IDENTITY |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
ZONES |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
EXTENDEDLOCATION |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
Deskripsi properti patchassessmentResults
Jika properti untuk jenis sumber daya adalah patchassessmentresults, properti menyertakan informasi dalam tabel berikut.
| Nilai | Deskripsi |
|---|---|
rebootPending |
Bendera untuk menentukan apakah pembaruan tertentu mengharuskan OS untuk memulai ulang guna menyelesaikan penginstalan. Seperti yang disediakan oleh layanan pembaruan komputer atau manajer paket OS. Jika manajer paket OS atau layanan pembaruan Anda tidak memerlukan boot ulang, nilai bidang diatur ke false. |
patchServiceUsed |
Layanan OS yang digunakan pada komputer untuk menginstal pembaruan. WU-WSUS untuk layanan Windows Update atau Windows Server Update Service. Untuk Linux, ini adalah manajer paket OS seperti YUM, , APTatau Zypper. |
osType |
Mewakili jenis sistem operasi: Windows atau Linux. |
startDateTime |
Stempel waktu (UTC) yang mewakili kapan tugas penilaian pembaruan OS memulai eksekusi pada komputer. |
lastModifiedDateTime |
Stempel waktu (UTC) yang mewakili kapan catatan terakhir diperbarui. |
startedBy |
Mengidentifikasi apakah pengguna atau layanan Azure memicu penginstalan pembaruan OS. Untuk informasi selengkapnya tentang operasi ini, lihat Log aktivitas Azure. |
errorDetails |
Lima pesan kesalahan pertama yang dihasilkan saat menjalankan penginstalan pembaruan dari manajer paket OS mesin atau layanan pembaruan. |
availablePatchCountByClassification |
Jumlah pembaruan OS berdasarkan kategori tempat pembaruan tertentu yang didasarkan pada vendor OS. Layanan pembaruan atau manajer paket OS komputer menghasilkan informasi tersebut. Jika manajer paket OS atau layanan pembaruan tidak memberikan detail kategori, nilainya adalah Others (untuk Linux) atau Updates (untuk Windows Server). |
Jika properti untuk jenis sumber daya adalah patchassessmentresults/softwarepatches, properti menyertakan informasi dalam tabel berikut.
| Nilai | Deskripsi |
|---|---|
lastModifiedDateTime |
Stempel waktu (UTC) yang mewakili kapan catatan terakhir diperbarui. |
publishedDateTime |
Stempel waktu yang mewakili kapan pembaruan tertentu disediakan oleh vendor OS. Layanan pembaruan atau manajer paket OS komputer menghasilkan informasi tersebut. Jika manajer paket atau layanan pembaruan OS Anda tidak memberikan detail mengenai kapan pembaruan disediakan oleh vendor OS, nilainya adalah null. Saat ini nilai ini tidak tersedia dalam hal pembaruan Linux. |
classifications |
Kategori yang dimiliki pembaruan tertentu sesuai dengan vendor OS. Layanan pembaruan atau manajer paket OS komputer menghasilkan informasi tersebut. Jika manajer paket OS atau layanan pembaruan Anda tidak memberikan detail kategori, nilainya adalah Others (untuk Linux) atau Updates (untuk Windows Server). |
rebootRequired |
Nilai yang menunjukkan apakah pembaruan tertentu mengharuskan OS untuk memulai ulang guna menyelesaikan penginstalan. Layanan pembaruan atau manajer paket OS komputer menghasilkan informasi tersebut. Jika manajer paket OS atau layanan pembaruan Anda tidak memerlukan boot ulang, nilainya adalah false. |
rebootBehavior |
Perilaku yang diatur dalam penginstalan pembaruan OS menjalankan tugas saat mengonfigurasi penyebaran pembaruan jika Manajer Pembaruan dapat mem-boot ulang komputer target. |
patchName |
Nama atau label untuk pembaruan tertentu yang dihasilkan oleh manajer paket atau layanan pembaruan OS komputer. |
Kbid |
Jika OS komputer adalah Windows Server, nilainya menyertakan ID KB unik untuk pembaruan yang disediakan oleh layanan Windows Update. |
version |
Jika OS komputer adalah Linux, nilainya menyertakan detail versi untuk pembaruan seperti yang disediakan oleh manajer paket Linux. Contohnya,1.0.1.el7.3. |
Hasil penginstalan patch
Tabel patchinstallationresources ini mencakup sumber daya yang terkait dengan penilaian patch mesin. Tabel berikut menjelaskan propertinya.
| Properti | Deskripsi |
|---|---|
ID |
ID Azure Resource Manager meneruskan hasilnya. Ini mirip dengan jalur REST API untuk penilaian OS Tamu. Biasanya, <resourcePath>/patchInstallationResults/<GUID> atau <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>. |
NAME |
Jika ID berjenis <resourcePath>/patchInstallationResults, rekaman berisi GUID unik untuk operasi pembaruan selesai. Jika <resourcePath>/patchInstallationResults/softwarePatches/<update>, maka rekaman berisi nama pembaruan atau label yang diinstal pada komputer. |
TYPE |
Menentukan jenis log untuk penilaian. Jika jenisnya adalah patchinstallationresults, maka catatan menyediakan ringkasan penginstalan OS dengan statistik agregat numerik. Jika jenis adalah patchinstallationresults/softwarepatches, maka catatan menjelaskan pembaruan OS tertentu yang diinstal untuk sumber daya. |
TENANTID |
ID penyewa Azure untuk sumber daya server yang didukung Azure Arc atau VM Azure. |
KIND |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
LOCATION |
Region cloud Azure tempat sumber daya server yang didukung Azure Arc atau VM Azure berada. |
RESOURCEGROUP |
Grup sumber daya Azure yang menghosting sumber daya server yang didukung Azure Arc atau VM Azure. |
SUBSCRIPTIONID |
ID langganan Azure untuk sumber daya server yang didukung Azure Arc atau VM Azure. |
MANAGEDBY |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
SKU |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
PLAN |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
PROPERTIES |
Mengambil detail operasi dalam format JSON. Informasi selengkapnya mengikuti tabel ini. |
TAGS |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
IDENTITY |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
ZONES |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
EXTENDEDLOCATION |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
Deskripsi properti patchinstallationresults
Jika properti untuk jenis sumber daya adalah patchinstallationresults, properti menyertakan informasi dalam tabel berikut.
| Nilai | Deskripsi |
|---|---|
installationActivityId |
GUID unik untuk eksekusi penginstalan pembaruan OS. |
maintenanceWindowExceeded |
Nilai adalah True atau False jika eksekusi penginstalan pembaruan melebihi jendela pemeliharaan yang ditentukan. |
lastModifiedDateTime |
Stempel waktu (UTC) yang mewakili kapan catatan terakhir diperbarui. |
notSelectedPatchCount |
Jumlah pembaruan OS yang tersedia pada komputer yang tidak dipilih untuk penginstalan dalam penyebaran pembaruan. |
installedPatchCount |
Jumlah pembaruan OS yang berhasil diinstal yang ditentukan dalam penyebaran pembaruan. |
excludedPatchCount |
Jumlah pembaruan OS yang tersedia di komputer dan dikecualikan untuk penginstalan dalam penyebaran pembaruan. |
pendingPatchCount |
Jumlah pembaruan OS yang masih menunggu untuk diinstal yang ditentukan dalam penyebaran pembaruan. |
patchServiceUsed |
Layanan OS yang digunakan pada komputer untuk menginstal pembaruan. WU-WSUS untuk layanan Windows Update atau Windows Server Update Service. Untuk Linux, ini adalah manajer paket OS seperti YUM, , APTatau Zypper. |
failedPatchCount |
Jumlah pembaruan OS yang gagal diinstal yang ditentukan dalam penyebaran pembaruan. |
startDateTime |
Stempel waktu (UTC) yang mewakili kapan tugas penginstalan pembaruan OS memulai eksekusi pada komputer. |
rebootStatus |
Informasi dari layanan pembaruan atau manajer paket OS jika OS perlu dimulai ulang untuk menyelesaikan penginstalan pembaruan. Nilai status adalah NotNeeded (tidak diperlukan hidupkan ulang), Required (mulai ulang OS diperlukan untuk penyelesaian), Started (mulai ulang dimulai), Failed (OS tidak dapat dimulai ulang), dan Completed (mulai ulang berhasil dilakukan). |
startedBy |
Mengidentifikasi apakah pengguna atau layanan Azure memicu penginstalan pembaruan OS. Untuk informasi selengkapnya tentang operasi ini, lihat Log aktivitas Azure. |
status |
Status eksekusi penginstalan pembaruan OS. Nilainya bisa , NotStarted, FailedInProgress, Succeeded, dan CompletedWithWarnings. Eksekusi penginstalan pembaruan dianggap Failed status jika satu atau beberapa penginstalan pembaruan OS tidak berhasil. |
osType |
Mewakili jenis sistem operasi: Windows atau Linux. |
errorDetails |
Menyertakan lima pesan kesalahan pertama yang dihasilkan saat menjalankan penginstalan pembaruan dari manajer paket atau layanan pembaruan OS komputer. |
maintenanceRunId |
Nilai ini digunakan sebagai pengidentifikasi eksekusi pemeliharaan untuk Patching Tamu VM Otomatis atau ID eksekusi jadwal alih-alih pembaruan berulang. |
Jika properti untuk jenis sumber daya adalah patchinstallationresults/softwarepatches, properti menyertakan informasi dalam tabel berikut.
| Nilai | Deskripsi |
|---|---|
installationState |
Status penginstalan untuk pembaruan OS tertentu. Nilainya adalah Installed, Failed, Pending, NotSelected, dan Excluded. |
lastModifiedDateTime |
Stempel waktu (UTC) yang mewakili kapan catatan terakhir diperbarui. |
publishedDateTime |
Stempel waktu yang mewakili kapan pembaruan tertentu disediakan oleh vendor OS. Layanan pembaruan atau manajer paket OS komputer menghasilkan informasi tersebut. Jika manajer paket atau layanan pembaruan OS Anda tidak memberikan detail mengenai kapan pembaruan disediakan oleh vendor OS, nilainya adalah null. |
classifications |
Kategori tempat pembaruan tertentu sesuai dengan vendor OS seperti yang disediakan oleh layanan pembaruan atau manajer paket OS komputer. Jika manajer paket OS atau layanan pembaruan Anda tidak memberikan detail kategori, nilai bidangnya adalah Others (untuk Linux) dan Updates (untuk Windows Server). |
rebootRequired |
Bendera untuk menentukan apakah pembaruan tertentu mengharuskan OS untuk memulai ulang guna menyelesaikan penginstalan, seperti yang disediakan oleh layanan pembaruan atau manajer paket OS komputer. Jika manajer paket OS atau layanan pembaruan Anda tidak memberikan informasi mengenai kebutuhan reboot OS, nilai bidang diatur ke false. |
rebootBehavior |
Perilaku yang diatur dalam penginstalan pembaruan OS yang menjalankan tugas oleh pengguna, mengenai mengizinkan Manajer Pembaruan untuk mem-boot ulang OS. |
patchName |
Nama atau label untuk pembaruan tertentu yang disediakan oleh manajer paket atau layanan pembaruan OS komputer. |
Kbid |
Jika OS komputer adalah Windows Server, nilainya menyertakan ID KB unik untuk pembaruan yang disediakan oleh layanan Windows Update. |
version |
Jika OS komputer adalah Linux, nilainya menyertakan detail versi untuk pembaruan seperti yang disediakan oleh manajer paket Linux. Contohnya,1.0.1.el7.3. |
Sumber daya pemeliharaan
Tabel maintenanceresources ini mencakup sumber daya yang terkait dengan konfigurasi pemeliharaan. Tabel berikut menjelaskan propertinya.
| Properti | Deskripsi |
|---|---|
ID |
ID Azure Resource Manager meneruskan hasilnya. Ini mirip dengan jalur REST API untuk membuat konfigurasi pemeliharaan. |
NAME |
Jika ID berjenis <resourcePath>/applyupdates, maka rekaman berisi GUID unik untuk pemeliharaan yang dijalankan. Jika <resourcePath>/configurationassignments, maka catatan berisi penetapan konfigurasi pemeliharaan ke Azure atau Azure Arc VM. |
TYPE |
Menentukan jenis log untuk penilaian. Jika jenisnya adalah applyupdates, maka catatan menyediakan detail catatan eksekusi pemeliharaan pada tingkat komputer. Jika jenisnya adalah configurationassignments, maka catatan menjelaskan tautan antara Azure VM atau Azure Arc VM dan konfigurasi pemeliharaan. |
TENANTID |
ID penyewa Azure untuk sumber daya server yang didukung Azure Arc atau VM Azure. |
KIND |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
LOCATION |
Region cloud murni tempat sumber daya server yang didukung Azure Arc atau VM Azure berada. |
RESOURCEGROUP |
Grup sumber daya Azure yang menghosting sumber daya server yang didukung Azure Arc atau VM Azure. |
SUBSCRIPTIONID |
ID langganan Azure untuk sumber daya server yang didukung Azure Arc atau VM Azure. |
MANAGEDBY |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
SKU |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
PLAN |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
PROPERTIES |
Mengambil detail operasi dalam format JSON. Informasi selengkapnya mengikuti tabel ini. |
TAGS |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
IDENTITY |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
ZONES |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
EXTENDEDLOCATION |
Sengaja dibiarkan kosong untuk digunakan di masa mendatang. |
Deskripsi properti applyupdates
Jika properti untuk jenis sumber daya adalah applyupdates, properti menyertakan informasi dalam tabel berikut.
| Nilai | Deskripsi |
|---|---|
maintenanceConfigurationId |
ID Azure Resource Manager dari konfigurasi pemeliharaan yang diterapkan. |
maintenanceScope |
Cakupan pemeliharaan dari konfigurasi pemeliharaan yang diterapkan. |
resourceId |
ID sumber daya templat Azure Resource Manager dari VM ARC/Azure. |
correlationId |
ID eksekusi jadwal dari eksekusi pemeliharaan/jadwal. Informasi ini dapat digunakan untuk menemukan semua VM yang merupakan bagian dari jadwal yang sama. |
startDateTime |
Tanggal dan waktu mulai dari jadwal. |
endDateTime |
Tanggal dan waktu selesai dari jadwal. |
Jika properti untuk jenis sumber daya adalah configurationassignments, properti menyertakan informasi dalam tabel berikut.
| Nilai | Deskripsi |
|---|---|
resourceId |
ID sumber daya Azure Resource Manager dari VM ARC/Azure |
maintenanceConfigurationId |
ID Azure Resource Manager dari konfigurasi pemeliharaan yang diterapkan |
Langkah berikutnya
- Untuk kueri sampel untuk mengakses data operasi Azure Update Manager, lihat Contoh kueri Azure Resource Graph untuk mengakses data operasi Azure Update Manager.
- Untuk memecahkan masalah dengan Azure Update Manager, lihat Memecahkan masalah dengan Azure Update Manager.