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

Application Insights-Agent (früher Statusmonitor V2) ist ein im PowerShell-Katalog veröffentlichtes PowerShell-Modul. 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 Szenarien für die automatische Instrumentierung finden Sie unter Unterstützte Umgebungen, Sprachen und Ressourcenanbieter.

Hinweis

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

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

Das Symbol „PowerShell-Katalog“

Instructions

  • 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 richten sich nach dem für Updates verwendeten PowerShell-Katalog. 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

Im April 2020 wurden TLS 1.1 und 1.0 im PowerShell-Katalog als veraltet markiert.

Informationen zu weiteren möglichen Voraussetzungen finden Sie unter PowerShell-Katalog: 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/'

Häufig gestellte Fragen

Dieser Abschnitt enthält Antworten auf häufig gestellte Fragen.

Unterstützt der Application Insights-Agent Proxy-Installationen?

Ja. Es gibt mehrere Möglichkeiten, den Application Insights-Agent herunterzuladen:

  • Wenn Ihr Computer über einen Internetzugang verfügt, können Sie ein Onboarding des PowerShell-Katalogs mithilfe der -Proxy-Parameter durchführen.
  • Sie können dieses Modul auch manuell herunterladen und es auf Ihrem Computer installieren oder direkt verwenden.

Jede dieser Optionen wird in den ausführlichen Anweisungen beschrieben.

Werden ASP.NET Core-Anwendungen in Application Insights Agent unterstützt?

Ja. Ab Application Insights-Agent 2.0.0 werden in IIS gehostete ASP.NET Core-Anwendungen unterstützt.

Wie überprüfe ich, ob die Aktivierung erfolgreich war?

  • Sie können das Cmdlet Get-ApplicationInsightsMonitoringStatus verwenden, um zu überprüfen, ob die Aktivierung erfolgreich war.
    • Verwenden Sie Livemetriken, um schnell zu ermitteln, ob Ihre App Telemetriedaten sendet.

    • Sie können auch Log Analytics verwenden, um alle Cloudrollen aufzulisten, die derzeit Telemetriedaten senden.

      union * | summarize count() by cloud_RoleName, cloud_RoleInstance
      

Erreichen von Proxy-Passthrough

Um Proxy-Passthrough zu erreichen, konfigurieren Sie einen Proxy auf Computerebene oder einen auf Anwendungsebene. Siehe DefaultProxy.

Beispieldatei „Web.config“:

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

Problembehandlung

Informationen finden Sie in dem dedizierten Artikel zur Problembehandlung.

Testen der Konnektivität zwischen Ihrem Anwendungshost und dem Erfassungsdienst

Application Insights SDKs und -Agents senden Telemetriedaten, die als REST-Aufrufe unserer Erfassungsendpunkte erfasst werden sollen. Sie können die Konnektivität Ihres Webservers oder Anwendungshostcomputers mit den Endpunkten des Erfassungsdiensts testen, indem Sie unformatierte REST-Clients über PowerShell- oder cURL-Befehle verwenden. Weitere Informationen finden Sie unter Problembehandlung bei fehlender Anwendungstelemetrie in Azure Monitor Application Insights.

Nächste Schritte

Anzeigen der Telemetrie:

Hinzufügen weiterer Telemetrieelemente:

Weitere Verwendungsmöglichkeiten für den Application Insights-Agent: