Freigeben über


Bereitstellen des Azure Monitor Application Insights-Agents für lokale Server

Application Insights Agent ist ein PowerShell-Modul, das im PowerShell-Katalog veröffentlicht wird. Es ersetzt den Statusmonitor. Telemetriedaten werden an das Azure-Portal gesendet, wo Sie Ihre App überwachen können.

Eine vollständige Liste der unterstützten Autoinstrumentationsszenarien finden Sie unter Unterstützte Umgebungen, Sprachen und Ressourcenanbieter.

Hinweis

Das Modul unterstützt derzeit codelose Instrumentierung von ASP.NET und ASP.NET Core-Web-Apps, die mit Internetinformationsserver (IIS) gehostet werden. Verwenden Sie ein SDK zum Instrumentieren von Java- und Node.js-Anwendungen.

Hinweis

Clientseitige Überwachung ist für ASP.NET Core-Apps standardmäßig aktiviert. Wenn Sie die clientseitige Überwachung deaktivieren möchten, definieren Sie mit den folgenden Informationen eine Umgebungsvariable auf dem Server:

  • Name: APPINSIGHTS_JAVASCRIPT_ENABLED
  • Wert: false

Der Application Insights-Agent ist im PowerShell-Katalog zu finden.

Das Symbol „PowerShell-Katalog“.

Anweisungen

  • Auf der Registerkarte Erste Schritte finden Sie Informationen zu den ersten Schritten mit präzisen Codebeispielen.
  • Auf der Registerkarte Ausführliche Anweisungen finden Sie detaillierte Informationen zu den ersten Schritten.
  • Eine PowerShell-API-Referenz finden Sie auf der Registerkarte API-Referenz.
  • Aktualisierungen der Versionshinweise finden Sie auf der Registerkarte Versionshinweise.

Diese Registerkarte enthält die Schnellstartbefehle, die für die meisten Umgebungen geeignet sein dürften. Die Anweisungen hängen von der PowerShell-Galerie ab, um Aktualisierungen zu verteilen. Diese Befehle unterstützen den -Proxy-Parameter von PowerShell.

Eine Erläuterung der Befehle, Anpassungsanweisungen und Informationen zur Problembehandlung finden Sie unter Ausführliche Anleitungen.

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Verwenden Sie den PowerShell-Katalog für Downloads und Installationen.

Voraussetzungen für die Installation

Sie benötigen eine Verbindungszeichenfolge, um die Überwachung zu aktivieren. Eine Verbindungszeichenfolge wird im Bereich Übersicht Ihrer Application Insights-Ressource angezeigt. Weitere Informationen finden Sie unter Verbindungszeichenfolgen.

Hinweis

Weitere Erforderliche Komponenten finden Sie unter PowerShell Gallery Transport Layer Security (TLS)-Unterstützung.

Führen Sie PowerShell als Administrator aus.

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

Schließen Sie PowerShell.

Installieren des Application Insights-Agents

Führen Sie PowerShell als Administrator aus.

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

Hinweis

Die AllowPrerelease-Option im Cmdlet Install-Module ermöglicht die Installation des Betarelease.

Weitere Informationen finden Sie unter Install-Module.

Aktivieren der Überwachung

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

Manuelles Herunterladen und Installieren (Offline-Option)

Sie können den Download und die Installation auch manuell ausführen.

Herunterladen des Moduls

Laden Sie die neueste Version des Moduls aus dem PowerShell-Katalog manuell herunter.

Entzippen und Installieren des Application Insights-Agents

$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

Aktivieren der Überwachung

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