Delen via

Azure Monitor Application Insights-agent implementeren voor on-premises servers

  • Artikel

Application Insights Agent (voorheen Status Monitor V2 genoemd) is een PowerShell-module die is gepubliceerd in de PowerShell Gallery. Status Monitor wordt vervangen. Telemetrie wordt verzonden naar Azure Portal, waar u uw app kunt bewaken .

Zie Ondersteunde omgevingen, talen en resourceproviders voor een volledige lijst met ondersteunde auto-instrumentatiescenario's.

Notitie

De module ondersteunt momenteel codeloze instrumentatie van ASP.NET en ASP.NET Core-web-apps die worden gehost met IIS. Gebruik een SDK om Java- en Node.js-toepassingen te instrumenteren.

Notitie

Bewaking aan de clientzijde is standaard ingeschakeld voor ASP.NET Core-apps. Als u bewaking aan de clientzijde wilt uitschakelen, definieert u een omgevingsvariabele op de server met de volgende informatie:

  • Naam: APPINSIGHTS_JAVASCRIPT_ENABLED
  • Waarde: false

Application Insights Agent bevindt zich in de PowerShell Gallery.

PowerShell Gallery-pictogram.

Instructies

  • Zie het tabblad Aan de slag om aan de slag te gaan met beknopte codevoorbeelden.
  • Zie het tabblad Gedetailleerde instructies voor uitgebreide informatie over hoe u aan de slag gaat.
  • Zie het tabblad API-verwijzing voor PowerShell-API.
  • Zie het tabblad Releaseopmerkingen voor updates voor releaseopmerkingen .

Dit tabblad bevat de snelstartopdrachten die naar verwachting werken voor de meeste omgevingen. De instructies zijn afhankelijk van PowerShell Gallery om updates te distribueren. Deze opdrachten ondersteunen de PowerShell-parameter -Proxy .

Zie de gedetailleerde instructies voor het oplossen van problemen voor een uitleg van deze opdrachten, aanpassingsinstructies en informatie over het oplossen van problemen.

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Gebruik PowerShell Gallery voor downloaden en installeren.

Vereisten voor de installatie

Als u bewaking wilt inschakelen, moet u een verbindingsreeks hebben. Er wordt een verbindingsreeks weergegeven in het deelvenster Overzicht van uw Application Insights-resource. Zie Verbindingsreeksen voor meer informatie.

Notitie

Vanaf april 2020 heeft PowerShell Gallery TLS 1.1 en 1.0 afgeschaft.

Zie tls-ondersteuning voor PowerShell Gallery voor meer vereisten die u mogelijk nodig hebt.

Voer PowerShell uit als beheerder.

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

Sluit PowerShell.

Application Insights-agent installeren

Voer PowerShell uit als beheerder.

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

Notitie

Met AllowPrerelease de switch in de Install-Module cmdlet kan de bètaversie worden geïnstalleerd.

Zie Install-Module voor meer informatie.

Bewaking inschakelen

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

Handmatig downloaden en installeren (offlineoptie)

U kunt ook handmatig downloaden en installeren.

De module downloaden

Download handmatig de nieuwste versie van de module vanuit PowerShell Gallery.

Application Insights-agent uitpakken en installeren

$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

Bewaking inschakelen

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

Veelgestelde vragen

In deze sectie vindt u antwoorden op veelgestelde vragen.

Biedt Application Insights Agent ondersteuning voor proxy-installaties?

Ja. Er zijn meerdere manieren om Application Insights Agent te downloaden:

  • Als uw computer internettoegang heeft, kunt u onboarden naar de PowerShell Gallery met behulp van -Proxy parameters.
  • U kunt de module ook handmatig downloaden en installeren op uw computer of rechtstreeks gebruiken.

Elk van deze opties wordt beschreven in de gedetailleerde instructies.

Biedt Application Insights Agent ondersteuning voor ASP.NET Core-toepassingen?

Ja. In Application Insights Agent 2.0.0 en hoger worden ASP.NET Core-toepassingen die worden gehost in IIS, ondersteund.

Hoe kan ik controleren of het inschakelen is geslaagd?

Hoe kan ik proxypassthrough bereiken?

Als u proxypassthrough wilt bereiken, configureert u een proxy op computerniveau of een proxy op toepassingsniveau. Zie DefaultProxy.

Voorbeeld van Web.config:

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

Probleemoplossing

Zie het speciale artikel over probleemoplossing.

Connectiviteit testen tussen uw toepassingshost en de opnameservice

Application Insights SDK's en agents verzenden telemetrie om opgenomen te worden als REST-aanroepen naar onze opname-eindpunten. U kunt de connectiviteit vanaf uw webserver of toepassingshostcomputer testen op de service-eindpunten voor opname met behulp van onbewerkte REST-clients uit PowerShell- of curl-opdrachten. Zie Problemen met ontbrekende toepassingstelemetrie oplossen in Azure Monitor Application Insights.

Volgende stappen

Uw telemetrie weergeven:

Meer telemetrie toevoegen:

Doe meer met De Application Insights-agent: