مشاركة عبر

إعداد سجلات Azure Monitor وجمع بيانات التشخيص لرسائل B2B في Azure Logic Apps

  • مقالة

التطبيق على:Azure Logic Apps (Consumption)

إشعار

تنطبق هذه المقالة فقط على تطبيقات منطق «الاستهلاك». للحصول على معلومات حول مراقبة التطبيقات المنطقية القياسية، راجع تمكين أو فتح Application Insights بعد التوزيع للتطبيقات المنطقية القياسية.

بعد قيامك بإعداد اتصال B2B بين الشركاء التجاريين في حساب التكامل الخاص بك، يمكن لهؤلاء الشركاء تبادل الرسائل باستخدام بروتوكولات مثل AS2 وX12 وEDIFACT. للتحقق من عمل هذا الاتصال بالطريقة التي تتوقعها، يمكنك إعداد سجلات Azure Monitor لحساب التكامل الخاص بك. Azure Monitor تساعدك على مراقبة بيئاتك السحابية والمحلية بحيث يمكنك بسهولة الحفاظ على توفرها وأدائها. باستخدام سجلات Azure Monitor، يمكنك تسجيل وتخزين البيانات المتعلقة ببيانات وأحداث وقت التشغيل، مثل أحداث التشغيل، وتشغيل الأحداث، وأحداث الإجراءات في مساحة عمل Log Analytics. بالنسبة للرسائل، يجمع التسجيل أيضاً معلومات مثل:

  • عدد الرسائل وحالتها
  • حالة شكر وتقدير
  • الترابط بين الرسائل والإقرارات
  • وصف تفصيلي للخطأ لحالات الفشل

يتيح لك Azure Monitor إنشاء استعلامات السجل لمساعدتك في العثور على هذه المعلومات ومراجعتها. يمكنك أيضاً استخدام بيانات التشخيص هذه مع خدمات Azure الأخرى، مثل Azure Storage ومراكز الأحداث من Azure.

لإعداد التسجيل لحساب التكامل الخاص بك، قم بتثبيت حل Logic Apps B2B في مدخل Microsoft Azure. يوفر هذا الحل معلومات مجمعة لأحداث رسائل B2B. بعد ذلك، لتمكين التسجيل وإنشاء استعلامات لهذه المعلومات، قم بإعداد سجلات مراقبة Azure.

توضح هذه المقالة كيفية تمكين تسجيل Azure Monitor لحساب التكامل الخاص بك.

إشعار

تم تحديث هذه المقالة مؤخرًا لاستخدام مصطلح سجلات مراقبة Azure بدلاً من تحليلات السجلات. لا تزال بيانات السجل مخزنة في مساحة عمل Log Analytics ولا يزال يتم جمعها وتحليلها بواسطة نفس خدمة Log Analytics. نحن نحدِّث المصطلحات لتعكس دور السجلات في Azure Monitorعلى نحوٍ أفضل. راجع تغييرات مصطلحات Azure Monitor للحصول على التفاصيل.

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

تثبيت حل Logic Apps B2B

قبل أن تتمكن سجلات Azure Monitor من تتبع رسائل B2B لتطبيقك المنطقي، أضف حل Logic Apps B2B إلى مساحة عمل Log Analytics.

  1. في مربع البحث في مدخل Microsoft Azure، أدخل log analytics workspaces، ثم حدد Log Analytics workspaces.

    حدد

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

    حدد مساحة عمل Log Analytics الخاصة بك

  3. في جزء Overview، ضمن Get started with Log Analytics>Configure monitoring solutions، حدد View solutions.

    في جزء Overview، حدد

  4. في جزء Overview، حدد Add.

    في جزء Overview، أضف حلاً جديداً

  5. بعد فتح Marketplace، في مربع البحث، أدخل logic apps b2bوحدد Logic Apps B2B.

    من Marketplace، حدد

  6. في جزء وصف الحل، حدد Create.

    حدد

  7. قم بمراجعة وتأكيد مساحة عمل Log Analytics حيث تريد تثبيت الحل، وحدد Create مرة أخرى.

    حدد

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

    جزء ملخص مساحة العمل

إعداد سجلات Azure مراقبة

يمكنك تمكين تسجيل Azure Monitor مباشرة من حساب التكامل الخاص بك.

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

    ابحث عن حساب التكامل الخاص بك وحدده

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

    ضمن

  3. لإنشاء الإعداد، اتبع الخطوات التالية:

    1. أدخل اسماً للإعداد.

    2. حدد Send to Log Analytics .

    3. بالنسبة إلى الاشتراك، حدد اشتراك Azure المرتبط بمساحة عمل Log Analytics.

    4. بالنسبة إلى Log Analytics Workspace، حدد مساحة العمل التي تريد استخدامها.

    5. ضمن log، حدد فئة IntegrationAccountTrackingEvents، التي تحدد فئة الحدث الذي تريد تسجيله.

    6. عندما تنتهي، حدد حفظ.

    على سبيل المثال:

    إعداد سجلات Azure Monitor لتجميع بيانات التشخيص

عرض حالة الرسالة

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

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

  2. في قائمة مساحة العمل الخاصة بك، حدد Workspace summary>Logic Apps B2B.

    جزء ملخص مساحة العمل

    إشعار

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

    بشكل افتراضي، يعرض مربع Logic Apps B2B البيانات على أساس يوم واحد. لتغيير نطاق البيانات إلى فاصل زمني مختلف، حدد عنصر التحكم في النطاق في الجزء العلوي من الصفحة:

    تغيير الفاصل الزمني

  3. بعد ظهور لوحة معلومات حالة الرسالة، يمكنك عرض المزيد من التفاصيل لنوع رسالة معين، والذي يعرض البيانات بناءً على يوم واحد. حدد المربع المخصص لـ AS2 أو X12 أو EDIFACT.

    عرض حالات الرسائل

    تظهر قائمة بالرسائل للبلاط الذي اخترته. على سبيل المثال، إليك ما قد تبدو عليه قائمة رسائل AS2:

    حالات وتفاصيل رسائل AS2

    لمعرفة المزيد حول خصائص كل نوع رسالة، راجع أوصاف خصائص الرسالة هذه:

أوصاف الخصائص وتنسيقات الأسماء لرسائل AS2 وX12 وEDIFACT

لكل نوع رسالة، فيما يلي أوصاف الخصائص وتنسيقات الأسماء لملفات الرسائل التي تم تنزيلها.

أوصاف خصائص رسالة AS2

فيما يلي أوصاف الخصائص لكل رسالة AS2.

الخاصية ‏‏الوصف
المرسل الشريك الضيف المحدد في Receive Settings، أو الشريك المضيف المحدد في Send Settings لاتفاقية AS2
المتلقي الشريك المضيف المحدد في إعدادات الاستلام، أو الشريك الضيف المحدد في إعدادات الإرسال لاتفاقية AS2
Logic App التطبيق المنطقي حيث يتم إعداد إجراءات AS2
الحالة حالة رسالة AS2
نجاح = تلقي أو إرسال رسالة AS2 صالحة. لم يتم إعداد MDN.
نجاح = تلقي أو إرسال رسالة AS2 صالحة. إعداد MDN واستلامه أو إرسال MDN.
فشل = تلقيت رسالة AS2 غير صالحة. لم يتم إعداد MDN.
معلق = تم استلام أو إرسال رسالة AS2 صالحة. تم إعداد MDN، ومن المتوقع MDN.
ACK حالة رسالة MDN
مقبول = استلمت أو أرسلت MDN موجباً.
معلق = في انتظار استلام أو إرسال MDN.
مرفوض = تم استلام أو إرسال MDN سلبي.
غير مطلوب = لم يتم إعداد MDN في الاتفاقية.
الاتجاه اتجاه رسالة AS2
معرف التتبع المعرف الذي يربط بين جميع المشغلات والإجراءات في تطبيق منطقي
معرف الرسالة معرف رسالة AS2 من رؤوس رسائل AS2
طابع زمني الوقت الذي قام فيه إجراء AS2 بمعالجة الرسالة

أوصاف خصائص رسالة X12

فيما يلي أوصاف الخصائص لكل رسالة X12.

الخاصية ‏‏الوصف
المرسل الشريك الضيف المحدد في Receive Settings، أو الشريك المضيف المحدد في Send Settings لاتفاقية X12
المتلقي الشريك المضيف المحدد في إعدادات الاستلام، أو الشريك الضيف المحدد في إعدادات الإرسال لاتفاقية X12
Logic App التطبيق المنطقي حيث يتم إعداد إجراءات X12
الحالة حالة رسالة X12
نجاح = تلقي أو إرسال رسالة X12 صالحة. لم يتم إعداد ack الوظيفية.
نجاح = تلقي أو إرسال رسالة X12 صالحة. يتم إعداد وتلقي ack الوظيفية، أو إرسال ack وظيفي.
فشل = تم استلام أو إرسال رسالة X12 غير صالحة.
معلق = تم استلام أو إرسال رسالة X12 صالحة. تم إعداد ack الوظيفية، ومن المتوقع ack الوظيفية.
ACK حالة Ack الوظيفية (997)
Accepted = تم استلام أو إرسال ack وظيفي إيجابي.
Rejected = تم استلام أو إرسال ack وظيفي سلبي.
Pending = توقع ack وظيفي ولكن لم يتم استلامه.
Pending = تم إنشاء ack وظيفي ولكن لا يمكن إرسالها إلى الشريك.
Not Required = لم يتم إعداد Ack الوظيفي.
الاتجاه اتجاه رسالة X12
معرف التتبع المعرف الذي يربط بين جميع المشغلات والإجراءات في تطبيق منطقي
نوع الرسالة نوع رسالة EDI X12
ICN رقم التحكم في التبادل لرسالة X12
TSCN رقم التحكم في مجموعة العمليات لرسالة X12
طابع زمني الوقت الذي قام فيه إجراء X12 بمعالجة الرسالة

أوصاف خصائص رسالة EDIFACT

فيما يلي أوصاف الخصائص لكل رسالة EDIFACT.

الخاصية ‏‏الوصف
المرسل الشريك الضيف المحدد في Receive Settings، أو الشريك المضيف المحدد في Send Settings لاتفاقية EDIFACT
المتلقي الشريك المضيف المحدد في Receive Settings، أو الشريك الضيف المحدد في Send Settings لاتفاقية EDIFACT
Logic App التطبيق المنطقي حيث تم إعداد إجراءات EDIFACT
الحالة حالة رسالة EDIFACT
Success = تلقيت أو أرسلت رسالة EDIFACT صالحة. لم يتم إعداد ack الوظيفية.
Success = تلقيت أو أرسلت رسالة EDIFACT صالحة. يتم إعداد وتلقي ack الوظيفية، أو إرسال ack وظيفي.
فشل = تم تلقي رسالة EDIFACT غير صحيحة أو إرسالها
Pending = تم استلام أو إرسال رسالة EDIFACT صالحة. تم إعداد ack الوظيفية، ومن المتوقع ack الوظيفية.
ACK حالة Ack الوظيفية (CONTRL)
Accepted = تم استلام أو إرسال ack وظيفي إيجابي.
Rejected = تم استلام أو إرسال ack وظيفي سلبي.
Pending = توقع ack وظيفي ولكن لم يتم استلامه.
Pending = تم إنشاء ack وظيفي ولكن لا يمكن إرسالها إلى الشريك.
Not Required = لم يتم إعداد Ack الوظيفي.
الاتجاه اتجاه الرسالة EDIFACT
معرف التتبع المعرف الذي يربط بين جميع المشغلات والإجراءات في تطبيق منطقي
نوع الرسالة نوع الرسالة EDIFACT
ICN رقم التحكم في التبادل لرسالة EDIFACT
TSCN رقم التحكم في مجموعة العمليات لرسالة EDIFACT
طابع زمني الوقت الذي قام فيه إجراء EDIFACT بمعالجة الرسالة

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