Distribuire l'agente application insights di Monitoraggio di Azure per i server locali

  • Articolo

Application Insights Agent (denominato in precedenza Status Monitor V2) è un modulo di PowerShell pubblicato in 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 di ASP.NET e ASP.NET app Web Core ospitate con IIS. Usare un SDK per instrumentare le applicazioni Java e Node.js.

Application Insights Agent si trova in PowerShell Gallery.

PowerShell Gallery icon.

Istruzioni

  • Per iniziare a usare esempi di codice concisi, vedere la scheda Introduzione .
  • Per un approfondimento su come iniziare, vedere la scheda Istruzioni dettagliate .
  • Per informazioni di riferimento sull'API di 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 previsti per la maggior parte degli ambienti. Le istruzioni dipendono da PowerShell Gallery per distribuire gli aggiornamenti. Questi comandi supportano il parametro di PowerShell -Proxy .

Per una spiegazione di questi comandi, istruzioni di 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 scaricare e installare.

Prerequisiti per l'installazione

Per abilitare il monitoraggio, è necessario disporre di un stringa di connessione. Un stringa di connessione viene visualizzato nel riquadro Panoramica della risorsa di Application Insights. Per altre informazioni, vedere stringhe di Connessione ion.

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 l'agente di Application Insights

Eseguire PowerShell come amministratore.

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

Nota

L'opzione AllowPrereleaseInstall-Module nel cmdlet 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 le risposte alle domande comuni.

L'agente di Application Insights supporta le 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 -Proxy i parametri.
  • È anche possibile scaricare manualmente il modulo e installarlo nel computer o usarlo direttamente.

Ognuna di queste opzioni è descritta nelle istruzioni dettagliate.

L'agente di Application Insights supporta le applicazioni core ASP.NET?

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

Ricerca per categorie verificare che l'abilitazione sia riuscita?

  • È possibile usare il cmdlet Get-ApplicationInsightsMonitoringStatus per verificare che l'abilitazione sia riuscita.

  • Usa Metriche attive 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

Ricerca per categorie ottenere il pass-through proxy?

Per ottenere il 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 dedicato sulla risoluzione dei problemi.

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 essere inseriti 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 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 l'agente di Application Insights: