Pillanatkép-hibakereső engedélyezése .NET-alkalmazásokhoz a Azure-alkalmazás Szolgáltatásban

A Pillanatkép-hibakereső jelenleg támogatja az ASP.NET és ASP.NET Core alkalmazásokat, amelyek az Azure App Service-en futnak Windows szolgáltatási terveken.

Megjegyzés

Ha a .NET Core előzetes verzióját használja, vagy az alkalmazás közvetlenül vagy közvetve egy függő szerelvényen keresztül hivatkozik az Application Insights SDK-ra, kövesse a Pillanatkép-hibakereső engedélyezése más környezetekben című témakör utasításait, hogy a Microsoft.ApplicationInsights.SnapshotCollector NuGet-csomagot belefoglalja az alkalmazásba.

A Snapshot Debugger használatakor futtassa az alkalmazást az alapszintű vagy magasabb szolgáltatási szinteken. A legtöbb alkalmazás esetében:

• Az ingyenes és megosztott szolgáltatási szintek nem rendelkeznek elegendő memóriával vagy lemezterülettel a pillanatképek mentéséhez.
• A Fogyasztási szint jelenleg nem elérhető a Snapshot Debugger számára.

Bár a Snapshot Debugger előre telepítve van az App Service-futtatókörnyezet részeként, be kell kapcsolnia, hogy pillanatképeket kapjon az App Service-alkalmazáshoz. A Snapshot Debugger kód nélküli telepítése a .NET Core támogatási szabályzatot követi.

Azure Portál

Az .NET App Service-webalkalmazás üzembe helyezése után engedélyezheti a Pillanatkép-hibakeresőt a Azure portálon.

1. Nyissa meg az App Service-webalkalmazást a Azure portálon.

2. A bal oldali menüben válassza azApplication Insights> lehetőséget.

   

3. Válassza az Application Insights bekapcsolása lehetőséget.

   Ha rendelkezik egy meglévő Application Insights-erőforrással, amelyet inkább használni szeretne, válassza ezt a lehetőséget az Erőforrás módosítása csoportban.

4. Az Alkalmazás instrumentációja alatt válassza a .NET-et.

5. Állítsa mindkét Pillanatkép-hibakereső kapcsolót Be állásba.

   

6. A pillanatkép-hibakereső engedélyezve van.

Pillanatkép-hibakereső letiltása

A Snapshot Debugger letiltása az App Service-erőforráshoz:

1. Lépjen be az App Service-be az Azure portálon.

2. A bal oldali menüben válassza azApplication Insights> lehetőséget.

3. Állítsa a Snapshot Debugger kapcsolókat Ki állásba.

Azure Resource Manager

A Snapshot Debugger és .NET Profiler engedélyezéséhez használja az alkalmazásbeállításokat a Azure Resource Manager sablonban. Példa:

{
  "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"
      }
    }
  ]
},

Olyan forgalmat generálhat az alkalmazásba, amely kivételt válthat ki. Ezután várjon 10–15 percet, amíg a pillanatképek el lesznek küldve az Application Insights-példánynak.

Pillanatkép-hibakereső engedélyezése más felhőrégiókhoz

Jelenleg az egyetlen régió, amely végpontmódosítást igényel, az Azure Government és a Microsoft Azure, amelyet a 21Vianet üzemeltet az Application Insights kapcsolati sztringen keresztül.

A kapcsolati karakterlánc tulajdonsága	Amerikai Kormányzati Felhő	Kínai Felhő
PillanatképVégpont	https://snapshot.monitor.azure.us	https://snapshot.monitor.azure.cn

Az egyéb kapcsolati felülbírálásokról további információt az Application Insights dokumentációjában talál.

Snapshot Debugger konfigurálása

A Snapshot Debugger engedélyezése után konfigurálhatja, hogyan hitelesíti és betölti a pillanatképeket az App Service-alkalmazáshoz.

A Microsoft Entra-hitelesítés engedélyezése pillanatkép-betöltéshez

A Pillanatképhibakereső támogatja a Microsoft Entra-hitelesítést a pillanatképek feldolgozásához. Ahhoz, hogy a Snapshot Debugger betöltse az alkalmazás összes pillanatképét, az alkalmazásnak hitelesítenie kell és meg kell adnia a szükséges alkalmazásbeállításokat a Snapshot Debugger ügynöknek.

Megjegyzés

A Pillanatkép-hibakereső jelenleg csak a Microsoft Entra-hitelesítést támogatja, ha az alkalmazásban az Application Insights SDK használatával hivatkozik a Microsoft Entra ID-ra, és azt konfigurálja.

1. Adja hozzá az Application Insights-erőforrással hitelesítendő felügyelt identitást az App Service-hez. Hozza létre a következőt:

   • Rendszer által hozzárendelt felügyelt identitás.
   • Felhasználó által hozzárendelt felügyelt identitás.

2. Az Azure Portalon konfigurálja és kapcsolja be a Microsoft Entra-azonosítót az Application Insights-erőforrásban.

3. Adja hozzá a következő alkalmazásbeállítást. Ez a beállítás azt jelzi a Snapshot Debugger-ügynöknek, hogy melyik felügyelt identitást használja:

   Rendszer által hozzárendelt identitás esetén:

   Alkalmazásbeállítás	Érték
   APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Engedélyezés=AD

   Felhasználó által hozzárendelt identitás esetén:

   Alkalmazásbeállítás	Érték
   APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Authorization=AD; ClientID={A felhasználó által hozzárendelt identitás ügyfélazonosítója}

Nem támogatott forgatókönyvek

A következő forgatókönyv bemutatja, hogy a Pillanatkép-gyűjtő hol nem támogatott.

Eset	Mellékhatás	Ajánlás
A Snapshot Collector SDK-t közvetlenül az alkalmazásban (.csproj) használja, és engedélyezi az Interop speciális lehetőséget.	Elveszíti a helyi Application Insights SDK-t, beleértve a Snapshot Collector telemetriát is, és nem érhetők el pillanatképek. Előfordulhat, hogy az alkalmazás indításkor a következő hibával összeomlik: System.ArgumentException: telemetryProcessorType does not implement ITelemetryProcessor. Az Application Insights interop funkciójával kapcsolatos további információkért lásd: Application Insights-integráció hibaelhárítása.	Ha az Interop speciális lehetőséget használja, használja az Azure Portalon engedélyezett kód nélküli Snapshot Collector-injektálást.

Kapcsolódó tartalom

• Pillanatképek megtekintése az Azure Portalon.
• Snapshot Debugger problémák elhárítása.