Dela via

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

  • Artikel

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.

Kommentar

Vi rekommenderar att du kör ditt program på basic-tjänstnivån eller senare när du använder Felsökningsprogrammet för ögonblicksbilder. För de flesta program har nivåerna Kostnadsfri och Delad tjänst 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.

Aktivera felsökningsprogram för ögonblicksbilder

Felsökningsprogrammet för ögonblicksbilder är förinstallerat som en del av App Services-körningen, men du måste aktivera det för att få ögonblicksbilder för din App Service-app. Om du vill aktivera Felsökning av ögonblicksbilder för en app följer du anvisningarna nedan:

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.

Kommentar

Kodlös installation av Application Insights Snapshot Debugger följer .NET Core-supportprincipen. Mer information om körning som stöds finns i .NET Core-supportprincip.

När du har distribuerat .NET-appen:

  1. Gå till Azure-kontrollpanelen för din App Service.

  2. Gå till sidan Inställningar> Application Insights.

    Screenshot showing the Enable App Insights on App Services portal.

  3. Följ antingen anvisningarna på sidan för att skapa en ny resurs eller välj en befintlig App Insights-resurs för att övervaka din app.

  4. Växla växlingsknappar för ögonblicksbildfelsökare till På.

    Screenshot showing how to add App Insights site extension.

  5. Felsökningsprogrammet för ögonblicksbilder är nu aktiverat med hjälp av en App Services-appinställning.

    Screenshot showing App Setting for Snapshot Debugger.

Om du kör en annan typ av Azure-tjänst finns här instruktioner för att aktivera Snapshot Debugger på andra plattformar som stöds:

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

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 Anslut ion String.

egenskapen Anslut ion String 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.

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

Application Insights Snapshot Debugger stöder Microsoft Entra-autentisering för inmatning av ögonblicksbilder. Det innebär att 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:

  1. Skapa och lägg till den hanterade identitet som du vill använda för att autentisera mot din Application Insights-resurs i Din App Service.

    1. Information om systemtilldelad hanterad identitet finns i följande dokumentation.

    2. Information om användartilldelad hanterad identitet finns i följande dokumentation.

  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 som används för att låta Snapshot Debugger-agenten veta vilken hanterad identitet som ska användas:

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}

Inaktivera felsökningsprogram för ögonblicksbilder

Om du vill inaktivera felsökningsprogrammet för ögonblicksbilder upprepar du stegen för aktivering. Växla dock växlingsknappen ögonblicksbildsfelsökare till Av.

Azure Resource Manager-mall

För en Azure App Service kan du ange appinställningar i Azure Resource Manager-mallen för att aktivera Snapshot Debugger och Profiler. Till exempel:

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

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 har aktiverat det avancerade alternativet "Interop". Den lokala Application Insights SDK (inklusive telemetri för ögonblicksbildinsamlaren) kommer att gå förlorad och inga ögonblicksbilder kommer att vara 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-portalen).

Nästa steg

  • 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.
  • Se ögonblicksbilder i Azure-portalen.
  • Mer information om felsökning av problem med felsökning av ögonblicksbilder finns i Felsökning av ögonblicksbildfelsökare.