Udostępnij za pośrednictwem

Wdrażanie agenta usługi Azure Monitor Application Insights dla serwerów lokalnych

  • Artykuł

Agent usługi Application Insights (wcześniej nazywany monitorem stanu w wersji 2) to moduł programu PowerShell opublikowany w Galeria programu PowerShell. Zastępuje monitor stanu. Dane telemetryczne są wysyłane do witryny Azure Portal, gdzie można monitorować aplikację.

Aby uzyskać pełną listę obsługiwanych scenariuszy automatycznegoinstrumentacji, zobacz Obsługiwane środowiska, języki i dostawcy zasobów.

Uwaga

Moduł obsługuje obecnie instrumentację bez kodu ASP.NET i ASP.NET Core aplikacji internetowych hostowanych za pomocą usług IIS. Używanie zestawu SDK do instrumentowania aplikacji Java i Node.js.

Agent usługi Application Insights znajduje się w Galeria programu PowerShell.

Galeria programu PowerShell ikona.

Instrukcje

  • Aby rozpocząć pracę z zwięzłymi przykładami kodu, zobacz kartę Wprowadzenie .
  • Szczegółowe informacje na temat rozpoczynania pracy można znaleźć na karcie Szczegółowe instrukcje .
  • Aby uzyskać informacje o interfejsie API programu PowerShell, zobacz kartę Dokumentacja interfejsu API.
  • Aby uzyskać informacje o wersji, zobacz kartę Informacje o wersji.

Ta karta zawiera polecenia szybkiego startu, które powinny działać w większości środowisk. Instrukcje zależą od Galeria programu PowerShell dystrybucji aktualizacji. Te polecenia obsługują parametr programu PowerShell -Proxy .

Aby uzyskać wyjaśnienie tych poleceń, instrukcji dostosowywania i informacji na temat rozwiązywania problemów, zobacz szczegółowe instrukcje.

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Użyj Galeria programu PowerShell do pobierania i instalacji.

Wymagania wstępne instalacji

Aby włączyć monitorowanie, musisz mieć parametry połączenia. W okienku Przegląd zasobu usługi Application Insights zostanie wyświetlony parametry połączenia. Aby uzyskać więcej informacji, zobacz Parametry połączenia.

Uwaga

Od kwietnia 2020 r. Galeria programu PowerShell ma przestarzałe protokoły TLS 1.1 i 1.0.

Aby uzyskać więcej wymagań wstępnych, które mogą być potrzebne, zobacz Galeria programu PowerShell obsługa protokołu TLS.

Uruchom program PowerShell jako administrator.

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

Zamknij program PowerShell.

Instalowanie agenta usługi Application Insights

Uruchom program PowerShell jako administrator.

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

Uwaga

Przełącznik AllowPrerelease w poleceniu Install-Module cmdlet umożliwia instalację wersji beta.

Aby uzyskać więcej informacji, zobacz Install-Module (Instalowanie modułu).

Włączanie monitorowania

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

Pobieranie i instalowanie ręcznie (opcja offline)

Możesz również pobrać i zainstalować ręcznie.

Pobieranie modułu

Ręcznie pobierz najnowszą wersję modułu z Galeria programu PowerShell.

Rozpakuj i zainstaluj agenta usługi Application Insights

$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

Włączanie monitorowania

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

Często zadawane pytania

Ta sekcja zawiera odpowiedzi na typowe pytania.

Czy agent usługi Application Insights obsługuje instalacje serwera proxy?

Tak. Istnieje wiele sposobów pobierania agenta usługi Application Insights:

  • Jeśli komputer ma dostęp do Internetu, możesz dołączyć do Galeria programu PowerShell przy użyciu -Proxy parametrów.
  • Możesz również ręcznie pobrać moduł i zainstalować go na komputerze lub użyć go bezpośrednio.

Każda z tych opcji jest opisana w szczegółowych instrukcjach.

Czy agent usługi Application Insights obsługuje aplikacje ASP.NET Core?

Tak. W programie Application Insights Agent 2.0.0 lub nowszym obsługiwane są aplikacje ASP.NET Core hostowane w usługach IIS.

Jak mogę sprawdzić, czy włączenie zakończyło się pomyślnie?

  • Aby sprawdzić, czy włączenie zakończyło się pomyślnie, możesz użyć polecenia cmdlet Get-ApplicationInsightsMonitoringStatus .

    • Użyj metryk na żywo, aby szybko określić, czy aplikacja wysyła dane telemetryczne.

    • Możesz również użyć usługi Log Analytics , aby wyświetlić listę wszystkich ról chmury, które obecnie wysyłają dane telemetryczne:

      union * | summarize count() by cloud_RoleName, cloud_RoleInstance

Jak mogę uzyskać przekazywanie serwera proxy?

Aby uzyskać przekazywanie serwera proxy, skonfiguruj serwer proxy na poziomie komputera lub serwer proxy na poziomie aplikacji. Zobacz DefaultProxy.

Przykład web.config:

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

Rozwiązywanie problemów

Zobacz dedykowany artykuł dotyczący rozwiązywania problemów.

Testowanie łączności między hostem aplikacji a usługą pozyskiwania

Zestawy SDK usługi Application Insights i agenci wysyłają dane telemetryczne, aby uzyskać pozyskane jako wywołania REST do naszych punktów końcowych pozyskiwania. Możesz przetestować łączność z serwera internetowego lub maszyny hosta aplikacji do punktów końcowych usługi pozyskiwania przy użyciu pierwotnych klientów REST z poziomu programu PowerShell lub poleceń curl. Zobacz Rozwiązywanie problemów z brakującą telemetrią aplikacji w usłudze Azure Monitor Application Insights.

Następne kroki

Wyświetlanie telemetrii:

Dodawanie kolejnych funkcji telemetrii:

Wykonaj więcej czynności za pomocą agenta usługi Application Insights: