Share via

Snapshot Debugger inschakelen voor .NET-apps in Azure-app Service

  • Artikel

Snapshot Debugger ondersteunt momenteel ASP.NET en ASP.NET Core-apps die worden uitgevoerd op Azure-app Service in Windows-serviceabonnementen.

Notitie

U wordt aangeraden uw toepassing uit te voeren op de Basic-servicelaag of hoger wanneer u snapshot debugger gebruikt. Voor de meeste toepassingen beschikken de servicelagen Gratis en Gedeeld niet over voldoende geheugen of schijfruimte om momentopnamen te besparen. De verbruikslaag is momenteel niet beschikbaar voor het foutopsporingsprogramma voor momentopnamen.

Snapshot Debugger inschakelen

Snapshot Debugger is vooraf geïnstalleerd als onderdeel van de App Services-runtime, maar u moet het inschakelen om momentopnamen voor uw App Service-app op te halen. Volg de onderstaande instructies om Snapshot Debugger in te schakelen voor een app:

Notitie

Als u een preview-versie van .NET Core gebruikt of als uw toepassing verwijst naar Application Insights SDK (direct of indirect via een afhankelijke assembly), volgt u de instructies voor het enable Snapshot Debugger voor andere omgevingen om het Microsoft.ApplicationInsights.SnapshotCollector NuGet-pakket met de toepassing op te nemen.

Notitie

Installatie zonder code van Application Insights Snapshot Debugger volgt het .NET Core-ondersteuningsbeleid. Zie .NET Core-ondersteuningsbeleid voor meer informatie over ondersteunde runtimes.

Nadat u uw .NET-app hebt geïmplementeerd:

  1. Ga naar het Azure-configuratiescherm voor uw App Service.

  2. Ga naar de pagina Instellingen> Application Insights.

    Screenshot showing the Enable App Insights on App Services portal.

  3. Volg de instructies op de pagina om een nieuwe resource te maken of selecteer een bestaande App Insights-resource om uw app te bewaken.

  4. Schakel het foutopsporingsprogramma voor momentopnamen in op Aan.

    Screenshot showing how to add App Insights site extension.

  5. Snapshot Debugger is nu ingeschakeld met behulp van een App Services-app-instelling.

    Screenshot showing App Setting for Snapshot Debugger.

Als u een ander type Azure-service uitvoert, vindt u hier instructies voor het inschakelen van snapshot debugger op andere ondersteunde platforms:

Snapshot Debugger inschakelen voor andere clouds

Momenteel zijn de enige regio's die eindpuntwijzigingen vereisen Azure Government en Microsoft Azure beheerd door 21Vianet via de Application Insights Verbinding maken ion String.

Verbinding maken tekenreekseigenschap Cloud voor de Amerikaanse overheid China-cloud
SnapshotEndpoint https://snapshot.monitor.azure.us https://snapshot.monitor.azure.cn

Zie de Application Insights-documentatie voor meer informatie over andere verbindingsoverschrijvingen.

Microsoft Entra-verificatie inschakelen voor opname van momentopnamen

Application Insights Snapshot Debugger ondersteunt Microsoft Entra-verificatie voor opname van momentopnamen. Dit betekent dat voor alle momentopnamen van uw toepassing die moeten worden opgenomen, uw toepassing moet worden geverifieerd en de vereiste toepassingsinstellingen opgeven voor de agent voor momentopnamenopsporingsprogramma.

Vanaf vandaag biedt Snapshot Debugger alleen ondersteuning voor Microsoft Entra-verificatie wanneer u microsoft Entra-id verwijst en configureert met behulp van de Application Insights SDK in uw toepassing.

Microsoft Entra-id inschakelen voor opname van momentopnamen:

  1. Maak en voeg de beheerde identiteit toe die u wilt gebruiken om te verifiëren bij uw Application Insights-resource aan uw App Service.

    1. Zie de volgende documentatie voor door het systeem toegewezen beheerde identiteit.

    2. Zie de volgende documentatie voor door de gebruiker toegewezen beheerde identiteit.

  2. Configureer en schakel Microsoft Entra-id in uw Application Insights-resource in. Zie de volgende documentatie voor meer informatie

  3. Voeg de volgende toepassingsinstelling toe, die wordt gebruikt om snapshot debugger-agent te laten weten welke beheerde identiteit moet worden gebruikt:

Voor door het systeem toegewezen identiteit:

App-instelling Waarde
APPLICATIONINSIGHTS_AUTHENTICATION_STRING Autorisatie=AD

Voor door de gebruiker toegewezen identiteit:

App-instelling Waarde
APPLICATIONINSIGHTS_AUTHENTICATION_STRING Autorisatie=AD; ClientID={Client-id van de door de gebruiker toegewezen identiteit}

Snapshot Debugger uitschakelen

Als u snapshot debugger wilt uitschakelen, herhaalt u de stappen voor het inschakelen. Schakel echter de schakeloptie Snapshot Debugger in op Uit.

Azure Resource Manager-sjabloon

Voor een Azure-app Service kunt u app-instellingen instellen in de Azure Resource Manager-sjabloon om Snapshot Debugger en Profiler in te schakelen. Bijvoorbeeld:

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

Niet-ondersteunde scenario's

Hieronder vindt u scenario's waarin Snapshot Collector niet wordt ondersteund:

Scenario Neveneffecten Aanbeveling
U gebruikt de Snapshot Collector SDK in uw toepassing rechtstreeks (.csproj) en u hebt de geavanceerde optie Interop ingeschakeld. De lokale Application Insights SDK (inclusief de telemetrie van Snapshot Collector) gaat verloren en er zijn geen momentopnamen beschikbaar.
Uw toepassing kan vastlopen bij het opstarten met System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor.
Meer informatie over de functie Interop van Application Insights.		 Als u de geavanceerde optie Interop gebruikt, gebruikt u de codeloze momentopnameverzamelaarinjectie (ingeschakeld via Azure Portal).

Volgende stappen