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

مقالة
04/16/2022
قراءة خلال 7 دقائق

ملاحظة

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

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

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

توضح هذه المقالة كيفية تمكين Log Analytics على التطبيقات المنطقية الجديدة والتطبيقات المنطقية الموجودة، وكيفية تثبيت حل إدارة التطبيقات المنطقية وإعداده، وكيفية إعداد استعلامات لسجلات Azure Monitor وإنشائها.

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

حساب واشتراك Azure. إذا لم يكن لديك اشتراك، فيجب التسجيل للحصول على حساب Azure مجاني.
أذونات مالك اشتراك Azure أو المساهم حتى تتمكن من تثبيت حل إدارة التطبيقات المنطقية من Azure Marketplace. لمزيد من المعلومات، راجع إذن الشراء - Azure Marketplace الشراء وأدوار Azure - أدوار مسؤول الاشتراك الكلاسيكي وأدوار Azure وأدوار Azure AD.
مساحة عمل تحليلات السجل. إذا لم يكن لديك مساحة عمل، فتعرف على كيفية إنشاء مساحة عمل Log Analytics.

تمكين تحليلات السجل للتطبيقات المنطقية الجديدة

يمكنك تشغيل "إحصاءات السجل" عند إنشاء تطبيقك المنطقي.

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

تثبيت حل إدارة التطبيقات المنطقية

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

في مربع البحث الخاص بمدخل Azure، أدخل مساحات عمل تحليلات السجل. حدّد مساحات عمل Log Analytics.
ضمن مساحات عمل Log Analytics، حدد مساحة العمل.
في جزء نظرة عامة، ضمن بدء استخدام Log Analyticsتكوينحلول المراقبة>، حدد عرض الحلول.
ضمن نظرة عامة، حدد إضافة.
بعد فتح Marketplace ، في مربع البحث، أدخل إدارة التطبيقات المنطقية. حدد إدارة التطبيقات المنطقية.
في لوحة إدارة التطبيقات المنطقية، من القائمة إنشاء، حدد إدارة التطبيقات المنطقية.
في جزء إنشاء حلول إدارة التطبيقات المنطقية (معاينة)، حدد مساحة عمل Log Analytics حيث تريد تثبيت الحل. حدد مراجعة + إنشاء، ومراجعة معلوماتك، وحدد إنشاء.

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

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

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

ملاحظة

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

في مدخل Azure، ابحث عن تطبيقك المنطقي وحدده.
في قائمة التطبيق المنطقي، ضمن مراقبة، حدد إعدادات> التشخيصإضافة إعداد تشخيصي.
لإنشاء الإعداد، اتبع الخطوات التالية:
1. بالنسبة إلى اسم إعداد التشخيص، أدخل اسما للإعداد.
2. ضمن Destination details، حدد Send to Log Analytics workspace.
3. بالنسبة إلى الاشتراك، حدد اشتراك Azure المقترن بمساحة عمل Log Analytics.
4. بالنسبة إلى مساحة عمل Log Analytics، حدد مساحة العمل الخاصة بك.
5. ضمن LogsCategories>، حدد WorkflowRuntime، الذي يحدد فئة الحدث التي تريد تسجيلها.
6. ضمن المقاييس، حدد AllMetrics.
7. عند الانتهاء، حدد حفظ.
عند الانتهاء، يبدو الإصدار الخاص بك مشابها للمثال التالي:

عرض حالة تشغيل التطبيق المنطقي

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

في مدخل Azure، ابحث عن مساحة عمل Log Analytics وافتحها.
من القائمة مساحة العمل، ضمن عام، حدد ملخص> مساحة العملإدارة التطبيقات المنطقية.

ملاحظة

إذا لم تعرض لوحة إدارة التطبيقات المنطقية النتائج على الفور بعد الجري، فحاول تحديد تحديث أو انتظر لفترة قصيرة قبل المحاولة مرة أخرى.

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

في ما يلي مثال يوضح جميع عمليات التشغيل لتطبيق منطقي معين:

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

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

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

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

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

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

Send data to Azure storage account or event hub

Azure Monitor diagnostics events

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

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

فيما يلي مثال يوضح كيف يتضمن تعريف إجراء تهيئة المتغير خصائص متعقبة من إدخال الإجراء حيث يكون الإدخال صفيفا وليس سجلا.
```
{
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "ConnectorName", 
               "type": "String", 
               "value": "SFTP-SSH" 
            }
         ]
      },
      "runAfter": {},
      "trackedProperties": { 
         "myTrackedPropertyName": "@action().inputs.variables[0].value"
      }
   }
}
```
يوضح هذا المثال خصائص متعددة تم تعقبها:
```
"HTTP": {
   "type": "Http",
   "inputs": {
      "body": "@triggerBody()",
      "headers": {
         "Content-Type": "application/json"
      },
      "method": "POST",
      "uri": "http://store.fabrikam.com",
   },
   "runAfter": {},
   "trackedProperties": {
      "myActionHTTPStatusCode": "@action()['outputs']['statusCode']",
      "myActionHTTPValue": "@action()['outputs']['body']['<content>']",
      "transactionId": "@action()['inputs']['body']['<content>']"
   }
}
```

يوضح هذا المثال كيفية تضمين ActionCompleted الحدث للسمات clientTrackingId والسمات trackedProperties :

{
   "time": "2016-07-09T17:09:54.4773148Z",
   "workflowId": "/subscriptions/XXXXXXXXXXXXXXX/resourceGroups/MyResourceGroup/providers/Microsoft.Logic/workflows/MyLogicApp",
   "resourceId": "/subscriptions/<subscription-ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Logic/workflows/MyLogicApp/runs/<run-ID>/actions/Http",
   "category": "WorkflowRuntime",
   "level": "Information",
   "operationName": "Microsoft.Logic/workflows/workflowActionCompleted",
   "properties": {
      "$schema": "2016-06-01",
      "startTime": "2016-07-09T17:09:53.4336305Z",
      "endTime": "2016-07-09T17:09:53.5430281Z",
      "status": "Succeeded",
      "code": "OK",
      "resource": {
         "subscriptionId": "<subscription-ID>",
         "resourceGroupName": "MyResourceGroup",
         "workflowId": "<logic-app-workflow-ID>",
         "workflowName": "MyLogicApp",
         "runId": "08587361146922712057",
         "location": "westus",
         "actionName": "Http"
      },
      "correlation": {
         "actionTrackingId": "e1931543-906d-4d1d-baed-dee72ddf1047",
         "clientTrackingId": "<my-custom-tracking-ID>"
      },
      "trackedProperties": {
         "myTrackedPropertyName": "<value>"
      }
   }
}