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 o nel cloud.It works for ASP.NET apps that are hosted either in your own IIS server 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.

Prima di iniziareBefore you start

Sono necessari:You need:

  • Visual Studio 2013 Update 3 o versioni successive.Visual Studio 2013 update 3 or later. È preferibile una versione successiva.Later is better.
  • Una sottoscrizione a Microsoft Azure.A subscription to Microsoft Azure. Se il team o l'organizzazione ha una sottoscrizione di Azure, il proprietario potrà aggiungere l'utente alla sottoscrizione usando il rispettivo account Microsoft.If your team or organization has an Azure subscription, the owner can add you to it, by using your Microsoft account.

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

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

Fare clic con il pulsante destro del mouse sul progetto dell'app Web in Esplora soluzioni e scegliere Aggiungi > Application Insights Telemetry oppure Configura Application Insights.Right-click your web app project in Solution Explorer, and choose Add > Application Insights Telemetry... or Configure Application Insights.

Screenshot di Esplora soluzioni con le opzioni Aggiungi e Application Insights Telemetry evidenziate

In Visual Studio 2015, un'opzione per l'aggiunta di Application Insights è disponibile anche nella finestra di dialogo Nuovo progetto.(In Visual Studio 2015, there's also an option to add Application Insights in the New Project dialog.)

Passare alla pagina di configurazione di Application Insights:Continue to the Application Insights configuration page:

Screenshot della pagina Registra l'app con Application Insights

a.a. Selezionare l'account e la sottoscrizione usati per accedere ad Azure.Select the account and subscription that you use to access Azure.

b.b. Selezionare la risorsa in Azure in cui si vogliono visualizzare i dati dell'app.Select the resource in Azure where you want to see the data from your app. In genere:Usually:

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.

c.c. Impostare un tetto massimo al limite del volume di dati gratuito, per evitare eventuali addebiti.Set a cap at the free data volume limit, to avoid charges. Application Insights è gratuito fino a un determinato volume di dati di telemetria.Application Insights is free up to a certain volume of telemetry. Dopo aver creato la risorsa, è possibile modificare la selezione nel portale aprendo Funzionalità + prezzi > Gestione del volume dati > Limite di utilizzo volume giornaliero.After the resource is created, you can change your selection in the portal by opening Features + pricing > Data volume management > Daily volume cap.

d.d. Fare clic su Registra per proseguire e configurare Application Insights per l'app Web.Click Register to go ahead and configure Application Insights for your web app. 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.

e.e. 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. Si potranno visualizzare i dati di telemetria in Visual Studio durante il debug.You will be 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'app Step 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 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

In Visual Studio aprire la finestra di Application Insights.In Visual Studio, open the Application Insights window. Fare clic sul pulsante Application Insights oppure fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni, scegliere Application Insights e quindi fare clic su Cerca nei dati di telemetria attivi.Either click the Application Insights button, or right-click your project in Solution Explorer, select Application Insights, and then click Search Live Telemetry.

Nella finestra Ricerca di Application Insights di Visual Studio esaminare i dati di telemetria generati sul lato server dell'app nella visualizzazione Dati di Dati di telemetria della sessione di debug.In the Visual Studio Application Insights Search window, see the Data from Debug session view 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.

Nota

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 o fare clic con il pulsante destro del mouse sul progetto in Visual Studio e scegliere la risorsa.Either sign in to the Azure portal and find it there, or right-click the project in Visual Studio, and let it take you there.

Screenshot di Visual Studio che mostra come aprire il portale di Application Insights

Nota

Se viene visualizzato un errore di accesso, è possibile che si abbiano più set di credenziali Microsoft e che l'accesso sia stato eseguito con il set sbagliato.If you get an access error: Do you have more than one set of Microsoft credentials, and are you signed in with the wrong set? Nel portale disconnettersi e accedere nuovamente.In the portal, sign out and sign in again.

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 di nuovo Gestione pacchetti NuGet e filtrare i pacchetti installati.To upgrade to a new release of the SDK, open the NuGet package manager again, 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

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