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

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

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

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

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

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

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

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

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

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

5. حدد «استعراض + إنشاء»>و«إنشاء».

6. حدد Go to resource بعد انتهاء التوزيع.

   

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

   

8. الصق مخطط التنبيه الشائع في حقل Request Body JSON Schema من 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>ابحث عن مورد وحدده.

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

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

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

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

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. حدد Action groups>Create.

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

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

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

   

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

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

8. قم بتعيين تمكين مخطط التنبيه الشائع إلى نعم. إذا حددت لا، يحدد نوع التنبيه مخطط التنبيه المستخدم. لمزيد من المعلومات حول مخططات التنبيه، راجع مخططات التنبيه الخاصة بالسياق.

9. حدد "OK".

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

11. حدد «استعراض + إنشاء»>و«إنشاء».

    

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

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

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

   

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

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

   

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

   

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

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

2. في علامة التبويب Actions في القاعدة، اختر Select action groups.

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

4. اختر «Select» .

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

   

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

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