Abilitare Profiler per le app del servizio app Azure

  • Articolo

Application Insights Profiler è preinstallato come parte del runtime del servizio app Azure. È possibile eseguire Profiler in ASP.NET e ASP.NET app Core in esecuzione in servizio app usando il livello di servizio Basic o superiore. Seguire questa procedura, anche se è stato incluso Application Insights SDK nell'applicazione in fase di compilazione.

Per abilitare Profiler in Linux, seguire le istruzioni ASP.NET core per le app Web Linux di Azure.

Nota

L'installazione senza codice di Application Insights Profiler segue i criteri di supporto di .NET Core. Per altre informazioni sul runtime supportato, vedere Criteri di supporto di .NET Core.

Prerequisiti

Verificare che l'impostazione "Always On" sia abilitata

  1. Nella portale di Azure passare all'istanza di servizio app.

  2. In Impostazioni nel riquadro sinistro selezionare Configurazione.

    Screenshot that shows selecting Configuration on the left pane.

  3. Seleziona la scheda Impostazioni generali.

  4. Verificare che l'opzione Always On> sia selezionata.

    Screenshot that shows the General tab on the Configuration pane showing that Always On is enabled.

  5. Se sono state apportate modifiche, selezionare Salva.

Abilitare Application Insights e Profiler

Le sezioni seguenti illustrano come abilitare Application Insights per la stessa sottoscrizione o sottoscrizioni diverse.

Per Application Insights e servizio app nella stessa sottoscrizione

Se la risorsa di Application Insights si trova nella stessa sottoscrizione dell'istanza di servizio app:

  1. In Impostazioni nel riquadro sinistro selezionare Application Insights.

    Screenshot that shows selecting Application Insights on the left pane.

  2. In Application Insights selezionare Abilita.

  3. Verificare di aver connesso una risorsa di Application Insights all'app.

    Screenshot that shows enabling Application Insights on your app.

  4. Scorrere verso il basso e selezionare la scheda .NET o .NET Core , a seconda dell'app.

  5. Verificare che sia selezionato Livello>di raccolta Consigliato.

  6. In Profiler selezionare Sì.

    Se in precedenza si è scelto il livello di raccolta Basic , l'impostazione profiler è disabilitata.

  7. Selezionare Applica sì> per confermare.

    Screenshot that shows enabling Profiler on your app.

Per Application Insights e servizio app in sottoscrizioni diverse

Se la risorsa di Application Insights si trova in una sottoscrizione diversa dall'istanza di servizio app, è necessario abilitare Profiler manualmente creando le impostazioni dell'app per l'istanza di servizio app. È possibile automatizzare la creazione di queste impostazioni usando un modello o altri mezzi. Ecco le impostazioni necessarie per abilitare Profiler.

Impostazione app Valore
APPINSIGHTS_INSTRUMENTATIONKEY iKey della risorsa di Application Insights
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
DiagnosticServices_EXTENSION_VERSION ~3

Impostare questi valori usando:

Abilitare Profiler per i cloud a livello di area

Attualmente, le uniche aree che richiedono modifiche agli endpoint sono Azure per enti pubblici e Microsoft Azure gestito da 21Vianet.

Impostazione app US Government Cloud Cloud per la Cina
ApplicationInsightsProfilerEndpoint https://profiler.monitor.azure.us https://profiler.monitor.azure.cn
ApplicationInsightsEndpoint https://dc.applicationinsights.us https://dc.applicationinsights.azure.cn

Abilitare l'autenticazione di Microsoft Entra per l'inserimento del profilo

Application Insights Profiler supporta l'autenticazione di Microsoft Entra per l'inserimento del profilo. Affinché tutti i profili dell'applicazione vengano inseriti, l'applicazione deve essere autenticata e fornire le impostazioni dell'applicazione necessarie all'agente profiler.

Profiler supporta solo l'autenticazione di Microsoft Entra quando si fa riferimento e si configura l'ID Entra di Microsoft usando Application Insights SDK nell'applicazione.

Per abilitare Microsoft Entra ID per l'inserimento del profilo:

  1. Creare e aggiungere l'identità gestita per l'autenticazione con la risorsa di Application Insights all'servizio app:

    1. Documentazione dell'identità gestita assegnata dal sistema

    2. Documentazione dell'identità gestita assegnata dall'utente

  2. Configurare e abilitare l'ID Microsoft Entra nella risorsa di Application Insights.

  3. Aggiungere l'impostazione dell'applicazione seguente per informare l'agente profiler dell'identità gestita da usare.

    • Per l'identità assegnata dal sistema:

      Impostazione app Valore
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD

    • Per l'identità assegnata dall'utente:

      Impostazione app Valore
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD;ClientId={Client id of the User-Assigned Identity}

Disabilitare Profiler

Per arrestare o riavviare Profiler per un'istanza di una singola app:

  1. In Impostazioni nel riquadro sinistro selezionare Processi Web.

    Screenshot that shows selecting web jobs on the left pane.

  2. Selezionare il processo Web denominato ApplicationInsightsProfiler3.

  3. Selezionare Interrompi.

    Screenshot that shows selecting stop for stopping the webjob.

  4. Seleziona Sì per confermare.

È consigliabile abilitare Profiler su tutte le app per individuare il prima possibile eventuali problemi di prestazioni.

È possibile eliminare i file di Profiler quando si usa WebDeploy per distribuire le modifiche all'applicazione Web. È possibile impedire l'eliminazione escludendo l'eliminazione della cartella App_Data durante la distribuzione.

Passaggi successivi