إعلامات موارد Azure - أحداث الموارد الصحية في Azure Event Grid (معاينة)
يوفر موضوع نظام HealthResources معلومات صحية دقيقة وموثوقة وشاملة، ما يتيح فهما أعمق لمشكلات الخدمة المتنوعة التي تؤثر على موارد Azure الخاصة بك، وهي الأجهزة الظاهرية لمثيل واحد (VMs) وVMS لمجموعة مقياس الجهاز الظاهري ومجموعات مقياس الجهاز الظاهري. توفر الموارد الصحية نوعين من الأحداث للاستهلاك: AvailabilityStatusChanged
و ResourceAnnotated
.
توفر هذه المقالة خصائص ومخطط أحداث Azure Resource Notifications Health Resources. للحصول على مقدمة حول مخططات الأحداث بشكل عام، راجع مخطط حدث Azure Event Grid. بالإضافة إلى ذلك، يمكنك العثور على نماذج من الأحداث التي تم إنشاؤها وارتباط إلى مقالة ذات صلة حول كيفية إنشاء موضوع نظام لنوع الموضوع هذا.
أنواع الحدث
توفر الموارد الصحية نوعين من الأحداث للاستهلاك:
نوع الحدث | الوصف |
---|---|
Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged |
يرفع عند تغيير حالة توفر جهاز ظاهري لمثيل واحد أو مجموعة مقياس جهاز ظاهري أو جهاز ظاهري في مجموعة مقياس الجهاز الظاهري. توفر هذه المعلومات نظرة ثاقبة على جميع الأوقات التي لم تكن فيها الأجهزة الظاهرية للمثيل الواحد أو الأجهزة الظاهرية في مجموعات مقياس الجهاز الظاهري أو مجموعات مقياس الجهاز الظاهري نفسها غير متوفرة بسبب مشكلات خدمة Azure. لمزيد من المعلومات حول الحالات الصحية المختلفة، راجع نظرة عامة على Azure Resource Health - Azure Service Health. |
Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated |
يرفع عندما تتأثر صحة جهاز ظاهري أو مجموعة مقياس جهاز ظاهري أو جهاز ظاهري في مجموعة مقياس الجهاز الظاهري بالتوافر الذي يؤثر على الاضطرابات. يصدر النظام الأساسي سياقا حول سبب حدوث التعطيل لمساعدتك في الاستجابة بشكل مناسب. تساعدك هذه المعلومات على استنتاج حالة توفر مواردك من خلال توفير معلومات حاسمة حول أسباب وأسباب التغييرات في التوفر. باستخدام هذه البيانات، يمكنك اتخاذ تدابير تخفيف أسرع وأكثر استهدافا. لمزيد من المعلومات حول التعليقات التوضيحية المختلفة المنبعثة، راجع التعليقات التوضيحية لصحة الجهاز الظاهري لصحة الموارد. |
التحكم في الوصول استناداً إلى الدور
حاليا، يتم إصدار هذه الأحداث حصريا في نطاق اشتراك Azure. يعني أن الكيان الذي يقوم بإنشاء اشتراك الحدث لنوع الموضوع هذا يتلقى إعلامات خلال اشتراك Azure هذا. لأسباب أمنية، من الضروري تقييد القدرة على إنشاء اشتراكات الأحداث في هذا الموضوع على الأساسيات التي لها حق الوصول للقراءة عبر اشتراك Azure بأكمله. للوصول إلى البيانات عبر موضوع النظام هذا، بالإضافة إلى الأذونات العامة المطلوبة بواسطة Event Grid، يعد الإذن المحدد لإعلامات موارد Azure التالي ضروريا: Microsoft.ResourceNotifications/systemTopics/subscribeToHealthResources/action
.
مخططات الأحداث
إليك المخطط:
{
"id": string,
"source": string,
"subject": string,
"type": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged | Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
"time ": string,
"data": {
"resourceInfo": {
"id": string,
"name": string,
"type": string,
"properties": {
<<Different for AvailabilityStatusChanged event and ResourceAnnotated event>>
}
},
"operationalInfo":{
"resourceEventTime": date-time
},
"apiVersion": string
},
"specversion": string
}
ويحتوي الحدث على بيانات المستوى الأعلى التالية:
الخاصية | نوع | الوصف |
---|---|---|
id |
السلسلة | المعرف الفريد للحدث |
source |
السلسلة | اشتراك Azure الذي يتم إنشاء موضوع النظام هذا له. |
subject |
السلسلة | حدد Publisher المسار إلى المورد الأساسي الذي يتم إصدار هذا الحدث عليه. |
type |
السلسلة | نوع الحدث المسجل لنوع موضوع النظام هذا |
time |
سلسله تنسيق: 2022-11-07T18:43:09.2894075Z |
وقت إنشاء الحدث بناءً على وقت التوقيت العالمي المنسق للمزود |
data |
الكائن | يحتوي على بيانات الحدث الخاصة بموفر الموارد. لمزيد من المعلومات، راجع الجدول التالي. |
specversion |
السلسلة | إصدار مواصفات مخطط CloudEvents. |
يحتوي data
الكائن على الخصائص التالية:
الخاصية | نوع | الوصف |
---|---|---|
resourceInfo |
الكائن | البيانات الخاصة بالمورد. لمزيد من المعلومات، راجع الجدول التالي. |
apiVersion |
السلسلة | إصدار واجهة برمجة التطبيقات لخصائص المورد. |
operationalInfo |
الكائن | تفاصيل المعلومات التشغيلية المتعلقة بالمورد. |
يحتوي resourceInfo
الكائن على الخصائص التالية:
الخاصية | نوع | الوصف |
---|---|---|
id |
السلسلة | مسار تعريف الناشر لموضوع الحدث |
name |
السلسلة | يشير هذا الحقل إلى معرف الحدث. يأخذ دائما قيمة المقطع الأخير من id الحقل. |
type |
السلسلة | نوع الحدث الذي يتم إصداره. في هذا السياق، يكون إما Microsoft.ResourceHealth/AvailabilityStatuses أو Microsoft.ResourceHealth/ResourceAnnotated . |
properties |
الكائن | حمولة المورد. لمزيد من المعلومات، راجع الجدول التالي. |
يحتوي operationalInfo
الكائن على الخصائص التالية:
الخاصية | نوع | الوصف |
---|---|---|
resourceEventTime |
DateTime | تاريخ ووقت تحديث المورد. |
properties
يختلف داخل data
الكائن عن AvailabilityStatusChanged
و ResourceAnnotated
الأحداث.
خصائص حدث AvailabilityStatusChanged
"properties": {
"targetResourceId": string,
"targetResourceType": string,
"occurredTime": string,
"previousAvailabilityState": string,
"availabilityState": string
}
بالنسبة للحدث AvailabilityStatusChanged
، يحتوي الكائن على properties
الخصائص التالية:
الخاصية | نوع | الوصف |
---|---|---|
targetResourceId |
السلسلة | المورد الأساسي الذي يتم إصدار معلومات التوفر له. |
targetResourceType |
السلسلة | نوع المورد الأساسي. |
occurredTime |
السلسلة | الوقت الذي تم فيه إصدار هذا الحدث الفعلي. |
previousAvailabilityState |
السلسلة | حالة التوفر السابقة. |
availabilityState |
السلسلة | حالة التوفر الحالية. للحصول على قائمة القيم، راجع حالات التوفر - Get By Resource - REST API (Azure Resource Health). |
خصائص الحدث ResourceAnnotated
"properties": {
"targetResourceId": string,
"targetResourceType": string,
"occurredTime": string,
"annotationName": string,
"reason": string,
"summary": string,
"context": string,
"category": string,
}
بالنسبة للحدث ResourceAnnotated
، يحتوي الكائن على properties
الخصائص التالية:
الخاصية | نوع | الوصف |
---|---|---|
targetResourceId |
السلسلة | المورد الأساسي الذي يتم إرسال معلومات التعليق التوضيحي له. |
targetResourceType |
السلسلة | نوع المورد الأساسي. |
occurredTime |
السلسلة | الطابع الزمني عند إصدار التعليق التوضيحي بواسطة النظام الأساسي Azure استجابة لحدث التأثير على التوفر. |
annotationName |
السلسلة | اسم التعليق التوضيحي. للحصول على قائمة التعليقات التوضيحية والأوصاف المقابلة، راجع التعليقات التوضيحية لصحة الجهاز الظاهري لصحة الموارد - Azure Service Health. |
reason |
السلسلة | بيان موجز حول سبب تغيير توفر الموارد أو تأثره. |
summary |
السلسلة | بيان مفصل حول النشاط وسبب تغيير توفر الموارد أو التأثر بها. |
context |
السلسلة | تحديد ما إذا كان توفر الموارد قد تأثر بسبب Azure أو بسبب نشاط المستخدم. |
category |
السلسلة | تحديد ما إذا كان توفر الموارد قد تأثر بسبب النشاط المخطط له أو غير المخطط له. تنطبق هذه الخاصية فقط على Platform-Initiated الأحداث. |
مثال الأحداث
حدث AvailabilityStatusChanged
يوضح المثال التالي مخطط حدث تعديل قيمة المفتاح:
{
"id": "1fb6fa94-d965-4306-abeq-4810f0774e97",
"source": "/subscriptions/{subscription-id}",
"subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
"data": {
"resourceInfo": {
"id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}/providers/Microsoft.ResourceHealth/availabilityStatuses/{event-id}",
"name": "{event-id}",
"type": "Microsoft.ResourceHealth/availabilityStatuses",
"properties": {
"targetResourceId": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
"targetResourceType": "Microsoft.Compute/virtualMachines",
"occurredTime": "2023-07-24T19:20:37.9245071Z",
"previousAvailabilityState": "Unavailable",
"availabilityState": "Available"
}
},
"operationalInfo": {
"resourceEventTime": "2023-07-24T19:20:37.9245071Z"
},
"apiVersion": "2023-12-01"
},
"type": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged",
"specversion": "1.0",
"time": "2023-07-24T19:20:37.9245071Z"
}
حدث ResourceAnnotated
يوضح المثال التالي مخطط حدث تعديل قيمة المفتاح:
{
"id": "8945cf9b-e220-496e-ab4f-f3a239318995",
"source": "/subscriptions/{subscription-id}",
"subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
"data": {
"resourceInfo": {
"id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}/providers/Microsoft.ResourceHealth/resourceAnnotations/{event-id}",
"name": "{event-id}",
"type": "Microsoft.ResourceHealth/resourceAnnotations",
"properties": {
"targetResourceId": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
"targetResourceType": "Microsoft.Compute/virtualMachines",
"occurredTime": "2023-07-24T19:20:37.9245071Z",
"annotationName": "VirtualMachineDeallocationInitiated",
"reason": "Stopping and deallocating",
"summary": "This virtual machine is stopped and deallocated as requested by an authorized user or process.",
"context": "Customer Initiated",
"category": "Not Applicable"
}
},
"operationalInfo": {
"resourceEventTime": "2023-07-24T19:20:37.9245071Z"
},
"apiVersion": "2022-08-01"
},
"type": "Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
"specversion": "1.0",
"time": "2023-07-24T19:20:37.9245071Z"
}
الاتصال بنا
إذا كانت لديك أي أسئلة أو ملاحظات حول هذه الميزة، فلا تتردد في الاتصال بنا على arnsupport@microsoft.com.
لمساعدتك بشكل أفضل في تقديم ملاحظات محددة حول حدث معين، قم بتوفير المعلومات التالية:
للأحداث المفقودة:
- اسم نوع موضوع النظام
- الطابع الزمني التقريبي بالتوقيت العالمي المتفق عليه عند تنفيذ العملية
- معرف المورد الأساسي الذي تم إنشاء الإعلام له
- انتقل إلى المورد في مدخل Microsoft Azure وحدد طريقة عرض JSON في أقصى الزاوية اليمنى. معرف المورد هو الحقل الأول في صفحة عرض JSON.
- نوع الحدث المتوقع
- تم تنفيذ العملية (على سبيل المثال، بدء تشغيل الجهاز الظاهري أو إيقافه، وإنشاء حساب التخزين وما إلى ذلك)
- وصف المشكلة التي تمت مصادفتها (على سبيل المثال، تم بدء تشغيل الجهاز الظاهري ولم يتم إنشاء حدث Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged)
- إذا كان ذلك ممكنا، فوفر معرف الارتباط للعملية المنفذة
للحدث الذي تم تأخيره أو يحتوي على محتوى غير متوقع
- اسم نوع موضوع النظام
- محتويات الإعلام بالكامل باستثناء data.resourceInfo.properties
- وصف المشكلة التي تمت مواجهتها وقيم الحقول المتأثرة
تأكد من أنك لا توفر أي معلومات تعريف للمستخدم النهائي أثناء مشاركة هذه البيانات.
الخطوات التالية
راجع الاشتراك في إعلامات موارد Azure - أحداث الموارد الصحية.