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:
Nyissa meg az App Service Azure vezérlőpultját.
Nyissa meg a Gépház> Application Elemzések lapot.
Ú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.
Váltson a Pillanatkép-hibakereső bekapcsolt állapotra.
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:
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.
A rendszer által hozzárendelt felügyelt identitások esetében tekintse meg az alábbi dokumentációt.
A felhasználó által hozzárendelt felügyelt identitások esetében tekintse meg az alábbi dokumentációt.
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
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.
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: