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

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.

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

U wordt aangeraden uw toepassing uit te voeren op de Basic- of hogere servicelagen wanneer u snapshot debugger gebruikt. Voor de meeste toepassingen:

• De servicelagen Gratis en Gedeeld hebben onvoldoende geheugen of schijfruimte om momentopnamen te besparen.
• De verbruikslaag is momenteel niet beschikbaar voor het foutopsporingsprogramma voor momentopnamen.

Hoewel Snapshot Debugger vooraf is geïnstalleerd als onderdeel van de App Services-runtime, moet u deze inschakelen om momentopnamen voor uw App Service-app op te halen. Installatie zonder code van Snapshot Debugger volgt het .NET Core-ondersteuningsbeleid.

Azure-portal

U kunt snapshot debugger inschakelen in Azure Portal nadat u uw .NET App Services-web-app hebt geïmplementeerd.

1. Navigeer naar uw App Services-web-app in Azure Portal.

2. Selecteer In het menu aan de linkerkant Instellingen>Application Insights.

   

3. Klik op Application Insights inschakelen.

   • Als u een bestaande Application Insights-resource hebt die u liever gebruikt, selecteert u die optie onder Resource wijzigen.

4. Selecteer onder Instrument your application het tabblad .NET .

5. Zet beide schakeloptie voor momentopnamenopsporing op Aan.

   

6. Snapshot Debugger is nu ingeschakeld.

Snapshot Debugger uitschakelen

Snapshot Debugger uitschakelen voor uw App Services-resource:

1. Navigeer naar uw App Service in Azure Portal.

2. Selecteer In het menu aan de linkerkant Instellingen>Application Insights.

3. Zet de schakeloptie Snapshot Debugger op Uit.

Azure Resource Manager

U kunt ook Snapshot Debugger en .NET Profiler inschakelen met behulp van app-instellingen in de Azure Resource Manager-sjabloon. Voorbeeld:

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

Genereer verkeer naar uw toepassing waarmee een uitzondering kan worden geactiveerd. Wacht vervolgens 10 tot 15 minuten totdat momentopnamen naar het Application Insights-exemplaar zijn verzonden.

Snapshot Debugger inschakelen voor andere cloudregio's

Momenteel zijn de enige regio's die eindpuntwijzigingen vereisen Azure Government en Microsoft Azure beheerd door 21Vianet via de Application Insights-verbindingsreeks.

Eigenschap Verbindingsreeks	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.

Snapshot Debugger configureren

Microsoft Entra-verificatie inschakelen voor opname van momentopnamen

Notitie

Snapshot Debugger ondersteunt momenteel alleen Microsoft Entra-verificatie wanneer u verwijst naar Entra-id en configureert met behulp van de Application Insights SDK in uw toepassing.

Snapshot Debugger ondersteunt Microsoft Entra-verificatie voor opname van momentopnamen. Voor alle momentopnamen van uw toepassing die moeten worden opgenomen, moet uw toepassing worden geverifieerd en de vereiste toepassingsinstellingen opgeven voor de Agent voor foutopsporing voor momentopnamen.

1. Voeg de beheerde identiteit toe die wordt geverifieerd voor uw Application Insights-resource aan uw App Service. U kunt een van de volgende opties maken:

   • Een door het systeem toegewezen beheerde identiteit.
   • Een door de gebruiker toegewezen beheerde identiteit.

2. Configureer en schakel Microsoft Entra-id in uw Application Insights-resource in de portal in.

3. Voeg de volgende toepassingsinstelling toe. Met deze instelling wordt aan de agent voor het foutopsporingsprogramma voor momentopnamen aangegeven welke beheerde identiteit moet worden gebruikt:

   Voor door het systeem toegewezen identiteit:

   App-instelling	Weergegeven als
   APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Autorisatie=AD

   Voor door de gebruiker toegewezen identiteit:

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

Niet-ondersteunde scenario's

In de volgende scenario's ziet u waar Snapshot Collector niet wordt ondersteund.

Scenario	Neveneffecten	Aanbeveling
U gebruikt de Snapshot Collector SDK in uw toepassing rechtstreeks (.csproj) en 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

• Momentopnamen weergeven in Azure Portal.
• Problemen met het foutopsporingsprogramma voor momentopnamen oplossen.