استدعاء إخطار على الويب مع تنبيه قياس كلاسيكي في Azure Monitor

  • مقالة

تحذير

توضح هذه المقالة كيفية استخدام تنبيهات القياس الكلاسيكية القديمة. يدعم Azure Monitor الآن تنبيهات القياس في الوقت الفعلي تقريبا وتجربة تنبيهات جديدة. يتم ⁧⁧⁩⁩وقف⁧⁧⁩⁩ التنبيهات الكلاسيكية لمستخدمي السحابة العموميين. ستتوقف التنبيهات الكلاسيكية Azure Government السحابية وMicrosoft Azure المشغلة بواسطة 21Vianet في 29 فبراير 2024.

يمكنك استخدام الإخطارات على الويب لتوجيه إعلام تنبيه Azure إلى أنظمة أخرى لإجراءات ما بعد المعالجة أو الإجراءات المخصصة. يمكنك استخدام إخطار على الويب في تنبيه معين لتوجيهه إلى الخدمات التي ترسل رسائل SMS، لتسجيل الأخطاء، أو لإعلام الفريق عبر خدمات الدردشة أو المراسلة، أو لإجراءات أخرى مختلفة.

توضح هذه المقالة كيفية تعيين إخطار على الويب في تنبيه قياس Azure. كما تُظهر لك كيف تبدو البيانات الأساسية لـ HTTP POST المرسلة إلى إخطار على الويب. للحصول على معلومات حول الإعداد والمخطط لتنبيه سجل نشاط Azure (تنبيه على الأحداث)، راجع استدعاء إخطار على الويب في تنبيه سجل نشاط Azure.

تستخدم تنبيهات Azure HTTP POST لإرسال محتويات التنبيه بتنسيق JSON إلى عنواون URI خاص بالإخطار على الويب الذي توفره عند إنشاء التنبيه. يتم تعريف المخطط لاحقًا في هذه المقالة. يجب أن يكون عنوان URI عبارة عن نقطة نهاية HTTP أو HTTPS صالحة. ينشر Azure إدخال واحد لكل طلب عند تنشيط تنبيه.

تكوين الإخطارات على الويب عبر مدخل Microsoft Azure

لإضافة أو تحديث عنوان URI خاص بإخطار على الويب، في مدخل Microsoft Azure، انتقل إلى Create/Update Alerts.

إضافة جزء قاعدة تنبيه

يمكنك أيضًا تكوين تنبيه للنشر إلى عنوان URI خاص بإخطار على الويب باستخدام Azure PowerShell cmdletsأو واجهة سطر الأوامر عبر النظام الأساسي، أو واجهات برمجة التطبيقات لـAzure Monitor REST.

مصادقة إخطار على الويب

يمكن مصادقة إخطار على الويب باستخدام التخويل المستند إلى الرمز المميز. يتم حفظ عنوان URI الخاص بالإخطار على الويب مع معرف رمز مميز. على سبيل المثال:https://mysamplealert/webcallback?tokenid=sometokenid&someparameter=somevalue

مخطط البيانات الأساسية

تحتوي عملية النشر على البيانات الأساسية التالية لـ JSON ومخطط لجميع التنبيهات المستندة إلى القياس:

{
    "status": "Activated",
    "context": {
        "timestamp": "2015-08-14T22:26:41.9975398Z",
        "id": "/subscriptions/s1/resourceGroups/useast/providers/microsoft.insights/alertrules/ruleName1",
        "name": "ruleName1",
        "description": "some description",
        "conditionType": "Metric",
        "condition": {
            "metricName": "Requests",
            "metricUnit": "Count",
            "metricValue": "10",
            "threshold": "10",
            "windowSize": "15",
            "timeAggregation": "Average",
            "operator": "GreaterThanOrEqual"
        },
        "subscriptionId": "s1",
        "resourceGroupName": "useast",
        "resourceName": "mysite1",
        "resourceType": "microsoft.foo/sites",
        "resourceId": "/subscriptions/s1/resourceGroups/useast/providers/microsoft.foo/sites/mysite1",
        "resourceRegion": "centralus",
        "portalLink": "https://portal.azure.com/#resource/subscriptions/s1/resourceGroups/useast/providers/microsoft.foo/sites/mysite1"
    },
    "properties": {
        "key1": "value1",
        "key2": "value2"
    }
}
الحقل إلزامي مجموعة ثابتة من القيم ملاحظات
الحالة Y تم التنشيط وتم الحل حالة التنبيه استنادًا إلى الشروط التي قمت بتعيينها.
السياق Y سياق التنبيه.
طابع زمني Y الوقت الذي تم فيه تشغيل التنبيه.
المعرف Y كل قاعدة تنبيه لها معرف فريد.
الاسم Y اسم التنبيه.
الوصف Y وصف التنبيه.
conditionType Y قياس، حدث يتم دعم نوعين من التنبيهات: القياس والحدث. تستند تنبيهات القياس إلى شرط القياس. تستند تنبيهات الأحداث إلى حدث معين في سجل النشاط. استخدم هذه القيمة لفحص ما إذا كان التنبيه يستند إلى قياس أو حدث.
الشرط Y الحقول المحددة للفحص استنادًا إلى قيمة conditionType.
metricName لتنبيهات القياس اسم القياس الذي يحدد ما تراقبه القاعدة.
metricUnit لتنبيهات القياس وحدات البايت، والبايت في الثانية، والعدد، والعدد في الثانية، والنسبة المئوية، والثواني الوحدة المسموح بها في القياس. راجع القيم المسموح بها.
metricValue لتنبيهات القياس القيمة الفعلية للقياس الذي تسبب في التنبيه.
الحد لتنبيهات القياس قيمة الحد التي يتم تنشيط التنبيه عندها.
windowSize لتنبيهات القياس الفترة الزمنية المستخدمة لمراقبة نشاط التنبيه استنادًا إلى الحد. يجب أن يتراوح طول القيمة بين 5 دقائق ويوم واحد. يجب أن تكون القيمة بتنسيق مدة ISO 8601.
timeAggregation لتنبيهات القياس المتوسط، والأخير، والحد الأقصى، والحد الأدنى، ولا شيء، والإجمالي كيف ينبغي تجميع البيانات التي يتم جمعها مع مرور الوقت. القيمة الافتراضية هي المتوسط. راجع القيم المسموح بها.
operator لتنبيهات القياس عامل التشغيل المستخدم لمقارنة بيانات القياس الحالية للحد المعين.
subscriptionId Y معرف اشتراك Azure.
resourceGroupName Y اسم مجموعة الموارد للمورد المتأثر.
resourceName Y اسم المورد للمورد المتأثر.
resourceType Y نوع المورد للمورد المتأثر.
resourceId Y معرف المورد للمورد المتأثر.
resourceRegion Y المنطقة أو موقع المورد المتأثر.
portalLink Y ارتباط مباشر إلى صفحة ملخص مورد المدخل.
properties -N ‏‏اختياري مجموعة من أزواج المفاتيح / القيم التي تحتوي على تفاصيل حول الحدث. على سبيل المثال، ⁧Dictionary<String, String>⁩. حقل properties اختياري. في واجهة مستخدم مخصصة أو سير عمل يستند إلى تطبيق منطقي، يمكن للمستخدمين إدخال أزواج المفاتيح / القيم التي يمكن تمريرها عبر البيانات الأساسية. طريقة بديلة لتمرير خصائص مخصصة مرة أخرى إلى الإخطار على الويب هي عبر عنوان URI الخاص بالإخطار على الويب نفسه (كمعلمات استعلام).

ملاحظة

يمكنك تعيين الحقل properties فقط باستخدام واجهات برمجة التطبيقات لـ Azure Monitor REST.

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