مشاركة عبر

الوصول إلى بيانات عمليات Azure Update Manager باستخدام Azure Resource Graph

  • مقالة

يتم تخزين السجلات التي تم إنشاؤها من عمليات مثل تقييمات التحديث وعمليات التثبيت بواسطة Azure Update Manager في Azure Resource Graph. Resource Graph هي خدمة في Azure مصممة لتكون مخزنا لتفاصيل خدمة Azure دون أي متطلبات للتكلفة أو التوزيع. يستخدم Update Manager Resource Graph لتخزين نتائجه. يمكنك عرض محفوظات تقييم التحديث لآخر 7 أيام وتحديث محفوظات التثبيتات لآخر 30 يوما من Resource Graph.

توضح هذه المقالة بنية السجلات من Update Manager وكيف يمكنك استخدام Azure Resource Graph Explorer لتحليلها لدعم احتياجات التقارير والتصور والتصدير.

بنية السجل

يرسل Update Manager نتائج جميع عملياته إلى Azure Resource Graph كسجلات، والتي تتوفر لمدة 30 يوما. المدرجة هنا هي بنية السجلات التي يتم إرسالها إلى Azure Resource Graph.

نتائج تقييم التصحيح

يتضمن الجدول patchassessmentresources الموارد المتعلقة بتقييم تصحيح الجهاز. يصف الجدول التالي خصائصه.

الخاصية ‏‏الوصف
ID معرف Azure Resource Manager الذي يقوم بإعادة توجيه النتيجة. إنه مشابه لمسار واجهة برمجة تطبيقات REST لتقييم نظام التشغيل الضيف. عادة، <resourcePath>/patchAssessmentResults/latest أو <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>.
NAME إذا كان المعرف من النوع <resourcePath>/patchAssessmentResults/latest، فإن السجل يحتوي على GUID الفريد لعملية التقييم التي انتهت. إذا ، <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>فإن السجل يحتوي على اسم التحديث أو التسمية.
TYPE تحديد نوع السجل للتقييم. إذا كان النوع هو patchassessmentresults، فإن السجل يوفر ملخصا لتقييم نظام التشغيل مع إحصائيات إجمالية رقمية. إذا كان النوع هو patchassessmentresults/softwarepatches، فإن السجل يصف تحديث نظام تشغيل معين متوفر للمورد.
TENANTID معرف مستأجر Azure لمورد خادم Azure VM أو Azure Arc الممكن.
KIND ترك فارغا عمدا للاستخدام في المستقبل.
LOCATION منطقة سحابة Azure حيث يوجد مورد خادم Azure VM أو Azure Arc الممكن.
RESOURCEGROUP تستضيف مجموعة موارد Azure مورد خادم Azure VM أو مورد خادم Azure Arc الممكن.
SUBSCRIPTIONID معرف اشتراك Azure لمورد خادم Azure VM أو Azure Arc الممكن.
MANAGEDBY ترك فارغا عمدا للاستخدام في المستقبل.
SKU ترك فارغا عمدا للاستخدام في المستقبل.
PLAN ترك فارغا عمدا للاستخدام في المستقبل.
PROPERTIES يلتقط تفاصيل العملية بتنسيق JSON. يتبع هذا الجدول مزيد من المعلومات.
TAGS ترك فارغا عمدا للاستخدام في المستقبل.
IDENTITY ترك فارغا عمدا للاستخدام في المستقبل.
ZONES ترك فارغا عمدا للاستخدام في المستقبل.
EXTENDEDLOCATION ترك فارغا عمدا للاستخدام في المستقبل.

وصف خاصية patchassessmentresources

إذا كانت الخاصية لنوع المورد هي patchassessmentresources، فإنها تتضمن المعلومات الموجودة في الجدول التالي.

قيمة ‏‏الوصف
rebootPending ضع علامة لتحديد ما إذا كان التحديث المحدد يتطلب من نظام التشغيل إعادة التشغيل لإنهاء التثبيت. كما هو مقدم من قبل خدمة تحديث نظام التشغيل أو مدير الحزمة للجهاز. إذا لم يتطلب مدير حزمة نظام التشغيل أو خدمة التحديث إعادة التشغيل، يتم تعيين قيمة الحقل إلى false.
patchServiceUsed خدمة نظام التشغيل المستخدمة على الجهاز لتثبيت التحديثات. WU-WSUS لخدمة Windows Update أو خدمة Windows Server Update. بالنسبة إلى Linux، إنه مدير حزمة نظام التشغيل مثل YUMأو APTأو Zypper.
osType يمثل نوع نظام التشغيل: Windows أو Linux.
startDateTime الطابع الزمني (UTC) الذي يمثل وقت بدء تنفيذ مهمة تقييم تحديث نظام التشغيل على الجهاز.
lastModifiedDateTime الطابع الزمني (UTC) الذي يمثل آخر تحديث للسجل.
startedBy يحدد ما إذا كان مستخدم أو خدمة Azure قد قام بتشغيل تثبيت تحديث نظام التشغيل. لمزيد من المعلومات حول العملية، راجع سجل نشاط Azure.
errorDetails أول خمس رسائل خطأ تم إنشاؤها أثناء تنفيذ تثبيت التحديث من مدير حزمة نظام التشغيل للجهاز أو خدمة التحديث.
availablePatchCountByClassification عدد تحديثات نظام التشغيل حسب الفئة التي تنتمي إليها التحديثات المحددة استنادا إلى مورد نظام التشغيل. تقوم خدمة تحديث نظام التشغيل للجهاز أو مدير الحزمة بإنشاء المعلومات. إذا لم يوفر مدير حزمة نظام التشغيل أو خدمة التحديث تفاصيل الفئة، فإن القيمة هي Others (ل Linux) أو Updates (ل Windows Server).

إذا كانت الخاصية لنوع المورد هي patchassessmentresults/softwarepatches، فإنها تتضمن المعلومات الموجودة في الجدول التالي.

قيمة ‏‏الوصف
lastModifiedDateTime الطابع الزمني (UTC) الذي يمثل آخر تحديث للسجل.
publishedDateTime الطابع الزمني الذي يمثل وقت توفير التحديث المحدد من قبل مورد نظام التشغيل. تقوم خدمة تحديث نظام التشغيل للجهاز أو مدير الحزمة بإنشاء المعلومات. إذا لم يوفر مدير حزمة نظام التشغيل أو خدمة التحديث تفاصيل وقت توفير أحد التحديثات من قبل مورد نظام التشغيل، تكون القيمة خالية. لا تتوفر هذه القيمة حاليا في حالة تحديثات Linux.
classifications الفئة التي ينتمي إليها التحديث المحدد وفقا لمورد نظام التشغيل. تقوم خدمة تحديث نظام التشغيل للجهاز أو مدير الحزمة بإنشاء المعلومات. إذا لم يوفر مدير حزمة نظام التشغيل أو خدمة التحديث تفاصيل الفئة، فإن القيمة هي Others (ل Linux) أو Updates (ل Windows Server).
rebootRequired تشير القيمة إلى ما إذا كان التحديث المحدد يتطلب من نظام التشغيل إعادة التشغيل لإنهاء التثبيت. تقوم خدمة تحديث نظام التشغيل للجهاز أو مدير الحزمة بإنشاء المعلومات. إذا كان مدير حزمة نظام التشغيل أو خدمة التحديث لا تتطلب إعادة التشغيل، فإن القيمة هي false.
rebootBehavior يعمل السلوك الذي تم تعيينه في تثبيت تحديث نظام التشغيل على تشغيل المهمة عند تكوين نشر التحديث إذا كان بإمكان Update Manager إعادة تشغيل الجهاز الهدف.
patchName اسم أو تسمية التحديث المحدد الذي تم إنشاؤه بواسطة مدير حزمة نظام التشغيل للجهاز أو خدمة التحديث.
Kbid إذا كان نظام تشغيل الجهاز هو Windows Server، فإن القيمة تتضمن معرف KB الفريد للتحديث الذي توفره خدمة Windows Update.
version إذا كان نظام تشغيل الجهاز هو Linux، فإن القيمة تتضمن تفاصيل الإصدار للتحديث كما هو مقدم من قبل مدير حزمة Linux. على سبيل المثال، 1.0.1.el7.3

نتائج تثبيت التصحيح

يتضمن الجدول patchinstallationresources الموارد المتعلقة بتقييم تصحيح الجهاز. يصف الجدول التالي خصائصه.

الخاصية ‏‏الوصف
ID معرف Azure Resource Manager الذي يقوم بإعادة توجيه النتيجة. إنه مشابه لمسار واجهة برمجة تطبيقات REST لتقييم نظام التشغيل الضيف. عادة، <resourcePath>/patchInstallationResults/<GUID> أو <resourcePath>/patchAssessmentResults/latest/softwarePatches/<update>.
NAME إذا كان المعرف من النوع <resourcePath>/patchInstallationResults، فإن السجل يحتوي على GUID فريد لعملية التحديث التي انتهت. إذا ، <resourcePath>/patchInstallationResults/softwarePatches/<update>فإن السجل يحتوي على اسم التحديث أو التسمية التي يتم تثبيتها على الجهاز.
TYPE تحديد نوع السجل للتقييم. إذا كان النوع هو patchinstallationresults، فإن السجل يوفر ملخصا لتثبيت نظام التشغيل مع إحصائيات إجمالية رقمية. إذا كان النوع هو patchinstallationresults/softwarepatches، فإن السجل يصف تحديث نظام تشغيل معين مثبت للمورد.
TENANTID معرف مستأجر Azure لمورد خادم Azure VM أو Azure Arc الممكن.
KIND ترك فارغا عمدا للاستخدام في المستقبل.
LOCATION منطقة سحابة Azure حيث يوجد مورد خادم Azure VM أو Azure Arc الممكن.
RESOURCEGROUP تستضيف مجموعة موارد Azure مورد خادم Azure VM أو مورد خادم Azure Arc الممكن.
SUBSCRIPTIONID معرف اشتراك Azure لمورد خادم Azure VM أو Azure Arc الممكن.
MANAGEDBY ترك فارغا عمدا للاستخدام في المستقبل.
SKU ترك فارغا عمدا للاستخدام في المستقبل.
PLAN ترك فارغا عمدا للاستخدام في المستقبل.
PROPERTIES يلتقط تفاصيل العملية بتنسيق JSON. يتبع هذا الجدول مزيد من المعلومات.
TAGS ترك فارغا عمدا للاستخدام في المستقبل.
IDENTITY ترك فارغا عمدا للاستخدام في المستقبل.
ZONES ترك فارغا عمدا للاستخدام في المستقبل.
EXTENDEDLOCATION ترك فارغا عمدا للاستخدام في المستقبل.

وصف خاصية patchinstallationresults

إذا كانت الخاصية لنوع المورد هي patchinstallationresults، فإنها تتضمن المعلومات الموجودة في الجدول التالي.

قيمة ‏‏الوصف
installationActivityId GUID فريد لتشغيل تثبيت تحديث نظام التشغيل.
maintenanceWindowExceeded القيم هي True أو False إذا تجاوز تشغيل تثبيت التحديث نافذة الصيانة المحددة.
lastModifiedDateTime الطابع الزمني (UTC) الذي يمثل آخر تحديث للسجل.
notSelectedPatchCount عدد تحديثات نظام التشغيل المتوفرة على الجهاز غير المحدد للتثبيت في نشر التحديث.
installedPatchCount عدد تحديثات نظام التشغيل التي تم تثبيتها بنجاح والتي تم تحديدها في نشر التحديث.
excludedPatchCount عدد تحديثات نظام التشغيل المتوفرة على الجهاز والمستبعدة للتثبيت في نشر التحديث.
pendingPatchCount لا يزال عدد تحديثات نظام التشغيل في انتظار تثبيتها التي تم تحديدها في نشر التحديث.
patchServiceUsed خدمة نظام التشغيل المستخدمة على الجهاز لتثبيت التحديثات. WU-WSUS لخدمة Windows Update أو خدمة Windows Server Update. بالنسبة إلى Linux، إنه مدير حزمة نظام التشغيل مثل YUMأو APTأو Zypper.
failedPatchCount عدد تحديثات نظام التشغيل التي فشلت في تثبيتها بنجاح والتي تم تحديدها في نشر التحديث.
startDateTime الطابع الزمني (UTC) الذي يمثل وقت بدء تنفيذ مهمة تثبيت تحديث نظام التشغيل على الجهاز.
rebootStatus معلومات من خدمة تحديث نظام التشغيل أو مدير الحزم إذا كان نظام التشغيل بحاجة إلى إعادة التشغيل لإنهاء تثبيت التحديث. قيم الحالة ( NotNeeded لا توجد حاجة لإعادة التشغيل)، Required (إعادة تشغيل نظام التشغيل مطلوبة للإكمال)، Started (تم بدء إعادة التشغيل)، Failed (تعذر إعادة تشغيل نظام التشغيل)، و Completed (تمت إعادة التشغيل بنجاح).
startedBy يحدد ما إذا كان مستخدم أو خدمة Azure قد قام بتشغيل تثبيت تحديث نظام التشغيل. لمزيد من المعلومات حول العملية، راجع سجل نشاط Azure.
status حالة تشغيل تثبيت تحديث نظام التشغيل. يمكن أن تكون NotStartedالقيم و FailedInProgressSucceededو.CompletedWithWarnings يعتبر Failed تشغيل تثبيت التحديث حالة إذا لم ينجح تثبيت تحديث نظام تشغيل واحد أو أكثر.
osType يمثل نوع نظام التشغيل: Windows أو Linux.
errorDetails يتضمن رسائل الخطأ الخمس الأولى التي تم إنشاؤها أثناء تشغيل تثبيت التحديث من مدير حزمة نظام التشغيل للجهاز أو خدمة التحديث.
maintenanceRunId يتم استخدام هذه القيمة كمعرف تشغيل صيانة ل Auto VM Guest Patching أو معرف تشغيل الجدولة بدلا من التحديثات المتكررة.

إذا كانت الخاصية لنوع المورد هي patchinstallationresults/softwarepatches، فإنها تتضمن المعلومات الموجودة في الجدول التالي.

قيمة ‏‏الوصف
installationState حالة التثبيت لتحديث نظام التشغيل المحدد. القيم هي InstalledوFailedPendingNotSelected.Excluded
lastModifiedDateTime الطابع الزمني (UTC) الذي يمثل آخر تحديث للسجل.
publishedDateTime الطابع الزمني الذي يمثل وقت توفير التحديث المحدد من قبل مورد نظام التشغيل. تقوم خدمة تحديث نظام التشغيل للجهاز أو مدير الحزمة بإنشاء المعلومات. إذا لم يوفر مدير حزمة نظام التشغيل أو خدمة التحديث تفاصيل وقت توفير أحد التحديثات من قبل مورد نظام التشغيل، تكون القيمة خالية.
classifications الفئة التي ينتمي إليها التحديث المحدد وفقا لمورد نظام التشغيل كما هو مقدم من قبل خدمة تحديث نظام التشغيل للجهاز أو مدير الحزم. إذا لم يوفر مدير حزمة نظام التشغيل أو خدمة التحديث تفاصيل الفئة، فإن قيمة الحقل هي Others (ل Linux) و Updates (ل Windows Server).
rebootRequired ضع علامة لتحديد ما إذا كان التحديث المحدد يتطلب من نظام التشغيل إعادة التشغيل لإنهاء التثبيت، كما هو مقدم من خدمة تحديث نظام التشغيل أو مدير الحزمة للجهاز. إذا لم يوفر مدير حزمة نظام التشغيل أو خدمة التحديث معلومات حول الحاجة إلى إعادة تشغيل نظام التشغيل، يتم تعيين قيمة الحقل إلى false.
rebootBehavior السلوك الذي تم تعيينه في تثبيت تحديث نظام التشغيل يشغل المهمة بواسطة المستخدم، فيما يتعلق بالسماح ل Update Manager بإعادة تشغيل نظام التشغيل.
patchName اسم أو تسمية التحديث المحدد كما هو مقدم من قبل مدير حزمة نظام التشغيل للجهاز أو خدمة التحديث.
Kbid إذا كان نظام تشغيل الجهاز هو Windows Server، فإن القيمة تتضمن معرف KB الفريد للتحديث الذي توفره خدمة Windows Update.
version إذا كان نظام تشغيل الجهاز هو Linux، فإن القيمة تتضمن تفاصيل الإصدار للتحديث كما هو مقدم من قبل مدير حزمة Linux. على سبيل المثال، 1.0.1.el7.3

موارد الصيانة

يتضمن الجدول maintenanceresources الموارد المتعلقة بتكوين الصيانة. يصف الجدول التالي خصائصه.

الخاصية ‏‏الوصف
ID معرف Azure Resource Manager الذي يقوم بإعادة توجيه النتيجة. إنه مشابه لمسار واجهة برمجة تطبيقات REST لإنشاء تكوين صيانة.
NAME إذا كان المعرف من النوع <resourcePath>/applyupdates، فإن السجل يحتوي على GUID فريد لتشغيل الصيانة. إذا ، <resourcePath>/configurationassignmentsفإن السجل يحتوي على تعيين تكوين الصيانة إلى Azure أو Azure Arc VM.
TYPE تحديد نوع السجل للتقييم. إذا كان النوع هو applyupdates، فإن السجل يوفر تفاصيل سجل تشغيل الصيانة على مستوى الجهاز. إذا كان النوع هو configurationassignments، فإن السجل يصف الارتباط بين جهاز Azure الظاهري أو Azure Arc VM وتكوين الصيانة.
TENANTID معرف مستأجر Azure لمورد خادم Azure VM أو Azure Arc الممكن.
KIND ترك فارغا عمدا للاستخدام في المستقبل.
LOCATION منطقة سحابة خالصة حيث يوجد مورد خادم Azure VM أو Azure Arc الممكن.
RESOURCEGROUP تستضيف مجموعة موارد Azure مورد خادم Azure VM أو مورد خادم Azure Arc الممكن.
SUBSCRIPTIONID معرف اشتراك Azure لمورد خادم Azure VM أو Azure Arc الممكن.
MANAGEDBY ترك فارغا عمدا للاستخدام في المستقبل.
SKU ترك فارغا عمدا للاستخدام في المستقبل.
PLAN ترك فارغا عمدا للاستخدام في المستقبل.
PROPERTIES يلتقط تفاصيل العملية بتنسيق JSON. يتبع هذا الجدول مزيد من المعلومات.
TAGS ترك فارغا عمدا للاستخدام في المستقبل.
IDENTITY ترك فارغا عمدا للاستخدام في المستقبل.
ZONES ترك فارغا عمدا للاستخدام في المستقبل.
EXTENDEDLOCATION ترك فارغا عمدا للاستخدام في المستقبل.

وصف خاصية applyupdates

إذا كانت الخاصية لنوع المورد هي applyupdates، فإنها تتضمن المعلومات الموجودة في الجدول التالي.

قيمة ‏‏الوصف
maintenanceConfigurationId معرف Azure Resource Manager لتكوين الصيانة المطبقة.
maintenanceScope نطاق الصيانة لتكوين الصيانة المطبقة.
resourceId معرف مورد قالب Azure Resource Manager ل ARC/Azure VM.
correlationId جدولة معرف تشغيل الصيانة/جدولة التشغيل. يمكن استخدام هذه المعلومات للعثور على جميع الأجهزة الظاهرية التي كانت جزءا من نفس الجدول الزمني.
startDateTime تاريخ ووقت البدء لجدول زمني.
endDateTime تاريخ انتهاء الجدول الزمني ووقته.

إذا كانت الخاصية لنوع المورد هي configurationassignments، فإنها تتضمن المعلومات الموجودة في الجدول التالي.

قيمة ‏‏الوصف
resourceId معرف مورد Azure Resource Manager ل ARC/Azure VM
maintenanceConfigurationId معرف Azure Resource Manager لتكوين الصيانة المطبقة

الخطوات التالية