استكشاف أخطاء محلل ملفات تعريف Application Insights وإصلاحها

تقدم هذه المقالة خطوات ومعلومات استكشاف الأخطاء وإصلاحها لتمكينك من استخدام محلل ملفات تعريف Application Insights.

هل تستخدم نقطة نهاية محلل ملفات التعريف المناسبة؟

حاليا، المناطق الوحيدة التي تتطلب تعديلات نقطة النهاية هي Azure Government وMicrosoft Azure التي يتم تشغيلها بواسطة 21Vianet.

إعداد التطبيق	US Government Cloud	سحابة الصين
ApplicationInsightsProfilerEndpoint	https://profiler.monitor.azure.us	https://profiler.monitor.azure.cn
ApplicationInsightsEndpoint	https://dc.applicationinsights.us	https://dc.applicationinsights.azure.cn

هل تطبيقك قيد التشغيل على الإصدار الصحيح؟

محلل ملفات التعريف مدعوم على .NET Framework الأحدث من 4.6.2.

إذا كان تطبيق الويب الخاص بك أحد تطبيقات ASP.NET Core، ينبغي أن يعمل بأحدث وقت تشغيل ASP.NET Core مدعوم.

هل تستخدم خطة خدمة Azure الصحيحة؟

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

إشعار

خطة استهلاك Azure Functions غير مدعومة. راجع ملف التعريف المباشر لتطبيق Azure Functions باستخدام Application Insights.

هل تبحث عن بيانات محلل ملفات التعريف ضمن الإطار الزمني الصحيح؟

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

هل يمكنك الوصول إلى البوابة؟

تحقق من أن جدار الحماية أو الوكلاء لا يمنعون وصولك إلى صفحة الويب هذه.

هل ترى المهلات أم تحتاج إلى التحقق لمعرفة ما إذا كان محلل ملفات التعريف قيد التشغيل؟

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

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

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

1. في مورد Application Insights، حدد Search من القائمة العلوية.

   

2. استخدم سلسلة البحث التالية للعثور على البيانات ذات الصلة:

   stopprofiler OR startprofiler OR upload OR ServiceProfilerSample
   

   

   تتضمن نتائج البحث السابقة مثالين لعمليات البحث من موردين الذكاء الاصطناعي:

   • إن كان التطبيق لا يتلقى طلبات أثناء تشغيل محلل ملفات التعريف، توضح الرسالة أنه تم إلغاء التحميل بسبب عدم وجود نشاط.

   • بدأ محلل ملفات التعريف وأرسل أحداثًا مخصصة عندما اكتشف طلبات حدثت أثناء تشغيل محلل ملفات التعريف. إذا تم عرض الحدث المخصص ServiceProfilerSample، فهذا يعني أنه تم تسجيل ملف تعريف والمتوفر في جزء أداء Application Insights.

   إذا لم يتم عرض أي سجلات، فإن محلل ملفات التعريف لا يعمل أو قد انتهى مهلته. تأكد من تمكين محلل ملفات التعريف على خدمة Azure.

العد المزدوج في المواضيع المتوازية

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

على سبيل المثال، قد يكون مؤشر ترابط واحد ينتظر أكتمال الآخر. يحاول المشاهد الكشف عن هذا الموقف ويحذف الانتظار غير المثير للاهتمام. عند القيام بذلك، فإنه يكرر على جانب عرض الكثير من المعلومات بدلا من حذف ما قد يكون معلومات هامة.

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

استكشاف أخطاء محلل ملفات التعريف على خدمة Azure المحددة وإصلاحها

ترشدك الأقسام التالية خلال خطوات استكشاف الأخطاء وإصلاحها لاستخدام محلل ملفات التعريف على Azure App Service أو Azure Cloud Services.

Azure App Service

لكي يعمل محلل ملفات التعريف بشكل صحيح، تأكد مما يلي :

• يحتوي تطبيق الويب الخاص بك على Application Insights ممكن بالإعدادات الصحيحة.

• ApplicationInsightsProfiler3 WebJob قيد التشغيل. للتحقق من webjob:

  1. اذهب إلى Kudu. في مدخل Microsoft Azure:

     1. في مثيل App Service، حدد Advanced Tools في الجزء الأيمن.
     2. حدد Go.

  2. في القائمة العلوية، حدد Tools>WebJobs dashboard. يفتح جزء WebJobs.

     إذا لم يظهر ApplicationInsightsProfiler3 ، أعد تشغيل تطبيق App Service.

     

  3. لعرض تفاصيل WebJob، بما في ذلك السجل، حدد الارتباط ApplicationInsightsProfiler3 . يتم فتح جزء تفاصيل WebJob المستمر.

     

إذا كان محلل ملفات التعريف لا يزال لا يعمل نيابة عنك، فبادر بتنزيل السجل وإرسال تذكرة دعم Azure.

تحقق من صفحة حالة ملحق موقع خدمات التشخيص

إذا تم تمكين محلل ملفات التعريف من خلال جزء التطبيق في المدخل، فقد تم تمكينه من خلال ملحق موقع خدمات التشخيص. يمكنك التحقق من صفحة حالة هذا الملحق بالانتقال إلى https://{site-name}.scm.azurewebsites.net/DiagnosticServices.

إشعار

يختلف مجال ارتباط صفحة الحالة وفقا للسحابة. هذا المجال هو نفس موقع إدارة Kudu ل App Service.

تُظهر صفحة الحالة هذه حالة تثبيت عوامل محلل ملفات التعريف وSnapshot Debugger. إذا كان هناك خطأ غير متوقع، فإنه يظهر جنبا إلى جنب مع خطوات حول كيفية إصلاحه.

يمكنك استخدام موقع إدارة Kudu ل App Service للحصول على عنوان URL الأساسي لصفحة الحالة هذه:

1. افتح تطبيق App Service في مدخل Azure.
2. حدد Advanced Tools.
3. حدد Go.
4. على موقع إدارة Kudu:
   1. قم بإلحاق /DiagnosticServices بعنوان URL.
   2. حدد Enter.

ينتهي مثل https://<kudu-url>/DiagnosticServices.

تظهر صفحة الحالة مشابهة للمثال التالي.

إشعار

تثبيت بدون تعليمات برمجية من "محلل ملفات تعريف التطبيق" يتبع نهج دعم .NET Core. لمزيد من المعلومات حول أوقات التشغيل المدعومة، راجع نهج دعم .NET Core.

تثبيت يدوي

عند تكوين محلل ملفات التعريف، يتم إجراء تحديثات على إعدادات تطبيق الويب. إذا لزم الأمر، يمكنك تطبيق التحديثات يدويًا.

عدد كبير جدًا من جلسات جمع المعلومات النشط

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

Microsoft.ServiceProfiler.Exceptions.TooManyETWSessionException

لحلها، قم بنقل بعض تطبيقات الويب إلى خطة خدمة مختلفة.

خطأ التوزيع: الدليل غير فارغ 'D:\home\site\wwwroot\App_Data\jobs'

إذا كنت تعيد نشر تطبيق الويب الخاص بك إلى مورد تطبيق ويب مع تمكين "محلل ملفات التعريف"، فقد تظهر لك الرسالة التالية:

"الدليل غير فارغ 'D:\home\site\wwwroot\App_Data\jobs'"

يحدث هذا الخطأ إذا قمت بتشغيل Web Deploy من البرامج النصية أو من Azure Pipelines. قم بحلها عن طريق إضافة معلمات النشر التالية إلى مهمة Web Deploy:

-skip:Directory='.*\\App_Data\\jobs\\continuous\\ApplicationInsightsProfiler.*' -skip:skipAction=Delete,objectname='dirPath',absolutepath='.*\\App_Data\\jobs\\continuous$' -skip:skipAction=Delete,objectname='dirPath',absolutepath='.*\\App_Data\\jobs$'  -skip:skipAction=Delete,objectname='dirPath',absolutepath='.*\\App_Data$'

تقوم هذه المعلمات بحذف المجلد الذي يستخدمه محلل ملفات التعريف Application Insights وإلغاء حظر عملية إعادة النشر. لا تؤثر على مثيل محلل ملفات التعريف الذي يتم تشغيله حاليًا.

هل محلل ملفات تعريف Application Insights قيد التشغيل؟

يعمل محلل ملفات التعريف ك WebJob مستمر في تطبيق الويب. يمكنك فتح مورد تطبيق ويب في مدخل Azure. في جزء WebJobs، تحقق من حالة Application Insights Profiler. إذا لم يكن قيد التشغيل، فافتح سجلات للحصول على مزيد من المعلومات.

الأجهزة الظاهرية وخدمات Azure السحابية

لمعرفة ما إذا كان قد تم تكوين محلل ملفات التعريف بشكل صحيح بواسطة Azure Diagnostics:

1. تحقق من أن محتوى تكوين تشخيص Azure المستخدم هو ما تتوقعه.

2. تأكد من أن Azure Diagnostics يمرر iKey المناسب على سطر أوامر محلل ملفات التعريف.

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

للتحقق من الإعدادات التي تم استخدامها لتكوين تشخيص Azure:

1. قم بتسجيل الدخول إلى الجهاز الافتراضي (VM).

2. افتح ملف السجل في هذا الموقع. قد يكون إصدار المكون الإضافي أحدث على جهازك.

   لأجهزة VMs:

   c:\WindowsAzure\logs\Plugins\Microsoft.Azure.Diagnostics.PaaSDiagnostics\1.11.3.12\DiagnosticsPlugin.log
   

   لخدمات Azure السحابية:

   c:\logs\Plugins\Microsoft.Azure.Diagnostics.PaaSDiagnostics\1.11.3.12\DiagnosticsPlugin.log
   

3. في الملف، ابحث عن سلسلة WadCfg للعثور على الإعدادات التي تم تمريرها إلى الجهاز الظاهري لتكوين Azure Diagnostics.

4. تحقق لمعرفة ما إذا كان iKey المستخدم من قبل متلقي محلل ملفات التعريف الصحيح.

5. تحقق من سطر الأوامر المستخدم لبدء تشغيل محلل ملفات التعريف. الوسيطات المستخدمة لتشغيل محلل ملفات التعريف موجودة في الملف التالي (قد يكون c: محرك الأقراص أو d: وقد يكون الدليل مخفيا):

   لأجهزة VMs:

   C:\ProgramData\ApplicationInsightsProfiler\config.json
   

   لخدمات Azure السحابية:

   D:\ProgramData\ApplicationInsightsProfiler\config.json
   

6. تأكد من صحة iKey على سطر الأوامر في محلل ملفات التعريف.

7. باستخدام المسار الموجود في ملف config.json السابق، تحقق من ملف سجل محلل ملفات التعريف، المسمى BootstrapN.log. ويعرض:

   • معلومات التصحيح التي تشير إلى الإعدادات التي يستخدمها محلل ملفات التعريف.
   • رسائل الحالة والخطأ من محلل ملفات التعريف.

   يمكنك العثور على الملف:

   لأجهزة VMs:

   C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics\1.17.0.6\ApplicationInsightsProfiler
   

   لخدمات Azure السحابية:

   C:\Logs\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics\1.17.0.6\ApplicationInsightsProfiler
   

8. إذا كان محلل ملفات التعريف قيد التشغيل أثناء تلقي التطبيق للطلبات، تظهر الرسالة التالية: "تم الكشف عن النشاط من iKey."

9. عند تحميل التتبع، تظهر الرسالة التالية: "بدء تحميل التتبع".

تحرير وكيل الشبكة أو قواعد جدار الحماية

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

يتم تضمين IPs المستخدمة من قبل محلل ملفات التعريف Insights التطبيق في علامة خدمة Azure Monitor. لمزيد من المعلومات، راجع وثائق علامات الخدمة.

الدعم

إذا كنت لا تزال بحاجة إلى مساعدة، أرسل تذكرة دعم في مدخل Microsoft Azure. قم بتضمين معرف الارتباط من رسالة الخطأ.