مشاركة عبر

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

  • مقالة

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

تثبيت بدون تعليمات برمجية لملف تعريف Application Insights ل .NET:

  • يتبع نهج دعم .NET Core.
  • معتمد فقط على تطبيقات الويب المستندة إلى Windows.

لتمكين محلل ملفات تعريف .NET على Linux، راجع تعليمات تطبيقات الويب ASP.NET Core Azure Linux.

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

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

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

  2. في القائمة اليسرى، حدد Settings>Configuration.

    لقطة شاشة توضح تحديد Configuration في الجزء الأيمن.

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

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

    إشعار

    إذا تم تعطيل زر التبديل Always on، فقم بترقية تطبيق ويب App Service للتشغيل على المستوى الأساسي أو أعلى.

    لقطة شاشة تعرض علامة التبويب عام في جزء التكوين تظهر تمكين Always On.

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

تمكين Application Insights و.NET Profiler

يمكنك تمكين محلل ملفات التعريف إما عندما:

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

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

  1. في القائمة اليسرى، حدد Monitoring>Application Insights.

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

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

    لقطة شاشة توضح تمكين Application Insights على تطبيقك.

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

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

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

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

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

    لقطة شاشة تعرض تمكين محلل ملفات التعريف على تطبيقك.

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

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

إعداد التطبيق القيمة‬
APPLICATIONINSIGHTS_CONNECTION_STRING قيمة فريدة من مورد App Insights.
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
DiagnosticServices_EXTENSION_VERSION ~3

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

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

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

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

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

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

    لقطة شاشة تعرض تحديد مهام الويب في الجزء الأيمن.

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

  3. حدد إيقاف.

    لقطة شاشة تعرض تحديد إيقاف لإيقاف webjob.

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

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

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

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