Distribuera Azure Monitor Application Insights-agenten för lokala servrar

  • Artikel

Application Insights Agent (tidigare statusövervakaren V2) är en PowerShell-modul som publicerats till PowerShell-galleriet. Den ersätter Statusövervakaren. Telemetri skickas till Azure-portalen, där du kan övervaka din app.

En fullständig lista över scenarier med automatisk instrumentering som stöds finns i Miljöer, språk och resursprovidrar som stöds.

Kommentar

Modulen stöder för närvarande kodlös instrumentering av ASP.NET och ASP.NET Core-webbappar som hanteras med IIS. Använd en SDK för att instrumentera Java- och Node.js-program.

Application Insights Agent finns i PowerShell-galleriet.

PowerShell Gallery icon.

Instruktioner

  • Information om hur du kommer igång med koncisa kodexempel finns på fliken Komma igång .
  • En djupdykning om hur du kommer igång finns på fliken Detaljerade instruktioner .
  • PowerShell API-referens finns på fliken API-referens.
  • Information om uppdateringar av viktig information finns på fliken Viktig information .

Den här fliken innehåller de snabbstartskommandon som förväntas fungera för de flesta miljöer. Instruktionerna beror på PowerShell-galleriet för att distribuera uppdateringar. Dessa kommandon stöder PowerShell-parametern -Proxy .

En förklaring av dessa kommandon, anpassningsinstruktioner och information om felsökning finns i de detaljerade instruktionerna.

Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

Använd PowerShell-galleriet för nedladdning och installation.

Krav för installation

Om du vill aktivera övervakning måste du ha en anslutningssträng. En anslutningssträng visas i fönstret Översikt för din Application Insights-resurs. Mer information finns i Anslut ionssträngar.

Kommentar

Från och med april 2020 har PowerShell-galleriet föråldrat TLS 1.1 och 1.0.

Fler krav som du kan behöva finns i PowerShell-galleriet TLS-stöd.

Kör PowerShell som administratör.

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

Stäng PowerShell.

Installera Application Insights-agenten

Kör PowerShell som administratör.

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

Kommentar

Växeln AllowPrerelease i cmdleten Install-Module tillåter installation av betaversionen.

Mer information finns i Installera modul.

Aktivera övervakning

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

Ladda ned och installera manuellt (offlinealternativ)

Du kan också ladda ned och installera manuellt.

Ladda ned modulen

Ladda ned den senaste versionen av modulen manuellt från PowerShell-galleriet.

Packa upp och installera Application Insights-agenten

$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

Aktivera övervakning

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

Vanliga frågor och svar

Det här avsnittet innehåller svar på vanliga frågor.

Stöder Application Insights Agent proxyinstallationer?

Ja. Det finns flera sätt att ladda ned Application Insights Agent:

  • Om datorn har internetåtkomst kan du registrera dig för PowerShell-galleriet med hjälp -Proxy av parametrar.
  • Du kan också ladda ned modulen manuellt och antingen installera den på datorn eller använda den direkt.

Vart och ett av dessa alternativ beskrivs i de detaljerade anvisningarna.

Stöder Application Insights Agent ASP.NET Core-program?

Ja. I Application Insights Agent 2.0.0 och senare stöds ASP.NET Core-program som finns i IIS.

Hur gör jag för att kontrollera att aktiveringen lyckades?

  • Du kan använda cmdleten Get-ApplicationInsightsMonitoringStatus för att kontrollera att aktiveringen lyckades.

  • Använd Live Metrics för att snabbt avgöra om din app skickar telemetri.

  • Du kan också använda Log Analytics för att lista alla molnroller som för närvarande skickar telemetri:

    union * | summarize count() by cloud_RoleName, cloud_RoleInstance

Hur gör jag för att uppnå proxy genomströmning?

För att uppnå proxygenomströmning konfigurerar du en proxy på datornivå eller en proxy på programnivå. Se DefaultProxy.

Exempel på Web.config:

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

Felsökning

Se den dedikerade felsökningsartikeln.

Testa anslutningen mellan programvärden och inmatningstjänsten

Application Insights SDK:er och agenter skickar telemetri för att matas in som REST-anrop till våra inmatningsslutpunkter. Du kan testa anslutningen från webbservern eller programvärddatorn till slutpunkterna för inmatningstjänsten med hjälp av råa REST-klienter från PowerShell- eller curl-kommandon. Se Felsöka programtelemetri som saknas i Azure Monitor Application Insights.

Nästa steg

Visa telemetrin:

Lägg till mer telemetri:

Gör mer med Application Insights-agenten:

  • Felsöka Application Insights-agenten.