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

Articolo
10/15/2024

Nota

Se si usa una versione di anteprima di .NET Core o l'applicazione fa riferimento ad Application Insights SDK, direttamente o indirettamente tramite un assembly dipendente, seguire le istruzioni per Abilitare Snapshot Debugger per altri ambienti per includere il pacchetto NuGet Microsoft.ApplicationInsights.SnapshotCollector con l'applicazione.

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 hanno memoria o spazio su disco sufficiente per salvare gli 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.

Azure portal
Azure Resource Manager

Dopo aver implementato l'app Web Servizi app .NET:

Nel portale di Azure passare al Servizio app.
Nel menu a sinistra selezionare Impostazioni>Application Insights.
Fare clic su Attiva Application Insights.
- Se si ha una risorsa di Application Insights esistente che si preferisce usare, selezionare l'opzione in Cambia risorsa.
In Instrumentare l'applicazione selezionare la scheda .NET.
Impostare entrambi gli interruttori di Snapshot Debugger su Attivo.
Snapshot Debugger è ora abilitato.

Disabilitare Snapshot Debugger

Per disabilitare Snapshot Debugger per la risorsa di Servizi app:

Nel portale di Azure passare al Servizio app.
Nel menu a sinistra selezionare Impostazioni>Application Insights.
Impostare gli interruttori di Snapshot Debugger su Disattivato.

È anche possibile configurare le impostazioni dell'app all'interno del modello di Azure Resource Manager per abilitare Snapshot Debugger e Profiler. Ad esempio:

{
  "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.

Proprietà della stringa di connessione	Cloud del governo USA	Cloud per la Cina
SnapshotEndpoint	`https://snapshot.monitor.azure.us`	`https://snapshot.monitor.azure.cn`

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:

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.
Configurare e abilitare Microsoft Entra ID nella risorsa di Application Insights. Per altre informazioni, vedere la documentazione seguente
Aggiungere l'impostazione dell'applicazione seguente. Questa impostazione indica all'agente Snapshot Debugger quale identità gestita usare:

Per l'identità assegnata dal sistema:

Impostazione app	Valore
APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Authorization=AD

Per l'identità assegnata dall'utente:

Impostazione app	Valore
APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Authorization=AD; ClientID={ID client dell'identità assegnata dall'utente}

Scenari non supportati

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

Scenario	Effetti collaterali	Elemento consigliato
È in uso Snapshot Collector SDK direttamente nell'applicazione (.csproj) ed è stata abilitata l'opzione di avanzamento "Interop".	Application Insights SDK locale (inclusi i dati di telemetria di Snapshot Collector) vengono persi e non sono disponibili snapshot. L'applicazione potrebbe arrestarsi in modo anomalo all'avvio con `System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor.` Altre informazioni sulla funzionalità "Interop" di Application Insights.	Se si usa l'opzione avanzata "Interop", usare l'inserimento di Snapshot Collector senza codice (abilitato tramite portale di Azure).

Passaggi successivi

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

Condividi tramite