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

A Pillanatkép-hibakereső jelenleg ASP.NET és ASP.NET Core-alkalmazásokat támogat, amelyek Azure-alkalmazás Szolgáltatáson futnak Windows-szolgáltatáscsomagokban.

Megjegyzés:

A Snapshot Debugger használatakor javasoljuk, hogy az alkalmazást az Alapszintű szolgáltatási szinten vagy annál magasabb szinten futtassa. 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 Használati szint jelenleg nem érhető el a Snapshot Debuggerhez.

Pillanatkép-hibakereső engedélyezése

A pillanatkép-hibakereső előre telepítve van az App Services-futtatókörnyezet részeként, de be kell kapcsolnia, hogy pillanatképeket kapjon az App Service-alkalmazáshoz. A Snapshot Debugger alkalmazáshoz való engedélyezéséhez kövesse az alábbi utasításokat:

Megjegyzés:

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

Megjegyzés:

Az Application Elemzések Snapshot Debugger kód nélküli telepítése a .NET Core támogatási szabályzatát követi. A támogatott futtatókörnyezetekről további információt a .NET Core támogatási szabályzatában talál.

A .NET-alkalmazás üzembe helyezése után:

1. Nyissa meg az App Service Azure vezérlőpultját.

2. Nyissa meg a Gépház> Application Elemzések lapot.

   

3. Új erőforrás létrehozásához kövesse a lapon található utasításokat, vagy válasszon ki egy meglévő alkalmazás-Elemzések erőforrást az alkalmazás figyeléséhez.

4. Váltson a Pillanatkép-hibakereső bekapcsolt állapotra.

   

5. A pillanatkép-hibakereső mostantól engedélyezve van egy App Services-alkalmazásbeállítás használatával.

   

Ha más típusú Azure-szolgáltatást futtat, az alábbi utasításokat követve engedélyezheti a Snapshot Debugger szolgáltatást más támogatott platformokon:

• Azure-függvény
• Azure Cloud Services
• Azure Service Fabric-szolgáltatások
• Azure-beli virtuális gépek és virtuálisgép-méretezési csoportok
• Helyszíni virtuális vagy fizikai gépek

Pillanatkép-hibakereső engedélyezése más felhőkhöz

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 alkalmazás Elemzések Csatlakozás ion-sztringen keresztül.

Csatlakozás ion string tulajdonság	US Government Cloud	China Cloud
SnapshotEndpoint	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 Alkalmazás Elemzések dokumentációjában talál.

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

Az alkalmazás Elemzések Pillanatkép-hibakereső támogatja a Microsoft Entra-hitelesítést a pillanatképek betöltéséhez. Ez azt jelenti, hogy ahhoz, hogy az alkalmazás összes pillanatképét betöltse, hitelesíteni kell az alkalmazást, és meg kell adnia a szükséges alkalmazásbeállításokat a Snapshot Debugger-ügynöknek.

A Pillanatkép-hibakereső jelenleg csak akkor támogatja a Microsoft Entra-hitelesítést, ha a Microsoft Entra-azonosítóra hivatkozik és konfigurálja az alkalmazás Elemzések SDK-val.

A Microsoft Entra-azonosító bekapcsolása pillanatkép-betöltéshez:

1. Hozza létre és adja hozzá az Alkalmazás Elemzések erőforráson való hitelesítéshez használni kívánt felügyelt identitást az App Service-ben.

   1. A rendszer által hozzárendelt felügyelt identitások esetében tekintse meg az alábbi dokumentációt.

   2. A felhasználó által hozzárendelt felügyelt identitások esetében tekintse meg az alábbi dokumentációt.

2. Konfigurálja és kapcsolja be a Microsoft Entra-azonosítót az alkalmazás Elemzések erőforrásban. További információkért tekintse meg az alábbi dokumentációt

3. Adja hozzá a következő alkalmazásbeállítást, amellyel tudathatja a Snapshot Debugger-ügynökkel, hogy melyik felügyelt identitást használja:

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

Alkalmazásbeállítás	Value
APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Authorization=AD

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

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

Pillanatkép-hibakereső letiltása

A Snapshot Debugger letiltásához ismételje meg az engedélyezés lépéseit. Kapcsolja azonban ki a Snapshot Debugger kapcsolót.

Azure Resource Manager-sablon

Egy Azure-alkalmazás szolgáltatás esetében az Azure Resource Manager-sablonban beállíthatja az alkalmazásbeállításokat a Snapshot Debugger és a Profiler engedélyezéséhez. Például:

{
  "apiVersion": "2015-08-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]",
        "APPINSIGHTS_PROFILERFEATURE_VERSION": "1.0.0",
        "APPINSIGHTS_SNAPSHOTFEATURE_VERSION": "1.0.0",
        "DiagnosticServices_EXTENSION_VERSION": "~3",
        "ApplicationInsightsAgent_EXTENSION_VERSION": "~2"
      }
    }
  ]
},

Nem támogatott forgatókönyvek

Az alábbiakban olyan forgatókönyveket talál, ahol a Pillanatkép-gyűjtő nem támogatott:

Eset	Mellékhatások	Recommendation
Közvetlenül a Snapshot Collector SDK-t használja az alkalmazásban (.csproj), és engedélyezte az "Interop" speciális lehetőséget.	A helyi alkalmazás Elemzések SDK (beleértve a Pillanatképgyűjtő telemetriát) elveszik, és nem lesz elérhető pillanatkép. Az alkalmazás indításkor összeomlhat a System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor. További információ az "Interop" alkalmazás Elemzések funkcióról.	Ha az "Interop" speciális lehetőséget használja, használja a kód nélküli Snapshot Collector-injektálást (az Azure Portalon keresztül engedélyezve).

Következő lépések

• 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 alkalmazás Elemzések-példányra.
• Pillanatképek megtekintése az Azure Portalon.
• A Pillanatkép-hibakeresővel kapcsolatos hibák elhárításával kapcsolatos segítségért tekintse meg a Snapshot Debugger hibaelhárítását.