Configurare manualmente Application Insights per applicazioni .NETManually configure Application Insights for .NET applications

È possibile configurare Application Insights per monitorare un'ampia gamma di applicazioni o componenti, microservizi o ruoli applicazione.You can configure Application Insights to monitor a wide variety of applications or application roles, components, or microservices. Per i servizi e le app Web, Visual Studio offre una configurazione in un solo passaggio.For web apps and services, Visual Studio offers one-step configuration. Per altri tipi di applicazione .NET, come ruoli server back-end o applicazioni desktop, è possibile configurare Application Insights manualmente.For other types of .NET application, such as backend server roles or desktop applications, you can configure Application Insights manually.

Grafici di monitoraggio delle prestazioni di esempio

Prima di iniziareBefore you start

È necessario:You need:

  • 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, using your Microsoft account.
  • Visual Studio 2013 o versione successiva.Visual Studio 2013 or later.

1. Scegliere una risorsa di Application Insights1. Choose an Application Insights resource

La "risorsa" è la posizione in cui verranno raccolti e visualizzati i dati nel portale di Azure.The 'resource' is where your data is collected and displayed in the Azure portal. È necessario decidere se crearne una nuova oppure condividerne una esistente.You need to decide whether to create a new one, or share an existing one.

Parte di un'app più grande: usare una risorsa esistentePart of a larger app: Use existing resource

Se l'applicazione Web include diversi componenti, ad esempio un'app Web front-end e uno o più servizi back-end, è consigliabile inviare i dati di telemetria di tutti i componenti alla stessa risorsa.If your web application has several components - for example, a front-end web app and one or more back-end services - then you should send telemetry from all the components to the same resource. In questo modo potranno essere visualizzati in una singola mappa delle applicazioni e sarà possibile tracciare una richiesta da un componente a un altro.This will enable them to be displayed on a single Application Map, and make it possible to trace a request from one component to another.

Se vengono già monitorati altri componenti dell'app, usare quindi la stessa risorsa.So, if you're already monitoring other components of this app, then just use the same resource.

Aprire la risorsa nel portale di Azure.Open the resource in the Azure portal.

App completa: creare una nuova risorsaSelf-contained app: Create a new resource

Se la nuova app non è correlata ad altre applicazioni, dovrà avere una propria risorsa.If the new app is unrelated to other applications, then it should have its own resource.

Accedere al portale di Azuree creare una nuova risorsa di Application Insights.Sign in to the Azure portal, and create a new Application Insights resource. Scegliere ASP.NET come tipo di applicazione.Choose ASP.NET as the application type.

Fare clic su Nuovo, Application Insights

La scelta del tipo di applicazione determina l'impostazione del contenuto predefinito dei pannelli della risorsa.The choice of application type sets the default content of the resource blades.

2. Eseguire una copia della chiave di strumentazione2. Copy the Instrumentation Key

La chiave identifica la risorsaThe key identifies the resource. e verrà installata nell'SDK per indirizzare i dati alla risorsa.You'll install it soon in the SDK, in order to direct data to the resource.

Fare clic su Proprietà, selezionare il tasto e premere CTRL+C

3. Installare il pacchetto Application Insights nell'applicazione3. Install the Application Insights package in your application

L'installazione e la configurazione del pacchetto Application Insights variano a seconda della piattaforma in cui si lavora.Installing and configuring the Application Insights package varies depending on the platform you're working on.

  1. In Visual Studio fare clic con il pulsante destro del mouse sul progetto e scegliere Gestisci pacchetti NuGet.In Visual Studio, right-click your project and choose Manage Nuget Packages.

    Fare clic con il pulsante destro del mouse sul progetto e selezionare Gestisci pacchetti NuGet

  2. Installare il pacchetto Application Insights per le app di Windows Server, "Microsoft.ApplicationInsights.WindowsServer".Install the Application Insights package for Windows server apps, "Microsoft.ApplicationInsights.WindowsServer."

    Cercare "Application Insights"

    Quale versione?Which version?

    Per provare le funzionalità più recenti, selezionare Includi versione preliminare.Check Include prerelease if you want to try our latest features. I documenti o i blog pertinenti indicano se è necessaria una versione preliminare.The relevant documents or blogs note whether you need a prerelease version.

    È possibile usare altri pacchetti?Can I use other packages?

    Sì.Yes. Se si vuole solo usare l'API per inviare i propri dati di telemetria, scegliere "Microsoft.ApplicationInsights".Choose "Microsoft.ApplicationInsights" if you only want to use the API to send your own telemetry. Il pacchetto per Windows Server include l'API e diversi altri pacchetti, ad esempio la raccolta dei contatori delle prestazioni e il monitoraggio delle dipendenze.The Windows Server package includes the API plus a number of other packages such as performance counter collection and dependency monitoring.

Per eseguire l'aggiornamento a future versioni del pacchettoTo upgrade to future package versions

Si rilascerà una nuova versione del SDK di tanto in tanto.We release a new version of the SDK from time to time.

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

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

4. Inviare dati di telemetria4. Send telemetry

Se è stato installato solo il pacchetto dell'API:If you installed only the API package:

Se sono installati altri pacchetti di Application Insights è possibile, se si preferisce, usare il file config per impostare la chiave di strumentazione:If you installed other Application Insights packages, you can, if you prefer, use the .config file to set the instrumentation key:

  • Modificare ApplicationInsights.config (che è stato aggiunto dall'installazione di NuGet).Edit ApplicationInsights.config (which was added by the NuGet install). Inserire questo comando immediatamente prima del tag di chiusura:Insert this just before the closing tag:

    <InstrumentationKey> chiave di strumentazione copiata </InstrumentationKey><InstrumentationKey> the instrumentation key you copied </InstrumentationKey>

  • Verificare che le proprietà di ApplicationInsights.config in Esplora soluzioni siano impostate su = Contenuto, Copia nella directory di output = Copia.Make sure that the properties of ApplicationInsights.config in Solution Explorer are set to Build Action = Content, Copy to Output Directory = Copy.

È utile impostare la chiave di strumentazione nel codice se si vuole cambiare la chiave per configurazioni della build diverse.It's useful to set the instrumentation key in code if you want to switch the key for different build configurations. Se si imposta la chiave nel codice, non è necessario impostarla nel file .config.If you set the key in code, you don't have to set it in the .config file.

Eseguire il progettoRun your project

Eseguire l'applicazione premendo F5 e provarla aprendo pagine diverse per generare alcuni dati di telemetria.Use the F5 to run your application and try it out: open different pages to generate some telemetry.

In Visual Studio verrà visualizzato il conteggio degli eventi che sono stati inviati.In Visual Studio, you'll see a count of the events that have been sent.

Conteggio degli eventi in Visual Studio

Visualizzare i dati di telemetriaView your telemetry

Tornare al portale di Azure e passare alla risorsa Application Insights.Return to the Azure portal and browse to your Application Insights resource.

Cercare i dati nei grafici Panoramica.Look for data in the Overview charts. All'inizio si vedranno solo uno o due punti.At first, you'll just see one or two points. Ad esempio:For example:

Fare clic per visualizzare altri dati.

Fare clic su qualsiasi grafico per visualizzare metriche più dettagliate.Click through any chart to see more detailed metrics. Altre informazioni sulle metriche.Learn more about metrics.

Dati non visualizzatiNo data?

  • Usare l'applicazione, aprendo pagine diverse in modo da generare alcuni dati di telemetria.Use the application, opening different pages so that it generates some telemetry.
  • Aprire il riquadro Ricerca per visualizzare i singoli eventi.Open the Search tile, to see individual events. Talvolta agli eventi ci vuole un po' più di tempo per passare attraverso la pipeline delle metriche.Sometimes it takes events a little while longer to get through the metrics pipeline.
  • Attendere alcuni secondi e fare clic su Aggiorna.Wait a few seconds and click Refresh. I grafici si aggiornano periodicamente, ma è possibile aggiornare manualmente se si è in attesa di alcuni dati da visualizzare.Charts refresh themselves periodically, but you can refresh manually if you're waiting for some data to show up.
  • Vedere Domande su Application Insights per ASP.NET.See Troubleshooting.

Pubblicare l'appPublish your app

Distribuire ora l'applicazione nel server o in Azure e osservare l'accumulo dei dati.Now deploy your application to your server or to Azure and watch the data accumulate.

Utilizzare Visual Studio per pubblicare l'app

Quando si esegue la modalità debug, la telemetria viene velocizzata nella pipeline, quindi i dati vengono visualizzati in pochi secondi.When you run in debug mode, telemetry is expedited through the pipeline, so that you should see data appearing within seconds. Quando si distribuisce l'applicazione nella configurazione Release, i dati si accumulano più lentamente.When you deploy your app in Release configuration, data accumulates more slowly.

Nessun dato dopo la pubblicazione nel server?No data after you publish to your server?

Aprire le porte per il traffico in uscita nel firewall del server.Open ports for outgoing traffic in your server's firewall. Per l'elenco degli indirizzi necessari, vedere questa pagina.See this page for the list of required addresses

Problemi del server di compilazioneTrouble on your build server?

Vedere questa sezione sulla risoluzione dei problemi.Please see this Troubleshooting item.

Nota

Se l’app genera molti dati di telemetria, il modulo di campionamento adattivo riduce automaticamente il volume che viene inviato al portale inviando solo una frazione rappresentativa di eventi.If your app generates a lot of telemetry, the adaptive sampling module will automatically reduce the volume that is sent to the portal by sending only a representative fraction of events. Tuttavia, gli eventi che fanno parte della stessa richiesta verranno selezionati o deselezionati come gruppo, per rendere possibile lo spostamento tra eventi correlati.However, events that are related to the same request will be selected or deselected as a group, so that you can navigate between related events. Informazioni sul campionamento.Learn about sampling.

VideoVideo

Passaggi successiviNext steps