Condividi tramite

Implementare Application Insights Agent di Monitoraggio di Azure per server locali

  • Articolo

Application Insights Agent (denominato in precedenza Status Monitor V2) è un modulo di PowerShell pubblicato nella PowerShell Gallery. Sostituisce Status Monitor. I dati di telemetria vengono inviati al portale di Azure, in cui è possibile monitorare l'app.

Per un elenco completo degli scenari di strumentazione automatica supportati, vedere Ambienti, lingue e provider di risorse supportati.

Nota

Il modulo supporta attualmente la strumentazione senza codice delle app Web di ASP.NET e ASP.NET Core ospitate con IIS. Usare un SDK per instrumentare applicazioni Java e Node.js.

Application Insights Agent si trova nella PowerShell Gallery.

Icona di PowerShell Gallery.

Istruzioni

  • Per iniziare con esempi di codice concisi, vedere la scheda Introduzione.
  • Per un approfondimento sulle attività iniziali, vedere la scheda Istruzioni dettagliate.
  • Per informazioni di riferimento sull'API PowerShell, vedere la scheda Informazioni di riferimento sulle API.
  • Per gli aggiornamenti delle note sulla versione, vedere la scheda Note sulla versione.

Questa scheda contiene i comandi di avvio rapido utilizzabili per la maggior parte degli ambienti. Le istruzioni dipendono da PowerShell Gallery per la distribuzione degli aggiornamenti. Questi comandi supportano il parametro -Proxy di PowerShell.

Per una spiegazione di questi comandi, istruzioni per la personalizzazione e informazioni sulla risoluzione dei problemi, vedere le istruzioni dettagliate.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

Usare PowerShell Gallery per il download e l’installazione.

Prerequisiti per l'installazione

Per abilitare il monitoraggio, è necessario disporre di una stringa di connessione. Una stringa di connessione viene visualizzata nel riquadro Informazioni generali della risorsa Application Insights. Per altre informazioni, vedere Stringhe di connessione.

Nota

A partire da aprile 2020, PowerShell Gallery ha deprecato TLS 1.1 e 1.0.

Per altri prerequisiti che potrebbero essere necessari, vedere Supporto TLS di PowerShell Gallery.

Eseguire PowerShell come amministratore.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted
Install-Module -Name PowerShellGet -Force

Chiudere PowerShell.

Installare Application Insights Agent

Eseguire PowerShell come amministratore.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-Module -Name Az.ApplicationMonitor -AllowPrerelease -AcceptLicense

Nota

L'opzione AllowPrerelease nel cmdlet Install-Module consente l'installazione della versione beta.

Per altre informazioni, vedere Install-Module.

Abilitare il monitoraggio

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

Scaricare e installare manualmente (opzione offline)

È anche possibile scaricare e installare manualmente.

Scaricare il modulo

Scaricare manualmente la versione più recente del modulo da PowerShell Gallery.

Decomprimere e installare Application Insights Agent

$pathToNupkg = "C:\Users\t\Desktop\Az.ApplicationMonitor.0.3.0-alpha.nupkg"
$pathToZip = ([io.path]::ChangeExtension($pathToNupkg, "zip"))
$pathToNupkg | rename-item -newname $pathToZip
$pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\Az.ApplicationMonitor"
Expand-Archive -LiteralPath $pathToZip -DestinationPath $pathInstalledModule

Abilitare il monitoraggio

Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

Domande frequenti

Questa sezione fornisce risposte a domande comuni.

Application Insights Agent supporta installazioni proxy?

Sì. Esistono diversi modi per scaricare Application Insights Agent:

  • Se il computer ha accesso a Internet, è possibile eseguire l'onboarding in PowerShell Gallery usando parametri -Proxy.
  • È anche possibile scaricare manualmente il modulo e installarlo nel computer o usarlo direttamente.

Ognuna di queste opzioni è descritta nelle istruzioni dettagliate.

Application Insights Agent supporta applicazioni ASP.NET Core?

Sì. In Application Insights Agent 2.0.0 e versioni successive sono supportate applicazioni ASP.NET Core ospitate in IIS.

Come controllare se l'abilitazione è riuscita?

  • È possibile usare il cmdlet Get-ApplicationInsightsMonitoringStatus per controllare se l’abilitazione è riuscita.

    • Usare Live metrics per determinare rapidamente se l'app invia dati di telemetria.

    • È anche possibile usare Log Analytics per elencare tutti i ruoli cloud che attualmente inviano dati di telemetria:

      union * | summarize count() by cloud_RoleName, cloud_RoleInstance

Come ottenere un pass-through proxy?

Per ottenere un pass-through proxy, configurare un proxy a livello di computer o un proxy a livello di applicazione. Vedere DefaultProxy.

Web.config di esempio:

<system.net>
    <defaultProxy>
    <proxy proxyaddress="http://xx.xx.xx.xx:yyyy" bypassonlocal="true"/>
    </defaultProxy>
</system.net>

Risoluzione dei problemi

Vedere l'articolo sulla risoluzione dei problemi dedicato.

Testare la connettività tra l'host dell'applicazione e il servizio di inserimento

Gli SDK e gli agenti di Application Insights inviano dati di telemetria per l’inserimento come chiamate REST agli endpoint di inserimento. È possibile testare la connettività dal server Web o dal computer host dell'applicazione agli endpoint del servizio di inserimento usando client REST non elaborati da PowerShell o comandi curl. Vedere Risolvere i problemi di dati di telemetria delle applicazioni mancanti in Application Insights di Monitoraggio di Azure.

Passaggi successivi

Visualizzare i dati di telemetria:

Aggiungere altri dati di telemetria:

Eseguire altre operazioni con Application Insights Agent: