Iniziare a monitorare l'applicazione Web ASP.NET CoreStart Monitoring Your ASP.NET Core Web Application

Con Azure Application Insights, è possibile monitorare facilmente la disponibilità, le prestazioni e l'uso dell'applicazione Web.With Azure Application Insights, you can easily monitor your web application for availability, performance, and usage. È anche possibile identificare e diagnosticare rapidamente gli errori nell'applicazione senza attendere che vengano segnalati da un utente.You can also quickly identify and diagnose errors in your application without waiting for a user to report them.

Questa guida introduttiva illustra l'aggiunta di Application Insights SDK a un'applicazione Web ASP.Net Core esistente.This quickstart guides you through adding the Application Insights SDK to an existing ASP.Net Core web application.

prerequisitiPrerequisites

Per completare questa guida introduttiva:To complete this quickstart:

Se non si ha un'applicazione Web ASP.NET Core, è possibile crearne una seguendo le istruzioni della guida per creare un'app Web ASP.NET Core.If you don't have a ASP.NET Core web application, you can create one by following the Create an ASP.NET Core Web App Guide.

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.

Accedere al Portale di AzureLog in to the Azure portal

Accedere al Portale di Azure.Log in to the Azure portal.

Abilitare Application InsightsEnable Application Insights

Application Insights può raccogliere dati di telemetria da un'applicazione connessa a Internet, indipendentemente dal fatto che sia in esecuzione in locale o nel cloud.Application Insights can gather telemetry data from any internet-connected application, regardless of whether it's running on-premises or in the cloud. Usare la procedura seguente per iniziare a visualizzare questi dati.Use the following steps to start viewing this data.

  1. Selezionare Crea una risorsa > Monitoraggio e gestione > Application Insights.Select Create a resource > Monitoring + Management > Application Insights.

    Aggiunta di una risorsa di Application Insights

    Verrà visualizzata una casella di configurazione. Usare la tabella seguente per completare i campi di input.A configuration box appears; use the following table to fill out the input fields.

    ImpostazioniSettings ValoreValue DESCRIZIONEDescription
    NomeName Valore globalmente univocoGlobally Unique Value Nome che identifica l'app da monitorareName that identifies the app you are monitoring
    Tipo di applicazioneApplication Type Applicazione Web ASP.NETASP.NET web application Tipo di app da monitorareType of app you are monitoring
    Gruppo di risorseResource Group myResourceGroupmyResourceGroup Nome del nuovo gruppo di risorse per l'hosting dei dati di Application InsightsName for the new resource group to host App Insights data
    PosizioneLocation Stati Uniti orientaliEast US Scegliere una località nelle vicinanze o vicina a quella in cui è ospitata l'appChoose a location near you, or near where your app is hosted
  2. Fare clic su Crea.Click Create.

Configurare Application Insights SDKConfigure App Insights SDK

  1. Aprire il progetto dell'app Web ASP.NET Core in Visual Studio, quindi fare clic con il pulsante destro del mouse sul nome dell'app in Esplora soluzioni e scegliere Aggiungi > Application Insights Telemetry.Open your ASP.NET Core Web App project in Visual Studio > Right-click on the AppName in the Solution Explorer > Select Add > Application Insights Telemetry.

    Aggiungere Application Insights Telemetry

  2. Fare clic sul pulsante Inizia gratis, selezionare la risorsa esistente creata nel portale di Azure e quindi fare clic su Registra.Click the Start Free button > Select the Existing resource you created in the Azure portal > Click Register.

  3. Selezionare Debug > Avvia senza eseguire debug (CTRL+F5) per avviare l'app.Select Debug > Start without Debugging (Ctrl+F5) to Launch your app

Nota

Prima che i dati vengano visualizzati nel portale trascorrono 3-5 minuti.It takes 3-5 minutes before data begins appearing in the portal. Se questa app è un'app di test a basso traffico, occorre ricordare che la maggior parte delle metriche viene acquisita solo in presenza di operazioni o richieste attive.If this app is a low-traffic test app, keep in mind that most metrics are only captured when there are active requests or operations.

Avviare il monitoraggio nel portale di AzureStart monitoring in the Azure portal

  1. È ora possibile riaprire la pagina Panoramica di Application Insights nel portale di Azure, selezionando Progetto > Application Insights > Apri portale Application Insights, per visualizzare informazioni dettagliate sull'applicazione attualmente in esecuzione.You can now reopen the Application Insights Overview page in the Azure portal by selecting Project > Application Insights > Open Application Insights Portal, to view details about your currently running application.

    Menu della panoramica di Application Insights

  2. Fare clic su Mappa app per ottenere un layout visivo delle relazioni di dipendenza tra i componenti dell'applicazione.Click App map for a visual layout of the dependency relationships between your application components. Ogni componente mostra indicatori KPI come carico, prestazioni, errori e avvisi.Each component shows KPIs such as load, performance, failures, and alerts.

    Mappa delle applicazioni

  3. Fare clic sull'icona di App Analytics Icona Mappa app.Click on the App Analytics icon Application Map icon. Verrà aperta la finestra Application Insights - Analisi, che fornisce un linguaggio di query avanzato per l'analisi di tutti i dati raccolti da Application Insights.This opens Application Insights Analytics, which provides a rich query language for analyzing all data collected by Application Insights. In questo caso viene generata una query che esegue il rendering del conteggio delle richieste sotto forma di grafico.In this case, a query is generated for you that renders the request count as a chart. È possibile scrivere query personalizzate per analizzare altri dati.You can write your own queries to analyze other data.

    Grafico di analisi delle richieste di un utente in un periodo di tempo

  4. Tornare alla pagina Panoramica ed esaminare Integrità - Panoramica sequenza temporale.Return to the Overview page and examine the Health Overview timeline. Questo dashboard fornisce statistiche relative all'integrità dell'applicazione, ad esempio il numero di richieste in ingresso, la durata delle richieste ed eventuali errori che si sono verificati.This dashboard provides statistics about your application health, including the number of incoming requests, the duration of those requests, and any failures that occur.

    Grafici Integrità - Panoramica sequenza temporale

    Per abilitare la popolazione del grafico Tempo di caricamento della visualizzazione pagina con i dati di telemetria lato client, aggiungere questo script a ogni pagina da verificare:To enable the Page View Load Time chart to populate with client-side telemetry data, add this script to each page that you want to track:

    <!-- 
    To collect end-user usage analytics about your application, 
    insert the following script into each page you want to track.
    Place this code immediately before the closing </head> tag,
    and before any other scripts. Your first data will appear 
    automatically in just a few seconds.
    -->
    <script type="text/javascript">
      var appInsights=window.appInsights||function(config){
        function i(config){t[config]=function(){var i=arguments;t.queue.push(function(){t[config].apply(t,i)})}}var t={config:config},u=document,e=window,o="script",s="AuthenticatedUserContext",h="start",c="stop",l="Track",a=l+"Event",v=l+"Page",y=u.createElement(o),r,f;y.src=config.url||"https://az416426.vo.msecnd.net/scripts/a/ai.0.js";u.getElementsByTagName(o)[0].parentNode.appendChild(y);try{t.cookie=u.cookie}catch(p){}for(t.queue=[],t.version="1.0",r=["Event","Exception","Metric","PageView","Trace","Dependency"];r.length;)i("track"+r.pop());return i("set"+s),i("clear"+s),i(h+a),i(c+a),i(h+v),i(c+v),i("flush"),config.disableExceptionTracking||(r="onerror",i("_"+r),f=e[r],e[r]=function(config,i,u,e,o){var s=f&&f(config,i,u,e,o);return s!==!0&&t["_"+r](config,i,u,e,o),s}),t
        }({
            instrumentationKey:"<insert instrumentation key>"
        });
    
        window.appInsights=appInsights;
        appInsights.trackPageView();
    </script>
    
  5. Fare clic su Browser sotto l'intestazione Analisi.Click on Browser from under the Investigate header. Qui sono disponibili le metriche correlate alle prestazioni dell'app.Here you find metrics related to the performance of your app's pages . È possibile fare clic su Aggiungi nuovo grafico per creare altre visualizzazioni personalizzate oppure selezionare Modifica per modificare tipi, altezze, tavolozza dei colori, raggruppamenti e metriche dei grafici esistenti.You can click Add new chart to create additional custom views or select Edit to modify the existing chart types, height, color palette, groupings, and metrics.

    Grafico delle metriche del server

Pulire le risorseClean up resources

Se si prevede di continuare a usare le guide introduttive o le esercitazioni successive, non eliminare le risorse create in questa guida introduttiva.If you plan to continue on to work with subsequent quickstarts or with the tutorials, do not clean up the resources created in this quick start. Se non si prevede di continuare, seguire questa procedura per eliminare tutte le risorse create da questa guida introduttiva nel portale di Azure.If you do not plan to continue, use the following steps to delete all resources created by this quick start in the Azure portal.

  1. Scegliere Gruppi di risorse dal menu a sinistra del portale di Azure e quindi fare clic su myResourceGroup.From the left-hand menu in the Azure portal, click Resource groups and then click myResourceGroup.
  2. Nella pagina del gruppo di risorse fare clic su Elimina, digitare myResourceGroup nella casella di testo e quindi fare clic su Elimina.On your resource group page, click Delete, type myResourceGroup in the text box, and then click Delete.

Passaggi successiviNext steps