Installare Application Insights per un sito Web ASP.NETSet up Application Insights for your ASP.NET website

Questa procedura consente di configurare un'app Web ASP.NET per l'invio di dati di telemetria al servizio Azure Application Insights.This procedure configures your ASP.NET web app to send telemetry to the Azure Application Insights service. È valida per le app ASP.NET ospitate nel server IIS locale o nel cloud.It works for ASP.NET apps that are hosted either in your own IIS server on-premises or in the Cloud. Offre grafici e un linguaggio di query avanzato che permettono di comprendere le prestazioni dell'app e il suo utilizzo da parte degli utenti, oltre ad avvisi automatici in caso di errori o problemi di prestazioni.You get charts and a powerful query language that help you understand the performance of your app and how people are using it, plus automatic alerts on failures or performance issues. Molti sviluppatori trovano utili queste funzionalità così come sono, ma è anche possibile estendere e personalizzare i dati di telemetria, se necessario.Many developers find these features great as they are, but you can also extend and customize the telemetry if you need to.

Il programma di installazione richiede pochi clic in Visual Studio.Setup takes just a few clicks in Visual Studio. Per evitare addebiti è possibile limitare il volume dei dati di telemetria.You have the option to avoid charges by limiting the volume of telemetry. In questo modo è possibile provare le funzionalità ed eseguire il debug o monitorare un sito con un numero di utenti limitato.This allows you to experiment and debug, or to monitor a site with not many users. Se si decide di monitorare l'intero sito di produzione, è facile aumentare il limite in un secondo momento.When you decide you want to go ahead and monitor your production site, it's easy to raise the limit later.

prerequisitiPrerequisites

Per aggiungere Application Insights al sito Web ASP.NET è necessario:To add Application Insights to your ASP.NET website, you need to:

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

Passaggio 1: Aggiungere Application Insights SDKStep 1: Add the Application Insights SDK

Importante

Il processo di aggiunta di Application Insights varia in base al tipo di modello ASP.NET.The process to add Application Insights varies by ASP.NET template type. Se si usa il modello Vuoto o App per dispositivi mobili di Azure, selezionare Progetto > Aggiungi Application Insights Telemetry.If you are using the Empty or Azure Mobile App template select Project > Add Application Insights Telemetry. Per tutti gli altri modelli ASP.NET, vedere le istruzioni seguenti.For all other ASP.NET templates consult the instructions below.

In Esplora soluzioni fare clic con il pulsante destro del mouse sull'app Web e scegliere Configura Application InsightsRight-click your web app name in the Solution Explorer, and choose Configure Application Insights

Screenshot di Esplora soluzioni con l'opzione Configura Application Insights evidenziata

A seconda della versione di Application Insights SDK potrebbe essere richiesto di eseguire l'aggiornamento alla versione più recente dell'SDK.(Depending on your Application Insights SDK version you may be prompted to upgrade to the latest SDK release. Quando richiesto, selezionare Aggiorna SDK.If prompted, select Update SDK.)

Screenshot: È disponibile una nuova versione di Microsoft Application Insights SDK.

Schermata di configurazione di Application Insights:Application Insights Configuration screen:

Selezionare Inizia gratis.Select Start Free.

Screenshot della pagina Registra l'app con Application Insights

Se si vuole impostare il gruppo di risorse o la località in cui verranno archiviati i dati, fare clic su Configura impostazioni.If you want to set the resource group or the location where your data is stored, click Configure settings. I gruppi di risorse vengono usati per controllare l'accesso ai dati.Resource groups are used to control access to data. Se si hanno diverse app che fanno parte dello stesso sistema, ad esempio, è possibile inserire i relativi dati di Application Insights nello stesso gruppo di risorse.For example, if you have several apps that form part of the same system, you might put their Application Insights data in the same resource group.

Selezionare Registra.Select Register.

Screenshot della pagina Registra l'app con Application Insights

I dati di telemetria verranno inviati al portale di Azure, sia durante il debug che dopo la pubblicazione dell'app.Telemetry will be sent to the Azure portal, both during debugging and after you have published your app.

Nota

Per non inviare i dati di telemetria al portale durante il debug, è possibile aggiungere Application Insights SDK all'app senza configurare una risorsa nel portale.If you don't want to send telemetry to the portal while you're debugging, just add the Application Insights SDK to your app but don't configure a resource in the portal. È possibile visualizzare i dati di telemetria in Visual Studio durante il debug.You are able to see telemetry in Visual Studio while you are debugging. Successivamente, è possibile tornare a questa pagina di configurazione oppure attendere di aver distribuito l'app e quindi attivare la telemetria in fase di esecuzione.Later, you can return to this configuration page, or you could wait until after you have deployed your app and switch on telemetry at run time.

Passaggio 2: Eseguire l'appStep 2: Run your app

Eseguire l'app con F5.Run your app with F5. Aprire pagine diverse per generare alcuni dati di telemetria.Open different pages to generate some telemetry.

In Visual Studio verrà visualizzato il conteggio degli eventi che sono stati registrati.In Visual Studio, you will see a count of the events that have been logged.

Screenshot di Visual Studio.

Passaggio 3: Visualizzare i dati di telemetriaStep 3: See your telemetry

È possibile visualizzare i dati di telemetria in Visual Studio o nel portale Web di Application Insights.You can see your telemetry either in Visual Studio or in the Application Insights web portal. Cercare i dati di telemetria in Visual Studio per eseguire il debug dell'app.Search telemetry in Visual Studio to help you debug your app. Monitorare le prestazioni e l'utilizzo nel portale Web quando il sistema è attivo.Monitor performance and usage in the web portal when your system is live.

Visualizzare i dati di telemetria in Visual StudioSee your telemetry in Visual Studio

Per visualizzare i dati di Application Insights, in Visual StudioIn Visual Studio, to view Application Insights data. selezionare Esplora soluzioni > Servizi connessi > fare clic con il pulsante destro del mouse su Application Insights e quindi scegliere Cerca nei dati di telemetria attivi.Select Solution Explorer > Connected Services > right-click Application Insights, and then click Search Live Telemetry.

Nella finestra Ricerca di Application Insights di Visual Studio verranno visualizzati i dati di telemetria dell'applicazione generati sul lato server dell'app.In the Visual Studio Application Insights Search window, you will see the data from your application for telemetry generated in the server side of your app. Sperimentare i filtri e fare clic su qualsiasi evento per visualizzare altri dettagli.Experiment with the filters, and click any event to see more detail.

Screenshot della visualizzazione Dati di Dati di telemetria della sessione di debug nella finestra di Application Insights.

Suggerimento

Se non vengono visualizzati dati, verificare che l'intervallo di tempo sia corretto e fare clic sull'icona di ricerca.If you don't see any data, make sure the time range is correct, and click the Search icon.

Uso di Application Insights in Visual Studio.Learn more about Application Insights tools in Visual Studio.

Visualizzare i dati di telemetria nel portale WebSee telemetry in web portal

Se non si è scelto di installare solo l'SDK, è possibile visualizzare i dati di telemetria anche nel portale Web di Application Insights.You can also see telemetry in the Application Insights web portal (unless you chose to install only the SDK). Il portale offre un maggior numero di grafici, strumenti di analisi e viste di più componenti rispetto a Visual Studio.The portal has more charts, analytic tools, and cross-component views than Visual Studio. Nel portale sono anche disponibili avvisi.The portal also provides alerts.

Aprire la risorsa Application Insights.Open your Application Insights resource. Accedere al portale di Azure per cercarla oppure selezionare Esplora soluzioni > Servizi connessi > fare clic con il pulsante destro del mouse su Application Insights > Apri portale Application Insights.Either sign into the Azure portal and find it there, or select Solution Explorer > Connected Services > right-click Application Insights > Open Application Insights Portal and let it take you there.

Nel portale verrà visualizzata la telemetria dell'app.The portal opens on a view of the telemetry from your app.

Screenshot della pagina Panoramica di Application Insights

Per visualizzare altri dettagli nel portale, fare clic su qualsiasi riquadro o grafico.In the portal, click any tile or chart to see more detail.

Altre informazioni sull'uso di Application Insights nel portale di Azure.Learn more about using Application Insights in the Azure portal.

Passaggio 4: Pubblicare l'appStep 4: Publish your app

Pubblicare l'app nel server IIS o in Azure.Publish your app to your IIS server or to Azure. Verificare in Flusso metriche attive che tutto funzioni correttamente.Watch Live Metrics Stream to make sure everything is running smoothly.

La telemetria viene creata nel portale di Application Insights, in cui è possibile monitorare le metriche, eseguire ricerche sui dati di telemetria e configurare i dashboard,Your telemetry builds up in the Application Insights portal, where you can monitor metrics, search your telemetry, and set up dashboards. nonché usare l'avanzato linguaggio di query di Log Analytics per analizzare l'utilizzo e le prestazioni o trovare eventi specifici.You can also use the powerful Log Analytics query language to analyze usage and performance, or to find specific events.

È anche possibile continuare ad analizzare i dati di telemetria in Visual Studio con strumenti come la ricerca diagnostica e le tendenze.You can also continue to analyze your telemetry in Visual Studio, with tools such as diagnostic search and trends.

Nota

Se la quantità di dati di telemetria inviata dall'app sta per raggiungere le limitazioni, viene attivato il campionamento automatico.If your app sends enough telemetry to approach the throttling limits, automatic sampling switches on. Il campionamento riduce la quantità di dati di telemetria inviata dall'app mantenendo i dati correlati per scopi diagnostici.Sampling reduces the quantity of telemetry sent from your app, while preserving correlated data for diagnostic purposes.

Le impostazioni sono state completate.You're all set

Congratulazioni!Congratulations! Il pacchetto Application Insights è stato installato nell'app e configurato per l'invio di dati di telemetria al servizio Application Insights in Azure.You installed the Application Insights package in your app, and configured it to send telemetry to the Application Insights service on Azure.

Diagramma dello spostamento dei dati di telemetria

La risorsa di Azure che riceve i dati di telemetria dell'app è identificata da una chiave di strumentazione,The Azure resource that receives your app's telemetry is identified by an instrumentation key. disponibile nel file ApplicationInsights.config.You'll find this key in the ApplicationInsights.config file.

Eseguire l'aggiornamento alle versioni future dell'SDKUpgrade to future SDK versions

Per eseguire l'aggiornamento a una nuova versione dell'SDK, aprire Gestione pacchetti NuGet e filtrare i pacchetti installati.To upgrade to a new release of the SDK, open the NuGet package manager, and filter on installed packages. Selezionare Microsoft.ApplicationInsights.Web e scegliere Aggiorna.Select Microsoft.ApplicationInsights.Web, and choose Upgrade.

Se sono state apportate personalizzazioni a ApplicationInsights.config, salvarne una copia prima di eseguire l'aggiornamento.If you made any customizations to ApplicationInsights.config, save a copy of it before you upgrade. Successivamente, unire le modifiche nella nuova versione.Then, merge your changes into the new version.

VideoVideo

Passaggi successiviNext steps

Se si è interessati, vedere gli argomenti alternativi seguenti:There are alternative topics to look at if you are interested in:

Altri dati di telemetriaMore telemetry

AnalisiAnalysis

AvvisiAlerts

  • Test di disponibilità: creare test per verificare che il sito sia visibile sul Web.Availability tests: Create tests to make sure your site is visible on the web.
  • Diagnostica intelligente: questi test vengono eseguiti automaticamente e non è quindi necessario effettuare alcuna operazione per configurarli.Smart diagnostics: These tests run automatically, so you don't have to do anything to set them up. Se l'app ha una frequenza insolita di richieste non riuscite, verrà comunicato automaticamente.They tell you if your app has an unusual rate of failed requests.
  • Avvisi per le metriche: impostare questi avvisi per essere avvertiti se una metrica supera una soglia.Metric alerts: Set these to warn you if a metric crosses a threshold. È possibile impostarli nelle metriche personalizzate di cui si scrive il codice nell'app.You can set them on custom metrics that you code into your app.

AutomazioneAutomation