Wdrażanie agenta Szczegółowe informacje aplikacji usługi Azure Monitor dla serwerów lokalnych

  • Artykuł

Agent Szczegółowe informacje aplikacji (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. Instrumentacja aplikacji Java i Node.js przy użyciu zestawu SDK.

Agent Szczegółowe informacje aplikacji znajduje się w Galeria programu PowerShell.

PowerShell Gallery icon.

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 application Szczegółowe informacje zostanie wyświetlony parametry połączenia. Aby uzyskać więcej informacji, zobacz ciągi Połączenie ion.

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 Szczegółowe informacje aplikacji

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 Szczegółowe informacje aplikacji

$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 Szczegółowe informacje aplikacji obsługuje instalacje serwera proxy?

Tak. Istnieje wiele sposobów pobierania agenta Szczegółowe informacje aplikacji:

  • 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 Szczegółowe informacje obsługuje aplikacje ASP.NET Core?

Tak. W programie Application Szczegółowe informacje 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?

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 Szczegółowe informacje aplikacji 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 Szczegółowe informacje.

Następne kroki

Wyświetlanie telemetrii:

Dodawanie kolejnych funkcji telemetrii:

Wykonaj więcej czynności za pomocą agenta Szczegółowe informacje aplikacji: