تخصيص إعلامات التنبيه باستخدام Logic Apps

توضح لك هذه المقالة كيفية إنشاء تطبيق منطقي ودمجه مع تنبيه Azure Monitor.

يمكنك استخدام Azure Logic Apps لإنشاء مهام سير العمل وتخصيصها للتكامل. استخدم Logic Apps لتخصيص إعلامات التنبيه. يمكنك:

• تخصيص البريد الإلكتروني للتنبيهات باستخدام موضوع البريد الإلكتروني وتنسيق النص الأساسي.
• تخصيص بيانات تعريف التنبيه عن طريق البحث عن علامات للموارد المتأثرة أو إحضار نتيجة بحث استعلام سجل. للحصول على معلومات حول كيفية الوصول إلى صفوف نتائج البحث التي تحتوي على بيانات التنبيهات، راجع:
  • تنسيق استجابة واجهة برمجة تطبيقات Azure Monitor Log Analytics
  • استجابة HTTP للاستعلام/الإدارة
• التكامل مع الخدمات الخارجية باستخدام الموصلات الموجودة مثل Outlook وMicrosoft Teams وSlack وPagerDuty. يمكنك أيضا تكوين تطبيق المنطق لخدماتك الخاصة.

ينشئ هذا المثال تطبيقا منطقيا يستخدم مخطط التنبيهات الشائعة لإرسال التفاصيل من التنبيه.

إنشاء تطبيق منطقي

1. في مدخل Microsoft Azure، أنشئ تطبيقا منطقيا جديدا. في شريط البحث في أعلى الصفحة، أدخل Logic App.

2. في صفحة Logic App ، حدد Add.

3. حدد مجموعة الاشتراك والموارد لتطبيق المنطق الخاص بك.

4. تعيين اسم Logic App. بالنسبة إلى نوع الخطة، حدد Consumption.

5. اختر إنشاء>مراجعة + إنشاء.

6. حدد Go to resource بعد انتهاء النشر.

   

7. في صفحة Logic Apps Designer ، حدد When a HTTP request is received.

   

8. الصق مخطط التنبيه الشائع في حقل مخطط JSON لنص الطلب من JSON التالي:

    {
       "type": "object",
       "properties": {
           "schemaId": {
               "type": "string"
           },
           "data": {
               "type": "object",
               "properties": {
                   "essentials": {
                       "type": "object",
                       "properties": {
                           "alertId": {
                               "type": "string"
                           },
                           "alertRule": {
                               "type": "string"
                           },
                           "severity": {
                               "type": "string"
                           },
                           "signalType": {
                               "type": "string"
                           },
                           "monitorCondition": {
                               "type": "string"
                           },
                           "monitoringService": {
                               "type": "string"
                           },
                           "alertTargetIDs": {
                               "type": "array",
                               "items": {
                                   "type": "string"
                               }
                           },
                           "originAlertId": {
                               "type": "string"
                           },
                           "firedDateTime": {
                               "type": "string"
                           },
                           "resolvedDateTime": {
                               "type": "string"
                           },
                           "description": {
                               "type": "string"
                           },
                           "essentialsVersion": {
                               "type": "string"
                           },
                           "alertContextVersion": {
                               "type": "string"
                           }
                       }
                   },
                   "alertContext": {
                       "type": "object",
                       "properties": {}
                   }
               }
           }
       }
   }
   

   

9. (اختياري). يمكنك تخصيص إعلام التنبيه عن طريق استخراج معلومات حول المورد المتأثر الذي تم تشغيل التنبيه عليه، على سبيل المثال، علامات المورد. يمكنك بعد ذلك تضمين علامات الموارد هذه في حمولة التنبيه واستخدام المعلومات في التعبيرات المنطقية لإرسال الإعلامات. للقيام بهذه الخطوة، سنقوم بما يلي:

   • إنشاء متغير لمعرفات الموارد المتأثرة.
   • تقسيم معرف المورد إلى صفيف حتى نتمكن من استخدام عناصره المختلفة (على سبيل المثال، الاشتراك ومجموعة الموارد).
   • استخدم موصل Azure Resource Manager لقراءة بيانات تعريف المورد.
   • قم بإحضار علامات المورد، والتي يمكن استخدامها بعد ذلك في الخطوات اللاحقة لتطبيق المنطق.

   1. حدد +>إضافة إجراء لإدراج خطوة جديدة.

   2. في حقل البحث، ابحث عن المتغير Initialize وحدده.

   3. في حقل الاسم ، أدخل اسم المتغير، مثل AffectedResource.

   4. في حقل النوع، حدد صفيف.

   5. في حقل القيمة ، حدد إضافة محتوى ديناميكي. حدد علامة التبويب Expression وأدخل السلسلة split(triggerBody()?['data']?['essentials']?['alertTargetIDs'][0], '/').

      

   6. حدد +>إضافة إجراء لإدراج خطوة أخرى.

   7. في حقل البحث، ابحث عن Azure Resource Manager>Read a resource وحدده.

   8. قم بتعبئة حقول إجراء Read a resource بقيم الصفيف من AffectedResource المتغير. في كل حقل من الحقول، حدد الحقل وقم بالتمرير لأسفل إلى إدخال قيمة مخصصة. حدد إضافة محتوى ديناميكي، ثم حدد علامة التبويب تعبير . أدخل السلاسل من هذا الجدول:

      الحقل	قيمة السلسلة
      الاشتراك	variables('AffectedResource')[2]
      مجموعة الموارد	variables('AffectedResource')[4]
      موفر المصادر	variables('AffectedResource')[6]
      معرف المورد القصير	concat(variables('AffectedResource')[7], '/', variables('AffectedResource')[8])
      إصدار واجهة برمجة تطبيقات العميل	إصدار واجهة برمجة تطبيقات نوع المورد

      للعثور على إصدار واجهة برمجة التطبيقات لنوع المورد، حدد ارتباط طريقة عرض JSON في الجانب الأيمن العلوي من صفحة نظرة عامة على المورد. يتم عرض صفحة Resource JSON مع ResourceID وإصدار API في أعلى الصفحة.

   يتضمن المحتوى الديناميكي الآن علامات من المورد المتأثر. يمكنك استخدام هذه العلامات عند تكوين الإعلامات كما هو موضح في الخطوات التالية.

10. إرسال رسالة بريد إلكتروني أو نشر رسالة Teams.

11. حدد +>إضافة إجراء لإدراج خطوة جديدة.

    

إرسال بريد إلكتروني

1. في حقل البحث، ابحث عن Outlook.

2. حدد Office 365 Outlook.

   

3. حدد إرسال بريد إلكتروني (V2) من قائمة الإجراءات.

4. سجل الدخول إلى Office 365 عندما تتم مطالبتك بإنشاء اتصال.

5. قم بإنشاء نص البريد الإلكتروني عن طريق إدخال نص ثابت وتضمين المحتوى المأخوذ من حمولة التنبيه عن طريق اختيار الحقول من قائمة المحتوى الديناميكي. على سبيل المثال:

   • التنبيه لديه حالة مراقبة: حدد monitorCondition من قائمة المحتوى الديناميكي.
   • تاريخ التشغيل: حدد "firedDateTime " من قائمة المحتوى الديناميكي.
   • الموارد المتأثرة: حدد alertTargetIDs من قائمة المحتوى الديناميكي.

6. في حقل الموضوع ، قم بإنشاء نص الموضوع عن طريق إدخال نص ثابت وتضمين المحتوى المأخوذ من حمولة التنبيه عن طريق اختيار الحقول من قائمة المحتوى الديناميكي. على سبيل المثال:

   • تنبيه: حدد alertRule من قائمة المحتوى الديناميكي.
   • مع الخطورة: حدد الخطورة من قائمة المحتوى الديناميكي.
   • لديه شرط: حدد monitorCondition من قائمة المحتوى الديناميكي.

7. أدخل عنوان البريد الإلكتروني لإرسال التنبيه إلى الحقل إلى .

8. حدد حفظ.

   

لقد أنشأت تطبيقا منطقيا يرسل بريدا إلكترونيا إلى العنوان المحدد، مع تفاصيل من التنبيه الذي قام بتشغيله.

الخطوة التالية هي إنشاء مجموعة إجراءات لتشغيل تطبيق المنطق الخاص بك.

نشر رسالة Teams

1. في حقل البحث، ابحث عن Microsoft Teams.

2. حدد Microsoft Teams.

   

3. حدد نشر رسالة في دردشة أو قناة من قائمة الإجراءات.

4. سجل الدخول إلى Teams عندما تتم مطالبتك بإنشاء اتصال.

5. حدد User من القائمة المنسدلة Post as .

6. حدد Group chat من القائمة المنسدلة Post in .

7. حدد مجموعتك من القائمة المنسدلة Group chat .

8. قم بإنشاء نص الرسالة في حقل الرسالة عن طريق إدخال نص ثابت وتضمين المحتوى المأخوذ من حمولة التنبيه عن طريق اختيار الحقول من قائمة المحتوى الديناميكي. على سبيل المثال:

   1. تنبيه: حدد alertRule من قائمة المحتوى الديناميكي.
   2. مع الخطورة: حدد الخطورة من قائمة المحتوى الديناميكي.
   3. تم إطلاقه في: حدد "firedDateTime " من قائمة المحتوى الديناميكي.
   4. أضف المزيد من الحقول وفقا لمتطلباتك.

9. حدد حفظ.

   

لقد أنشأت تطبيقا منطقيا يرسل رسالة Teams إلى المجموعة المحددة، مع تفاصيل من التنبيه الذي قام بتشغيله.

الخطوة التالية هي إنشاء مجموعة إجراءات لتشغيل تطبيق المنطق الخاص بك.

إنشاء مجموعة إجراءات

لتشغيل تطبيق المنطق الخاص بك، قم بإنشاء مجموعة إجراءات. ثم قم بإنشاء تنبيه يستخدم مجموعة الإجراءات هذه.

1. انتقل إلى صفحة Azure Monitor وحدد Alerts من الجزء الموجود على اليسار.

2. حدد إنشاء مجموعات> الإجراءات.

3. حدد قيم الاشتراك ومجموعة الموارد والمنطقة.

4. أدخل اسما لاسم مجموعة الإجراءات واسم العرض.

5. حدد علامة التبويب إجراءات.

   

6. في علامة التبويب Actions ضمن Action type، حدد Logic App.

7. في قسم Logic App ، حدد تطبيق المنطق الخاص بك من القائمة المنسدلة.

8. قم بتعيين Enable common alert schema إلى Yes. إذا حددت لا، يحدد نوع التنبيه مخطط التنبيه المستخدم. لمزيد من المعلومات حول مخططات التنبيه، راجع مخططات التنبيه الخاصة بالسياق.

9. حدد موافق.

10. أدخل اسماً في حقل الاسم.

11. اختر إنشاء>مراجعة + إنشاء.

    

اختبار مجموعة الإجراءات الخاصة بك

1. حدد مجموعة الإجراءات الخاصة بك.

2. في قسم Logic App ، حدد Test action group (preview).

   

3. حدد نموذج نوع تنبيه من القائمة المنسدلة تحديد نوع العينة.

4. حدد اختبار.

   

   يتم إرسال البريد الإلكتروني التالي إلى الحساب المحدد:

   

إنشاء قاعدة باستخدام مجموعة الإجراءات

1. إنشاء قاعدة لأحد مواردك.

2. في علامة التبويب إجراءات في القاعدة، اختر تحديد مجموعات الإجراءات.

3. حدد مجموعة الإجراءات من القائمة.

4. اختر تحديد.

5. إنهاء إنشاء القاعدة الخاصة بك.

   

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

• تعرف على المزيد حول مجموعات الإجراءات
• تعرف على المزيد حول مخطط التنبيه الشائع