Aggiungere Azure Application Insights usando Servizi connessi di Visual Studio
Con Visual Studio è possibile connettere una delle opzioni seguenti ad Azure Application Insights usando la funzionalità Servizi connessi:
- App console .NET Framework
- ASP.NET Modello-View-Controller (MVC) (.NET Framework)
- ASP.NET Core
- .NET Core (inclusa l'app console, WPF, Windows Form, libreria di classi)
- Ruolo di lavoro .NET Core
- Funzioni di Azure
- App UWP (Universal Windows Platform)
- Xamarin
- Cordova
La funzionalità del servizio connesso aggiunge tutti i riferimenti e il codice di connessione necessari al progetto e modifica i file di configurazione in modo appropriato.
Prerequisiti
- Visual Studio con il carico di lavoro di Azure installato.
- Progetto di uno dei tipi supportati
- Un account di Azure. Se non si ha un account Azure, attivare i vantaggi di Azure per i sottoscrittori di Visual Studio o registrarsi per una prova gratuita.
Connettersi ad Azure Application Insights con Servizi connessi
Aprire il progetto in Visual Studio.
In Esplora Soluzioni, fare clic con il pulsante destro del mouse sul nodo Servizi Connessi e scegliere Aggiungi Servizi Connessidal menu di scelta rapida.
Nella scheda Servizi connessi, selezionare l'icona + per Dipendenze del Servizio .
Se non vedi il nodo Servizi Connessi, scegli Progetto>Servizi Connessi>Aggiungi.
Nella pagina Aggiungi Dipendenza, selezionare Azure Application Insights.
Se non hai già eseguito l'accesso, accedi al tuo account Azure. Se non si ha un account Azure, è possibile iscriversi per ottenere una versione di valutazione gratuita .
Nella schermata Configura azure Application Insights selezionare un componente Azure Application Insights esistente e selezionare Avanti.
Se è necessario creare un nuovo componente, andare al passaggio successivo. Altrimenti, passare al passaggio 7.
Per creare un componente di Application Insights:
Selezionare Crea un nuovo componente di Application Insights nella parte inferiore della schermata.
Compila la schermata Application Insights: Crea nuova e seleziona Crea.
Quando viene visualizzata la schermata Configura Azure Application Insights, il nuovo componente appare nell'elenco. Selezionare il nuovo componente nell'elenco e selezionare Avanti.
Immettere un nome di chiave di strumentazione o scegliere il valore predefinito e scegliere se si vuole archiviare la stringa di connessione in un file di segreti locale o in Azure Key Vault.
La schermata Riepilogo delle modifiche mostra tutte le modifiche che verranno apportate al progetto se si completa il processo. Se le modifiche sono ok, scegliere Fine.
La connessione appare nella sezione Dipendenze del Servizio della scheda Servizi Connessi.
Connettersi ad Azure Application Insights con Servizi connessi
Nota
Per i progetti .NET Framework, l'interfaccia utente di Servizi connessi è leggermente diversa. Per visualizzare le differenze, confrontare con la versione di Visual Studio 2019 di questa pagina.
Aprire il progetto in Visual Studio.
In Esplora soluzioni, fare clic con il pulsante destro del mouse sul nodo Servizi connessi e, dal menu di scelta rapida, scegliere Aggiungi per aprire il menu dei servizi disponibili.
Se il nodo Servizi Connessi non viene visualizzato, scegli Progetto>Servizi Connessi>Aggiungi.
Scegliere Azure Application Insights. Viene visualizzata la pagina Collegarsi alla dipendenza. Verranno visualizzate due opzioni, una per un emulatore locale, Application Insights Sdk (locale)e una per la connessione al servizio Azure Application Insights attivo. È possibile ridurre i costi e semplificare lo sviluppo anticipato iniziando con l'emulatore locale. È possibile eseguire la migrazione al servizio attivo in un secondo momento ripetendo questi passaggi e scegliendo l'altra opzione.
Se si sceglie di usare Application Insights SDK in locale, fare clic su Avanti per visualizzare la schermata Riepilogo delle modifiche , che mostra come viene modificato il progetto. Al progetto viene aggiunto un riferimento al pacchetto NuGet e il codice di connessione per l'emulatore locale viene aggiunto al progetto.
Se si vuole connettersi al servizio di Azure, continuare con il passaggio successivo o, se non si è già connessi, accedere all'account Azure prima di continuare. Se non si ha un account Azure, è possibile iscriversi per ottenere una versione di valutazione gratuita .
Nella schermata Configura azure Application Insights selezionare un componente Azure Application Insights esistente e selezionare Avanti.
Se è necessario creare un nuovo componente, andare al passaggio successivo. Altrimenti, vai al passaggio 7.
Per creare un componente di Application Insights:
Selezionare Crea un nuovo componente di Application Insights nella parte inferiore della schermata.
Compilare la schermata Application Insights: Crea un nuovo e selezionare Crea.
Quando viene visualizzata la schermata Configura Azure Application Insights, il nuovo componente appare nell'elenco. Selezionare il nuovo componente nell'elenco e selezionare Avanti.
Immettere un nome per l'impostazione di connessione e un nome di chiave di strumentazione oppure accettare le impostazioni predefinite.
Nota
Per una maggiore sicurezza, in Visual Studio 17.12 e versioni successive, questo passaggio crea un nome di impostazione di connessione; Le versioni precedenti creano una stringa di connessione. Le stringhe di connessione archiviate nel file system locale possono comportare un rischio per la sicurezza, se sono inavvertitamente esposte.
Fare clic su Impostazioni aggiuntivee scegliere se si vuole archiviare la stringa di connessione in un file di segreti locale o in Azure Key Vault.
La schermata Riepilogo delle modifiche mostra tutte le modifiche che verranno apportate al progetto se si completa il processo. Se le modifiche sono ok, scegliere Fine.
In Esplora Soluzioni, fare doppio clic sul nodo Servizi Connessi per aprire la scheda Servizi Connessi. La connessione viene visualizzata nella sezione Dipendenze del Servizio.
Se si fa clic sui tre puntini accanto alla dipendenza aggiunta, è possibile visualizzare varie opzioni, ad esempio Connetti per riaprire la procedura guidata e modificare la connessione. È anche possibile fare clic sui tre puntini in alto a destra della finestra per visualizzare le opzioni per avviare dipendenze locali, modificare le impostazioni e altro ancora.
Aprire il file di codice di avvio (Program.cs nei modelli) e notare che è stata aggiunta una riga simile alla seguente:
builder.Services.AddApplicationInsightsTelemetry(builder.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"]);
Passaggi successivi
Per i progetti ASP.NET Core, informazioni su come abilitare il monitoraggio per l'app in Application Insights per applicazioni ASP.NET Core.
Per i progetti ASP.NET, vedere Configurare Application Insights per il sito Web ASP.NET.
I collegamenti consentono di accedere alla sezione degli articoli dopo i passaggi iniziali di installazione, già eseguiti.