مراقبة البيانات التشخيصية لسير العمل وجمعها في Azure Logic Apps

ينطبق على: Azure Logic Apps (الاستهلاك + قياسي)

للحصول على بيانات أكثر ثراء لتصحيح أخطاء مهام سير العمل وتشخيصها في Azure Logic Apps، يمكنك تسجيل بيانات وقت تشغيل سير العمل والأحداث، مثل أحداث المشغل وأحداث التشغيل وأحداث الإجراء، التي يمكنك إرسالها إلى مساحة عمل Log Analytics أو حساب تخزين Azure أو مركز أحداث Azure أو وجهة شريك أخرى أو جميع هذه الوجهات عند إعداد سجلات Azure Monitor واستخدامها.

ملاحظة

سجلات موارد Azure Monitor ليست عديمة الخسارة بنسبة 100٪. تستند سجلات الموارد إلى مخزن وبنية إعادة توجيه مصممة لنقل بيتابايت من البيانات في اليوم على نطاق واسع بأسعار معقولة. تتضمن هذه الإمكانية التكرار المضمن وإعادة المحاولة عبر النظام الأساسي، ولكنها لا توفر ضمانات المعاملات. قد تقلل مراقبة المعاملات من موثوقية وأداء الخدمة المراقبة. أيضا، يجب أن توقف أخطاء التسجيل العابرة الخدمة الأولية عندما لا تتمكن من تأكيد تسليم السجل. كلما تمكن فريق Azure Monitor من تأكيد مصدر مستمر لفقدان البيانات، يفكر الفريق في الدقة والوقاية من أولويته القصوى. ومع ذلك، قد لا تزال خسائر البيانات الصغيرة تحدث بسبب مشكلات الخدمة المؤقتة غير المتكررة الموزعة عبر Azure، ولا يمكن اكتشاف كل شيء.

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

Consumption

1. في إنشاء تطبيق منطق الاستهلاك، قم بتمكين Log Analytics وحدد مساحة عمل Log Analytics.

   -أو-

   بالنسبة لتطبيق منطق الاستهلاك الموجود، قم بتثبيت حل Logic Apps Management في مساحة عمل Log Analytics. يوفر هذا الحل معلومات مجمعة لتشغيل تطبيق المنطق الخاص بك، ويتضمن تفاصيل محددة مثل الحالة ووقت التنفيذ وحالة إعادة الإرسال ومعرفات الارتباط.

2. أضف إعداد تشخيص لتمكين جمع البيانات.

3. عرض حالة تشغيل سير العمل.

4. إرسال بيانات التشخيص إلى Azure Storage وAzure Event Hubs.

5. تضمين خصائص مخصصة في بيانات تتبع الاستخدام.

قياسي

1. أضف إعداد تشخيص لتمكين جمع البيانات.

2. عرض حالة تشغيل سير العمل.

3. إرسال بيانات التشخيص إلى Azure Storage وAzure Event Hubs.

4. تضمين خصائص مخصصة في بيانات تتبع الاستخدام.

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

• حساب واشتراك Azure. إذا لم يكن لديك اشتراك، فيجب التسجيل للحصول على حساب Azure مجاني.

  بالنسبة لمورد تطبيق منطق الاستهلاك، تحتاج إلى أذونات مالك اشتراك Azure أو المساهم حتى تتمكن من تثبيت حل Logic Apps Management من Azure Marketplace. للاطلاع على مزيد من المعلومات، راجع الوثائق التالية:

  • إذن الشراء - Azure Marketplace الشراء

  • أدوار Azure وأدوار Azure AD وأدوار مسؤول الاشتراك الكلاسيكي

• المورد الوجهة للمكان الذي تريد إرسال بيانات التشخيص إليه:

  • مساحة عمل Log Analytics

  • ⁧⁩حساب تخزين Azure⁧⁩

  • مركز أحداث Azure

• مورد تطبيق المنطق وسير العمل

تمكين Log Analytics

Consumption

بالنسبة لتطبيق منطق الاستهلاك، تحتاج أولا إلى تمكين Log Analytics.

تمكين Log Analytics عند إنشاء تطبيق المنطق

1. في مدخل Microsoft Azure، في جزء Create Logic App ، اتبع الخطوات التالية:

   1. ضمن Plan، تأكد من تحديد Consumption بحيث تظهر خيارات مهام سير عمل Consumption فقط.

   2. لتمكين تحليلات السجل، حدد نعم.

   3. من قائمة مساحة عمل Log Analytics ، حدد مساحة العمل حيث تريد إرسال البيانات من تشغيل سير العمل الخاص بك.

      

2. قم بإنهاء إنشاء مورد تطبيق المنطق الخاص بك.

   عند الانتهاء، يقترن تطبيق المنطق بمساحة عمل Log Analytics. تقوم هذه الخطوة أيضاً بتثبيت حل Logic Apps Management تلقائياً في مساحة العمل الخاصة بك.

3. بعد تشغيل سير العمل، اعرض حالة تشغيل سير العمل.

تثبيت حل Logic Apps Management

إذا قمت بتشغيل Log Analytics عند إنشاء مورد تطبيق المنطق الخاص بك، فتخط هذا القسم. لديك بالفعل حل Logic Apps Management مثبت في مساحة عمل Log Analytics. وإلا، تابع الخطوات التالية لتطبيق منطق الاستهلاك الموجود:

1. في مربع البحث في مدخل Microsoft Azure ، أدخل مساحات عمل تحليلات السجل، وحدد مساحات عمل Log Analytics من النتائج.

   

2. ضمن تسجيل مساحات عمل Analytics، حدد مساحة العمل الخاصة بك.

   

3. في جزء نظرة عامة ضمن بدء العمل باستخدام Log Analytics>تكوين حلول المراقبة، حدد عرض الحلول.

   

4. ضمن نظرة عامة، حدد إضافة، الذي يضيف حلا جديدا إلى مساحة العمل الخاصة بك.

5. بعد فتح صفحة Marketplace ، في مربع البحث، أدخل logic apps management، وحدد Logic Apps Management.

   

6. في لوحة Logic Apps Management، من القائمة إنشاء، حدد Logic Apps Management.

   

7. في جزء إنشاء حل Logic Apps Management (إصدار أولي)، حدد مساحة عمل Log Analytics حيث تريد تثبيت الحل. تحديد مراجعة + إنشاء، راجع المعلومات وتحديد إنشاء.

   

   بعد أن يوزع Azure الحل إلى مجموعة موارد Azure التي تحتوي على مساحة عمل Log Analytics، يظهر الحل في جزء ملخص مساحة العمل ضمن نظرة عامة.

   

قياسي

بالنسبة لتطبيق المنطق القياسي، يمكنك المتابعة مع إضافة إعداد تشخيص. لا توجد خطوات متطلبات أساسية أخرى ضرورية لتمكين Log Analytics، ولا ينطبق حل Logic Apps Management على تطبيقات المنطق القياسية.

إضافة إعداد تشخيص

Consumption

1. في مدخل Microsoft Azure، افتح مورد تطبيق منطق الاستهلاك.

2. في قائمة مورد تطبيق المنطق، ضمن Monitoring، حدد Diagnostic settings. في صفحة Diagnostic settings ، حدد Add diagnostic setting.

   

3. بالنسبة إلى اسم إعداد التشخيص، قم بتوفير الاسم الذي تريده للإعداد.

4. ضمن فئات السجلات>، حدد أحداث تشخيص وقت تشغيل سير العمل. ضمن المقاييس، حدد AllMetrics.

5. ضمن تفاصيل الوجهة، حدد وجهة واحدة أو أكثر، استنادا إلى المكان الذي تريد إرسال السجلات إليه.

   الوجهة	الاتجاهات
   إرسال إلى مساحة عمل Log Analytics	حدد اشتراك Azure لمساحة عمل Log Analytics ومساحة العمل.
   «Archive to» إلى حساب موقع التخزين	حدد اشتراك Azure لحساب تخزين Azure وحساب التخزين. لمزيد من المعلومات، راجع إرسال بيانات التشخيص إلى Azure Storage وAzure Event Hubs.
   «Stream to» مركز أحداث	حدد اشتراك Azure لمساحة اسم مركز الحدث ومركز الأحداث واسم نهج مركز الأحداث. لمزيد من المعلومات، راجع إرسال بيانات التشخيص إلى Azure Storage ومراكز أحداث Azureوتكاملات شركاء Azure Monitor.
   إرسال إلى حل الشريك	حدد اشتراك Azure والوجهة. لمزيد من المعلومات، راجع نظرة عامة على Azure Native ISV Services.

   يحدد المثال التالي مساحة عمل Log Analytics كوجهة:

   

6. لإنهاء إضافة إعداد التشخيص، حدد حفظ.

قياسي

1. في مدخل Microsoft Azure، افتح مورد تطبيق المنطق القياسي.

2. في قائمة مورد تطبيق المنطق، ضمن Monitoring، حدد Diagnostic settings. في صفحة Diagnostic settings ، حدد Add diagnostic setting.

   

3. بالنسبة إلى اسم إعداد التشخيص، قم بتوفير الاسم الذي تريده للإعداد.

4. ضمن فئات السجلات>، حدد سجلات وقت تشغيل سير العمل. ضمن المقاييس، حدد AllMetrics.

5. ضمن تفاصيل الوجهة، حدد وجهة واحدة أو أكثر، استنادا إلى المكان الذي تريد إرسال السجلات إليه.

   الوجهة	الاتجاهات
   إرسال إلى مساحة عمل Log Analytics	حدد اشتراك Azure لمساحة عمل Log Analytics ومساحة العمل.
   «Archive to» إلى حساب موقع التخزين	حدد اشتراك Azure لحساب تخزين Azure وحساب التخزين. لمزيد من المعلومات، راجع إرسال بيانات التشخيص إلى Azure Storage وAzure Event Hubs.
   «Stream to» مركز أحداث	حدد اشتراك Azure لمساحة اسم مركز الحدث ومركز الأحداث واسم نهج مركز الأحداث. لمزيد من المعلومات، راجع إرسال بيانات التشخيص إلى Azure Storage وAzure Event Hubsوتكاملات شركاء Azure Monitor.
   إرسال إلى حل الشريك	حدد اشتراك Azure والوجهة. لمزيد من المعلومات، راجع نظرة عامة على Azure Native ISV Services.

   يحدد المثال التالي مساحة عمل Log Analytics كوجهة:

   

6. اختياريا، لتضمين بيانات تتبع الاستخدام لأحداث مثل Host.Startup و Host.Bindings و Host.LanguageWorkerConfig، حدد Function Application Logs. لمزيد من المعلومات، راجع مراقبة وظائف Azure باستخدام سجلات Azure Monitor.

7. لإنهاء إضافة إعداد التشخيص، حدد حفظ.

ترسل Azure Logic Apps الآن بيانات تتبع الاستخدام حول تشغيل سير العمل الخاص بك إلى مساحة عمل Log Analytics.

ملاحظة

بعد تمكين إعدادات التشخيص، قد لا تتدفق بيانات التشخيص لمدة تصل إلى 30 دقيقة إلى السجلات في الوجهة المحددة، مثل Log Analytics أو حساب التخزين أو مركز الأحداث. يعني هذا التأخير أن بيانات التشخيص من هذه الفترة الزمنية قد لا تكون موجودة لمراجعتها. قد لا تظهر الأحداث المكتملة والخصائص المتعقبة في مساحة عمل Log Analytics لمدة 10-15 دقيقة.

عرض حالة تشغيل سير العمل

Consumption

بعد تشغيل سير العمل الخاص بك، يمكنك عرض البيانات حول تلك التي يتم تشغيلها في مساحة عمل Log Analytics.

1. في مدخل Microsoft Azure، افتح مساحة عمل Log Analytics.

2. في قائمة مساحة العمل، ضمن كلاسيكي، حدد ملخص مساحة العمل. في صفحة Overview ، حدد Logic Apps Management.

   ملاحظة

   إذا لم يظهر تجانب Logic Apps Management النتائج على الفور بعد التشغيل، فحاول تحديد تحديث، أو انتظر لفترة قصيرة قبل المحاولة مرة أخرى.

   

   تعرض صفحة الملخص مهام سير العمل المجمعة حسب الاسم أو حسب حالة التنفيذ. تعرض الصفحة أيضا تفاصيل حول حالات الفشل في الإجراءات أو المشغلات لتشغيل سير العمل.

   

3. لعرض جميع عمليات التشغيل لسير عمل أو حالة معينة، حدد الصف لسير العمل أو الحالة هذا.

   يوضح هذا المثال جميع عمليات التشغيل لسير عمل معين:

   

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

   

4. لتصفية النتائج، يمكنك إجراء التصفية من جانب العميل والخادم.

   • عامل التصفية من جانب العميل: بالنسبة لكل عمود، حدد عوامل التصفية التي تريدها، على سبيل المثال:

     

   • عامل التصفية من جانب الخادم: لتحديد نافذة زمنية معينة أو للحد من عدد عمليات التشغيل التي تظهر، استخدم عنصر تحكم النطاق في أعلى الصفحة. بشكل افتراضي، يظهر 1000 سجل فقط في كل مرة.

     

5. لعرض جميع الإجراءات وتفاصيلها لتشغيل معين، حدد صف تشغيل سير عمل تطبيق المنطق.

   يوضح المثال التالي جميع الإجراءات والمشغلات لتشغيل سير عمل تطبيق منطقي معين:

   

قياسي

1. في مدخل Microsoft Azure، افتح مساحة عمل Log Analytics.

2. في قائمة التنقل في مساحة العمل، حدد Logs.

3. في علامة التبويب استعلام جديد، في العمود الأيسر، ضمن الجداول، قم بتوسيع LogManagement، وحدد LogicAppWorkflowRuntime.

   في الجزء الأيمن، ضمن النتائج، يعرض الجدول السجلات المتعلقة بالأحداث التالية:

   • تم تشغيل سير العمل
   • WorkflowRunCompleted
   • WorkflowTriggerStarted
   • WorkflowTriggerEnded
   • WorkflowActionStarted
   • WorkflowActionCompleted
   • WorkflowBatchMessageSend
   • WorkflowBatchMessageRelease

   بالنسبة للأحداث المكتملة، ينشر عمود EndTime الطابع الزمني لوقت انتهاء تلك الأحداث. تساعدك هذه القيمة على تحديد المدة بين حدث البدء والحدث المكتمل.

   

نموذج الاستعلامات

في جزء استعلام مساحة عمل Log Analytics، يمكنك إدخال الاستعلامات الخاصة بك للعثور على بيانات معينة، على سبيل المثال:

• حدد جميع الأحداث لمعرف تشغيل سير عمل معين:

  LogicAppWorkflowRuntime
  | where RunId == "08585258189921908774209033046CU00"
  

• سرد جميع الاستثناءات:

  LogicAppWorkflowRuntime
  | where Error != ""
  | sort by StartTime desc
  

• تحديد الإجراءات التي شهدت عمليات إعادة المحاولة:

  LogicAppWorkflowRuntime
  | where RetryHistory != ""
  | sort by StartTime desc 
  

إرسال البيانات التشخيصية إلى Azure Storage ومركز الأحداث من Azure

إلى جانب سجلات Azure Monitor، يمكنك إرسال البيانات التي تم جمعها إلى وجهات أخرى، على سبيل المثال:

• أرشفة سجلات موارد Azure لحساب التخزين
• بثّ سجلات النظام الأساسي في Azure إلى مراكز الأحداث

يمكنك بعد ذلك الحصول على المراقبة في الوقت الحقيقي باستخدام بيانات تتبع الاستخدام والتحليلات من خدمات أخرى، مثل Azure Stream AnalyticsوPower BI، على سبيل المثال:

• دفق البيانات من مراكز الأحداث إلى Stream Analytics
• تحليل البيانات المتدفقة باستخدام Stream Analytics وإنشاء لوحة معلومات تحليلات في الوقت الحقيقي في Power BI

ملاحظة

تنطبق فترات الاستبقاء فقط عند استخدام حساب تخزين.

تضمين خصائص مخصصة في بيانات تتبع الاستخدام

في سير العمل الخاص بك، تتمتع المشغلات والإجراءات بالقدرة على إضافة الخصائص المخصصة التالية بحيث تظهر قيمها جنبا إلى جنب مع بيانات تتبع الاستخدام الصادرة في مساحة عمل Log Analytics.

معرف التعقب المخصص

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

إذا لم تحدد معرف التعقب المخصص هذا، يقوم Azure تلقائيا بإنشاء هذا المعرف وربط الأحداث عبر تشغيل سير العمل، بما في ذلك أي مهام سير عمل متداخلة يتم استدعاؤها من سير العمل الأصل. يمكنك تحديد هذا المعرف يدوياً في مشغل عن طريق تمرير عنوان x-ms-client-tracking-id بقيمة المعرف المخصص في طلب المشغل. يمكنك استخدام مشغل طلب أو مشغل HTTP أو مشغل يستند إلى خطاف الويب.

Consumption

قياسي

الخصائص المتعقبة

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

Consumption

قياسي

يمكن للخصائص المتعقبة تتبع مدخلات ومخرجات إجراء واحد فقط، ولكن يمكنك استخدام correlation خصائص الأحداث للربط عبر الإجراءات في تشغيل سير العمل.

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

لا يسمح بالخصائص المتعقبة في مشغل أو إجراء يحتوي على مدخلات آمنة أو مخرجات آمنة أو كليهما. كما لا يسمح لهم بالإشارة إلى مشغل أو إجراء آخر يحتوي على مدخلات آمنة أو مخرجات آمنة أو كليهما.

توضح الأمثلة التالية مكان ظهور الخصائص المخصصة في مساحة عمل Log Analytics:

Consumption

1. في قائمة مساحة عمل Log Analytics، ضمن Classic، حدد Workspace summary. في صفحة Overview ، حدد Logic Apps Management.

2. حدد صف سير العمل الذي تريد مراجعته.

3. في صفحة Runs ، في جدول Logic App Runs ، ابحث عن العمود Tracking ID وعمود Tracked Properties .

   

4. للبحث في الخصائص المتعقبة، استخدم عامل تصفية العمود. لعرض الخصائص، حدد عرض.

   

قياسي

يظهر معرف التعقب المخصص في العمود ClientTrackingId وتظهر الخصائص المتعقبة في العمود TrackedProperties ، على سبيل المثال:

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

• إنشاء استعلامات المراقبة والتعقب
• مراقبة رسائل B2B باستخدام سجلات Azure Monitor