Share via

قم بتمكين محلل ملفات التعريف لتطبيقات Azure App Service

  • مقالة

تم تثبيت محلل ملفات تعريف Application Insights مسبقا كجزء من وقت تشغيل Azure App Service. يمكنك تشغيل محلل ملفات التعريف على ASP.NET وتطبيقات ASP.NET Core التي تعمل على App Service باستخدام طبقة الخدمة الأساسية أو أعلى. اتبع هذه الخطوات، حتى إذا قمت بإدراج Application Insights SDK في التطبيق الخاص بك في وقت الإنشاء.

لتمكين Profiler على Linux، انتقل إلى إرشادات تطبيقات الويب ASP.NET Core Azure Linux .

إشعار

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

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

تحقق من تمكين إعداد "Always on"

  1. في مدخل Microsoft Azure، انتقل إلى مثيل App Service.

  2. ضمن الإعدادات في الجزء الأيمن، حدد Configuration.

    Screenshot that shows selecting Configuration on the left pane.

  3. حدد علامة التبويب إعدادات عامة.

  4. تحقق من تحديد Always on>On.

    Screenshot that shows the General tab on the Configuration pane showing that Always On is enabled.

  5. حدد حفظ إذا قمت بإجراء تغييرات.

قم بتمكين Application Insights ومحلل ملفات التعريف

توضح لك الأقسام التالية كيفية تمكين Application Insights لنفس الاشتراك أو الاشتراكات المختلفة.

بالنسبة إلى Application Insights وApp Service في نفس الاشتراك

إذا كان مورد Application Insights الخاص بك في نفس الاشتراك مثل مثيل App Service الخاص بك:

  1. ضمن الإعدادات في الجزء الأيمن، حدد Application Insights.

    Screenshot that shows selecting Application Insights on the left pane.

  2. ضمن Application Insights، حدّد Enable.

  3. تحقق من توصيل مورد Application Insights بتطبيقك.

    Screenshot that shows enabling Application Insights on your app.

  4. مرر لأسفل وحدد علامة التبويب .NET أو .NET Core، بناء على التطبيق الخاص بك.

  5. تحقق من تحديد مستوى>المجموعة الموصى به.

  6. ضمن Profiler، قم بتحديد On.

    في حالة اختيارك مستوى المجموعة Basic في وقت سابق، يتم تعطيل إعداد محلل ملفات التعريف.

  7. حدد تطبيق>نعم للتأكيد.

    Screenshot that shows enabling Profiler on your app.

بالنسبة إلى Application Insights وApp Service في اشتراكات مختلفة

إذا كان مورد Application Insights الخاص بك في اشتراك مختلف عن مثيل App Service، فستحتاج إلى تمكين محلل ملفات التعريف يدويا عن طريق إنشاء إعدادات التطبيق لمثيل App Service. يمكنك أتمتة إنشاء هذه الإعدادات باستخدام قالب أو وسائل أخرى. فيما يلي الإعدادات التي تحتاجها لتمكين محلل ملفات التعريف.

إعداد التطبيق القيمة‬
APPINSIGHTS_INSTRUMENTATIONKEY iKey لمورد Application Insights لديك
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
DiagnosticServices_EXTENSION_VERSION ~3

قم بتعيين هذه القيم باستخدام:

تمكين محلل ملفات التعريف للسحب الإقليمية

حاليا، المناطق الوحيدة التي تتطلب تعديلات نقطة النهاية هي 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

تمكين مصادقة Microsoft Entra لاستيعاب ملف التعريف

يدعم محلل ملفات تعريف Application Insights مصادقة Microsoft Entra لاستيعاب ملف التعريف. حتى يتم استيعاب كافة ملفات تعريف التطبيق الخاص بك، يجب مصادقة التطبيق الخاص بك وتوفير إعدادات التطبيق المطلوبة فيما يتعلق بعامل محلل ملفات التعريف.

يدعم محلل ملفات التعريف مصادقة Microsoft Entra فقط عند الرجوع إلى معرف Microsoft Entra وتكوينه باستخدام Application Insights SDK في التطبيق الخاص بك.

لتمكين معرف Microsoft Entra لاستيعاب ملف التعريف:

  1. إنشاء وإضافة الهوية المدارة للمصادقة مقابل مورد Application Insights إلى App Service:

    1. وثائق الهوية المدارة المعينة من قبل النظام

    2. وثائق الهوية المدارة المعينة من قبل المستخدم

  2. تكوين وتمكين معرف Microsoft Entra في مورد Application Insights.

  3. أضف إعداد التطبيق التالي للسماح لعامل محلل ملفات التعريف بمعرفة الهوية المدارة التي يجب استخدامها.

    • للهوية المعينة من قبل النظام:

      إعداد التطبيق القيمة‬
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD

    • للهوية المعينة من قبل المستخدم:

      إعداد التطبيق القيمة‬
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD;ClientId={Client id of the User-Assigned Identity}

تعطيل محلل ملفات التعريف

فيما يتعلق بإيقاف محلل ملفات التعريف لمثيل تطبيق فردي أو إعادة تشغيله:

  1. ضمن الإعدادات في الجزء الأيمن، حدد WebJobs.

    Screenshot that shows selecting web jobs on the left pane.

  2. قم بتحديد وظيفة الويب المسماة ApplicationInsightsProfiler3.

  3. حدد إيقاف.

    Screenshot that shows selecting stop for stopping the webjob.

  4. حدد نعم للتأكيد.

نوصي بتمكين محلل ملفات التعريف في جميع تطبيقاتك لاكتشاف أي مشكلات في الأداء في أقرب وقت ممكن.

يمكنك حذف ملفات محلل ملفات التعريف عند استخدام WebDeploy لنشر التغييرات على تطبيق الويب الخاص بك. يمكنك منع الحذف عن طريق استبعاد حذف مجلد App_Data أثناء النشر.

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