Aktivera felsökningsprogram för ögonblicksbilder för .NET-appar i Azure App Service

Kommentar

Om du använder en förhandsversion av .NET Core eller om ditt program refererar till Application Insights SDK (direkt eller indirekt via en beroende sammansättning) följer du anvisningarna för Aktivera felsökning av ögonblicksbilder för andra miljöer för att inkludera Microsoft.ApplicationInsights.SnapshotCollector NuGet-paketet med programmet.

Snapshot Debugger stöder för närvarande ASP.NET och ASP.NET Core-appar som körs i Azure App Service i Windows-tjänstplaner.

Vi rekommenderar att du kör ditt program på basic- eller högre tjänstnivåer när du använder Snapshot Debugger. För de flesta program:

• Nivåerna Kostnadsfri och Delad tjänst har inte tillräckligt med minne eller diskutrymme för att spara ögonblicksbilder.
• Förbrukningsnivån är för närvarande inte tillgänglig för Felsökning av ögonblicksbilder.

Även om Snapshot Debugger är förinstallerat som en del av App Services-körningen måste du aktivera det för att få ögonblicksbilder för din App Service-app. Kodlös installation av Snapshot Debugger följer .NET Core-supportprincipen..

Azure-portalen

När du har distribuerat .NET App Services-webbappen:

1. Gå till Din App Service i Azure Portal.

2. På menyn till vänster väljer du Inställningar>Application Insights.

   

3. Klicka på Aktivera Application Insights.

   • Om du har en befintlig Application Insights-resurs som du hellre använder väljer du det alternativet under Ändra resurs.

4. Under Instrumentera ditt program väljer du fliken .NET .

5. Växla båda felsökningsknapparna för ögonblicksbilder till På.

   

6. Felsökningsprogrammet för ögonblicksbilder är nu aktiverat.

Inaktivera felsökningsprogram för ögonblicksbilder

Så här inaktiverar du felsökningsprogrammet för ögonblicksbilder för din App Services-resurs:

1. Gå till Din App Service i Azure Portal.
2. På menyn till vänster väljer du Inställningar>Application Insights.
3. Växla växlingsknappen För ögonblicksbildsfelsökare till Av.

Azure Resource Manager

Du kan också ange appinställningar i Azure Resource Manager-mallen för att aktivera Snapshot Debugger och Profiler. Till exempel:

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

Generera trafik till ditt program som kan utlösa ett undantag. Vänta sedan 10 till 15 minuter innan ögonblicksbilder skickas till Application Insights-instansen.

Aktivera felsökningsprogram för ögonblicksbilder för andra molnregioner

För närvarande är de enda regioner som kräver slutpunktsändringar Azure Government och Microsoft Azure som drivs av 21Vianet via Application Insights-anslutningssträngen.

Egenskap för anslutningssträng	US Government Cloud	Kina, moln
SnapshotEndpoint	https://snapshot.monitor.azure.us	https://snapshot.monitor.azure.cn

Mer information om andra åsidosättningar av anslutningar finns i Application Insights-dokumentationen.

Konfigurera felsökningsprogram för ögonblicksbilder

Aktivera Microsoft Entra-autentisering för inmatning av ögonblicksbilder

Snapshot Debugger stöder Microsoft Entra-autentisering för inmatning av ögonblicksbilder. För att alla ögonblicksbilder av ditt program ska matas in måste programmet autentiseras och ange de programinställningar som krävs för felsökningsagenten för ögonblicksbilder.

Från och med idag stöder Snapshot Debugger endast Microsoft Entra-autentisering när du refererar till och konfigurerar Microsoft Entra-ID med Application Insights SDK i ditt program.

Så här aktiverar du Microsoft Entra-ID för inmatning av ögonblicksbilder i din App Services-resurs:

1. Lägg till den hanterade identitet som autentiserar mot din Application Insights-resurs i Din App Service. Du kan skapa antingen:

   • Lägg till en systemtilldelad hanterad identitet.
   • Lägg till en användartilldelad hanterad identitet.

2. Konfigurera och aktivera Microsoft Entra-ID i din Application Insights-resurs. Mer information finns i följande dokumentation

3. Lägg till följande programinställning. Den här inställningen anger vilken hanterad identitet som ska användas för ögonblicksbildens felsökningsagent:

För systemtilldelad identitet:

Programinställning	Värde
APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Authorization=AD

För användartilldelad identitet:

Programinställning	Värde
APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Authorization=AD; ClientID={Klient-ID för den användartilldelade identiteten}

Scenarier som inte stöds

Nedan visas scenarier där ögonblicksbildinsamlaren inte stöds:

Scenario	Sidoeffekter	Rekommendation
Du använder Snapshot Collector SDK i ditt program direkt (.csproj) och aktiverade det avancerade alternativet "Interop".	Det lokala Application Insights SDK (inklusive telemetri för ögonblicksbildinsamlare) går förlorade och inga ögonblicksbilder är tillgängliga. Ditt program kan krascha vid start med System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor. Läs mer om Application Insights-funktionen "Interop".	Om du använder det avancerade alternativet "Interop" använder du den kodlösa inmatningen av ögonblicksbildinsamlaren (aktiverad via Azure Portal).

Nästa steg

• Visa ögonblicksbilder i Azure Portal.
• Felsöka problem med felsökning av ögonblicksbilder.