مشاركة عبر

إعلامات موارد 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 - أحداث الموارد الصحية.