تمكين Snapshot Debugger لتطبيقات NET. في Azure App Service

إشعار

إذا كنت تستخدم إصدار معاينة من NET. Core، أو يشير تطبيقك إلى Application Insights SDK، (بشكل مباشر أو غير مباشر عبر مجموعة تابعة)، فاتبع الإرشادات الخاصة بتمكين Snapshot Debugger للبيئات الأخرى لتضمين Microsoft.ApplicationInsights.SnapshotCollector حزمة NuGet مع التطبيق.

يدعم Snapshot Debugger حاليا تطبيقات ASP.NET و ASP.NET Core التي تعمل على Azure App Service على خطط خدمة Windows.

نوصي بتشغيل التطبيق الخاص بك على مستويات الخدمة الأساسية أو الأعلى عند استخدام Snapshot Debugger. لمعظم التطبيقات:

• لا تحتوي طبقات الخدمة المجانية والمشتركة على ذاكرة أو مساحة قرص كافية لحفظ اللقطات.
• مستوى الاستهلاك غير متوفر حاليا ل Snapshot Debugger.

على الرغم من أن Snapshot Debugger مثبت مسبقا كجزء من وقت تشغيل App Services، تحتاج إلى تشغيله للحصول على لقطات لتطبيق App Service. يتبع التثبيت بدون تعليمات برمجية ل Snapshot Debugger نهج دعم .NET Core.

مدخل Microsoft Azure

بعد نشر تطبيق ويب .NET App Services:

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

2. في القائمة اليمنى، حدد Settings>Application Insights.

   

3. حدد تشغيل Application Insights.

   • إذا كان لديك مورد Application Insights موجود تفضل استخدامه، فحدد هذا الخيار ضمن تغيير المورد الخاص بك.

4. ضمن Instrument your application، حدد علامة التبويب .NET .

5. قم بتبديل كل من Snapshot Debugger إلى On.

   

6. تم الآن تمكين Snapshot Debugger.

تعطيل Snapshot Debugger

لتعطيل Snapshot Debugger لمورد App Services:

1. انتقل إلى App Service في مدخل Microsoft Azure.
2. في القائمة اليمنى، حدد Settings>Application Insights.
3. قم بتبديل Snapshot Debugger إلى إيقاف التشغيل.

Azure Resource Manager

يمكنك أيضا تعيين إعدادات التطبيق داخل قالب Azure Resource Manager لتمكين Snapshot Debugger و Profiler. على سبيل المثال:

{
  "apiVersion": "2023-12-01",
  "name": "[parameters('webSiteName')]",
  "type": "Microsoft.Web/sites",
  "location": "[resourceGroup().location]",
  "dependsOn": [
    "[variables('hostingPlanName')]"
  ],
  "tags": { 
    "[concat('hidden-related:', resourceId('Microsoft.Web/serverfarms', variables('hostingPlanName')))]": "empty",
    "displayName": "Website"
  },
  "properties": {
    "name": "[parameters('webSiteName')]",
    "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', variables('hostingPlanName'))]"
  },
  "resources": [
    {
      "apiVersion": "2015-08-01",
      "name": "appsettings",
      "type": "config",
      "dependsOn": [
        "[parameters('webSiteName')]",
        "[concat('AppInsights', parameters('webSiteName'))]"
      ],
      "properties": {
        "APPINSIGHTS_INSTRUMENTATIONKEY": "[reference(resourceId('Microsoft.Insights/components', concat('AppInsights', parameters('webSiteName'))), '2014-04-01').InstrumentationKey]",
        // "Turn on" a Snapshot Debugger version
        "APPINSIGHTS_SNAPSHOTFEATURE_VERSION": "1.0.0",
        "DiagnosticServices_EXTENSION_VERSION": "~3",
        "ApplicationInsightsAgent_EXTENSION_VERSION": "~2"
      }
    }
  ]
},

إنشاء حركة اتصالات إلى التطبيق الخاص بك يمكنها تحفيز الاستثناء. ثم، انتظر 10 إلى 15 دقيقة حتى يتم إرسال لقطات إلى مثيل Application Insights.

تمكين Snapshot Debugger لمناطق السحابة الأخرى

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

خاصية سلسلة الاتصال	US Government Cloud	سحابة الصين
SnapshotEndpoint	https://snapshot.monitor.azure.us	https://snapshot.monitor.azure.cn

لمزيدٍ من المعلومات حول تجاوزات الاتصال الأخرى، راجع وثائق Application Insights.

تكوين Snapshot Debugger

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

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

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

لتشغيل معرف Microsoft Entra لاستيعاب اللقطة في مورد App Services:

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

   • إضافة هوية مدارة معينة من قبل النظام.
   • إضافة هوية مدارة معينة من قبل المستخدم.

2. تكوين معرف Microsoft Entra وتشغيله في مورد Application Insights. ولمزيدٍ من المعلومات، راجع الوثائق التالية

3. أضف إعداد التطبيق التالي. يخبر هذا الإعداد عامل Snapshot Debugger الذي يدير الهوية المراد استخدامها:

للهوية المعينة من النظام:

إعداد التطبيق	القيمة‬
APPLICATIONINSIGHTS_AUTHENTICATION_STRING	التخويل = AD

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

إعداد التطبيق	القيمة‬
APPLICATIONINSIGHTS_AUTHENTICATION_STRING	التخويل =AD؛ معرف العميل={معرف العميل للهوية المعينة من قبل المستخدم}

السيناريوهات غير المدعومة

يمكنك العثور أدناه على سيناريوهات حيث لا يتم دعم أداة تجميع اللقطات:

السيناريو	التأثيرات الجانبية	التوصية
أنت تستخدم Snapshot Collector SDK في تطبيقك مباشرة (.csproj) ومكنت الخيار المتقدم "Interop".	يتم فقدان Application Insights SDK المحلي (بما في ذلك بيانات تتبع الاستخدام ل Snapshot Collector) ولا تتوفر لقطات. قد يتعطل تطبيقك عند بدء التشغيل باستخدام System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor. تعرف على المزيد حول ميزة Application Insights "التوافق".	إذا كنت تستخدم الخيار المتقدم "التوافق"، فاستخدم إضافة أداة تجميع اللقطات بدون تعليمات برمجية (ممكّن من خلال مدخل Azure).

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

• عرض اللقطات في مدخل Microsoft Azure.
• استكشاف مشكلات Snapshot Debugger وإصلاحها.