Eseguire il debug delle applicazioni con Azure Application Insights in Visual StudioDebug your applications with Azure Application Insights in Visual Studio

In Visual Studio 2015 e versioni successive è possibile analizzare le prestazioni e diagnosticare i problemi nell'app Web ASP.NET sia durante il debug che nell'ambiente di produzione, usando i dati di telemetria di Azure Application Insights.In Visual Studio (2015 and later), you can analyze performance and diagnose issues in your ASP.NET web app both in debugging and in production, using telemetry from Azure Application Insights.

Se l'app web ASP.NET è stata creata con Visual Studio 2017 o versioni successive, include già Application Insights SDK.If you created your ASP.NET web app using Visual Studio 2017 or later, it already has the Application Insights SDK. In caso contrario, se non è ancora stato fatto, aggiungere Application Insights all'app.Otherwise, if you haven't done so already, add Application Insights to your app.

Per monitorare l'app quando è in produzione, in genere si visualizzano i dati di telemetria di Application Insights nel portale di Azure, che permette di impostare gli avvisi e applicare strumenti di monitoraggio efficaci.To monitor your app when it's in live production, you normally view the Application Insights telemetry in the Azure portal, where you can set alerts and apply powerful monitoring tools. Per il debug, invece, è anche possibile cercare e analizzare i dati di telemetria in Visual Studio.But for debugging, you can also search and analyze the telemetry in Visual Studio. È possibile usare Visual Studio per analizzare i dati di telemetria sia dal sito di produzione che dalle esecuzioni di debug nel computer di sviluppo.You can use Visual Studio to analyze telemetry both from your production site and from debugging runs on your development machine. Nel secondo caso, è possibile analizzare le esecuzioni di debug anche se non è ancora stato configurato l'SDK per l'invio dei dati di telemetria al portale di Azure.In the latter case, you can analyze debugging runs even if you haven't yet configured the SDK to send telemetry to the Azure portal.

Eseguire il debug del progettoDebug your project

Per eseguire l'app Web in modalità di debug locale, premere F5.Run your web app in local debug mode by using F5. Aprire pagine diverse per generare alcuni dati di telemetria.Open different pages to generate some telemetry.

In Visual Studio viene visualizzato un conteggio degli eventi registrati dal modulo di Application Insights nel progetto.In Visual Studio, you see a count of the events that have been logged by the Application Insights module in your project.

In Visual Studio il pulsante Application Insights viene visualizzato durante il debug.

Fare clic su questo pulsante per cercare nei dati di telemetria.Click this button to search your telemetry.

La finestra di ricerca di Application Insights mostra gli eventi che sono stati registrati.The Application Insights Search window shows events that have been logged. Se è stato eseguito l'accesso ad Azure durante la configurazione di Application Insights, è possibile cercare gli stessi eventi nel portale di Azure.(If you signed in to Azure when you set up Application Insights, you can search the same events in the Azure portal.)

Fare clic con il pulsante destro del mouse sul progetto e scegliere Application Insights, Cerca.

Nota

Dopo aver selezionato o deselezionato i filtri, fare clic sul pulsante di ricerca alla fine del campo di ricerca di testo.After you select or deselect filters, click the Search button at the end of the text search field.

La ricerca di testo libero funziona in tutti i campi degli eventi.The free text search works on any fields in the events. Ad esempio, è possibile cercare parte dell'URL di una pagina, il valore di una proprietà, come la città del client, o parole specifiche in un log di traccia.For example, search for part of the URL of a page; or the value of a property such as client city; or specific words in a trace log.

Fare clic su qualsiasi evento per visualizzarne le proprietà dettagliate.Click any event to see its detailed properties.

Per le richieste all'app Web, è possibile fare clic per visualizzare il codice.For requests to your web app, you can click through to the code.

In Dettagli richiesta fare clic per visualizzare il codice

È anche possibile aprire gli elementi correlati per diagnosticare le richieste non riuscite o le eccezioni.You can also open related items to help diagnose failed requests or exceptions.

In Dettagli richiesta scorrere fino agli elementi correlati

Visualizzare le eccezioni e le richieste non riusciteView exceptions and failed requests

I report delle eccezioni vengono visualizzati nella finestra di ricerca.Exception reports show in the Search window. In alcuni tipi di applicazioni ASP.NET meno recenti è necessario configurare il monitoraggio delle eccezioni per visualizzare le eccezioni gestite dal framework.(In some older types of ASP.NET application, you have to set up exception monitoring to see exceptions that are handled by the framework.)

Fare clic su un'eccezione per ottenere un'analisi dello stack.Click an exception to get a stack trace. Se il codice dell'app è aperto in Visual Studio, è possibile fare clic nell'analisi dello stack per visualizzare la relativa riga del codice.If the code of the app is open in Visual Studio, you can click through from the stack trace to the relevant line of the code.

Analisi dello stack delle eccezioni

Visualizzare i riepiloghi delle richieste ed eccezioni nel codiceView request and exception summaries in the code

Nella riga CodeLens sopra ogni metodo del gestore viene visualizzato un conteggio delle richieste e delle eccezioni registrate da Application Insights nelle ultime 24 ore.In the Code Lens line above each handler method, you see a count of the requests and exceptions logged by Application Insights in the past 24 h.

Analisi dello stack delle eccezioni

Nota

CodeLens mostra i dati di Application Insights unicamente se l'app è configurata per l'invio dei dati di telemetria al portale di Application Insights.Code Lens shows Application Insights data only if you have configured your app to send telemetry to the Application Insights portal.

Altre informazioni su Application Insights in CodeLensMore about Application Insights in Code Lens

Tendenze è uno strumento che permette di visualizzare il comportamento dell'app nel tempo.Trends is a tool for visualizing how your app behaves over time.

Scegliere Esplora tendenze di telemetria usando il pulsante della barra degli strumenti di Application Insights o la finestra di ricerca di Application Insights.Choose Explore Telemetry Trends from the Application Insights toolbar button or Application Insights Search window. Scegliere una delle cinque query più comuni per iniziare.Choose one of five common queries to get started. È possibile analizzare set di dati diversi in base ai tipi di dati di telemetria, agli intervalli di tempo e ad altre proprietà.You can analyze different datasets based on telemetry types, time ranges, and other properties.

Per trovare le anomalie nei dati, scegliere una delle opzioni relative alle anomalie nell'elenco a discesa del tipo di visualizzazione.To find anomalies in your data, choose one of the anomaly options under the "View Type" dropdown. Le opzioni di filtro nella parte inferiore della finestra permettono di trovare facilmente subset specifici dei dati di telemetria.The filtering options at the bottom of the window make it easy to hone in on specific subsets of your telemetry.

Tendenze

Altre informazioni su Tendenze.More about Trends.

Monitoraggio localeLocal monitoring

(Da Visual Studio 2015 Update 2) Se l'SDK non è stato configurato per l'invio della telemetria al portale di Application Insights (e quindi non è presente nessuna chiave di strumentazione in ApplicationInsights.config), la finestra di diagnostica visualizza la telemetria dalla sessione di debug più recente.(From Visual Studio 2015 Update 2) If you haven't configured the SDK to send telemetry to the Application Insights portal (so that there is no instrumentation key in ApplicationInsights.config) then the diagnostics window displays telemetry from your latest debugging session.

Questo è consigliabile se è già stata pubblicata una versione precedente dell'app.This is desirable if you have already published a previous version of your app. Si vuole però evitare di combinare la telemetria delle sessioni di debug con la telemetria nel portale di Application Insights dell'app pubblicata.You don't want the telemetry from your debugging sessions to be mixed up with the telemetry on the Application Insights portal from the published app.

È utile anche se si vuole eseguire il debug di alcuni dati di telemetria personalizzati prima di inviarli al portale.It's also useful if you have some custom telemetry that you want to debug before sending telemetry to the portal.

  • Inizialmente, Application Insights è stato interamente configurato per inviare i dati di telemetria al portale. Ora però si vuole fare in modo che i dati di telemetria vengano visualizzati solo in Visual Studio.At first, I fully configured Application Insights to send telemetry to the portal. But now I'd like to see the telemetry only in Visual Studio.

    • Nelle impostazioni della finestra di ricerca è disponibile un'opzione per cercare la diagnostica locale anche se l'app invia la telemetria al portale.In the Search window's Settings, there's an option to search local diagnostics even if your app sends telemetry to the portal.
    • Per arrestare l'invio dei dati di telemetria al portale, impostare come commento la riga <instrumentationkey>... di ApplicationInsights.config. Quando si è pronti a inviare nuovamente i dati di telemetria al portale, rimuovere il commento.To stop telemetry being sent to the portal, comment out the line <instrumentationkey>... from ApplicationInsights.config. When you're ready to send telemetry to the portal again, uncomment it.

Passaggi successiviNext steps

Aggiungere altri datiAdd more data
Monitorare l'utilizzo, la disponibilità, le dipendenze e le eccezioni,Monitor usage, availability, dependencies, exceptions. integrare le tracce dei framework di registrazioneIntegrate traces from logging frameworks. e scrivere telemetria personalizzata.Write custom telemetry.
Visual Studio
Uso del portale Application InsightsWorking with the Application Insights portal
Visualizzare i dashboard, strumenti avanzati di diagnostica e di analisi, avvisi, una mappa attiva delle dipendenze dell'applicazione e i dati di telemetria esportati.View dashboards, powerful diagnostic and analytic tools, alerts, a live dependency map of your application, and exported telemetry data.
Visual Studio