Abilitare Snapshot Debugger per le app .NET nel Servizio app di Azure

Snapshot Debugger supporta attualmente ASP.NET e ASP.NET app Core in esecuzione nel Servizio app di Azure nei piani di servizio di Windows.

È consigliabile eseguire l'applicazione nei livelli di servizio Basic o superiore quando si usa Snapshot Debugger. Per la maggior parte delle applicazioni:

• I livelli di servizio Gratuito e Condiviso non dispongono di memoria o spazio su disco sufficiente per il salvataggio degli snapshot.
• Il livello A consumo non è attualmente disponibile per Snapshot Debugger.

Anche se Snapshot Debugger è preinstallato come parte del runtime di Servizi app, è necessario attivarlo per ottenere snapshot per l'app del Servizio app. L'installazione senza codice di Snapshot Debugger segue i criteri di supporto di .NET Core.

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

Generare traffico verso l'applicazione in grado di attivare un'eccezione. Attendere quindi 10-15 minuti perché le tracce inizino ad essere inviate all'istanza di Application Insights.

Abilitare Snapshot Debugger per altre aree cloud

Attualmente, le uniche aree che richiedono la modifica degli endpoint sono Azure per enti pubblici e Microsoft Azure gestito da 21Vianet tramite la stringa di connessione di Application Insights.

Per altre informazioni su altre sostituzioni di connessione, vedere la documentazione di Application Insights.

Configurare Snapshot Debugger

Abilitare l'autenticazione di Microsoft Entra per l'inserimento di snapshot

Snapshot Debugger supporta l'autenticazione di Microsoft Entra per l'inserimento di snapshot. Affinché tutti gli snapshot dell'applicazione vengano inseriti, l'applicazione deve essere autenticata ed è necessario fornire le impostazioni richieste dell'applicazione all'agente Snapshot Debugger.

Ad oggi, Snapshot Debugger supporta solo l'autenticazione di Microsoft Entra quando si fa riferimento a e si configura Microsoft Entra ID mediante Application Insights SDK nell'applicazione.

Per attivare Microsoft Entra ID per l'inserimento di snapshot nella risorsa di Servizi app:

1. Aggiungere l'identità gestita per l'autenticazione nella risorsa di Application Insights al Servizio app di Azure. È possibile creare una delle due operazioni seguenti:

   • Aggiungere un'identità gestita assegnata dal sistema.
   • Aggiungere un'identità gestita assegnata dall'utente.

2. Configurare e abilitare Microsoft Entra ID nella risorsa di Application Insights. Per altre informazioni, vedere la documentazione seguente

3. Aggiungere l'impostazione dell'applicazione seguente. Questa impostazione indica all'agente Snapshot Debugger quale identità gestita usare:

Per l'identità assegnata dal sistema:

Per l'identità assegnata dall'utente:

Scenari non supportati

Di seguito sono riportati gli scenari in cui Snapshot Collector non è supportato:

Passaggi successivi

• Visualizzare gli snapshot nel portale di Azure.
• Risolvere i problemi relativi a Snapshot Debugger.