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

Agent usługi Application Insights to moduł programu PowerShell opublikowany w galerii 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 automatycznej instrumentacji, zobacz Obsługiwane środowiska, języki i dostawcy zasobów.

Uwaga

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

Uwaga

Monitorowanie po stronie klienta jest domyślnie włączone dla aplikacji ASP.NET Core. Jeśli chcesz wyłączyć monitorowanie po stronie klienta, zdefiniuj zmienną środowiskową na serwerze przy użyciu następujących informacji:

• Nazwa:APPINSIGHTS_JAVASCRIPT_ENABLED
• Wartość:false

Galeria programu PowerShell

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

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 .
• Zaktualizowane uwagi do wydania znajdziesz na karcie Uwagi do wydania.

Wprowadzenie

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 .

Pobieranie i instalowanie za pośrednictwem Galeria programu PowerShell

Użyj Galeria programu PowerShell do pobierania i instalacji.

Wymagania wstępne instalacji

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

Uwaga

Aby uzyskać więcej wymagań wstępnych, które mogą być potrzebne, zobacz Obsługa zabezpieczeń warstwy transportowej (TLS) w galerii programu PowerShell.

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 galerii 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/'

Szczegółowe instrukcje

Na tej karcie opisano sposób dołączania do Galeria programu PowerShell i pobierania modułu ApplicationMonitor. Uwzględnione są najbardziej typowe parametry, które należy rozpocząć. Udostępniamy również instrukcje ręcznego pobierania, jeśli nie masz dostępu do Internetu.

Pobieranie parametry połączenia

Aby rozpocząć, potrzebujesz parametry połączenia. Aby uzyskać więcej informacji, zobacz Parametry połączenia.

Uwaga

31 marca 2025 r. zostanie zakończone świadczenie pomocy technicznej dla pozyskiwania klucza instrumentacji. Pozyskiwanie klucza instrumentacji będzie nadal działać, ale nie udostępnimy już aktualizacji ani obsługi funkcji. Przejście do parametrów połączenia w celu skorzystania z nowych możliwości.

Uruchamianie programu PowerShell jako administrator z zasadami wykonywania z podwyższonym poziomem uprawnień

Uruchom jako administrator

Program PowerShell wymaga uprawnień na poziomie administratora, aby wprowadzić zmiany na komputerze.

Zasady wykonywania

• Opis: Domyślnie uruchamianie skryptów programu PowerShell jest wyłączone. Zalecamy zezwolenie na używanie skryptów RemoteSigned tylko dla bieżącego zakresu.
• Dokumentacja: Informacje o zasadach wykonywania i set-executionPolicy.
• Polecenie: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process.
• Opcjonalny parametr:
  • -Force. Pomija monit o potwierdzenie.

Przykładowe błędy

Install-Module : The 'Install-Module' command was found in the module 'PowerShellGet', but the module could not be
loaded. For more information, run 'Import-Module PowerShellGet'.

Import-Module : File C:\Program Files\WindowsPowerShell\Modules\PackageManagement\1.3.1\PackageManagement.psm1 cannot
be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https://go.microsoft.com/fwlink/?LinkID=135170.

Wymagania wstępne dla PowerShell

Przeprowadź inspekcję $PSVersionTable wystąpienia programu PowerShell, uruchamiając polecenie . To polecenie generuje następujące dane wyjściowe:

Name                           Value
----                           -----
PSVersion                      5.1.17763.316
PSEdition                      Desktop
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}
BuildVersion                   10.0.17763.316
CLRVersion                     4.0.30319.42000
WSManStackVersion              3.0
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1

Te instrukcje zostały napisane i przetestowane na komputerze z systemem Windows 10 i następującymi wersjami.

Wymagania wstępne dotyczące Galeria programu PowerShell

Te kroki umożliwiają przygotowanie serwera do pobrania modułów z Galeria programu PowerShell.

Uwaga

Galeria programu PowerShell jest obsługiwana w systemach Windows 10, Windows Server 2016 i PowerShell 6+. Aby uzyskać informacje o wcześniejszych wersjach, zobacz Instalowanie modułu PowerShellGet.

1. Uruchom program PowerShell jako administrator z zasadami wykonywania z podwyższonym poziomem uprawnień.

2. Zainstaluj dostawcę pakietów NuGet.

   • Opis: Ten dostawca jest potrzebny do interakcji z repozytoriami opartymi na nuGet, takimi jak Galeria programu PowerShell.
   • Dokumentacja: Install-PackageProvider.
   • Polecenie: Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201.
   • Parametry opcjonalne:
     • -Proxy. Określa serwer proxy dla żądania.
     • -Force. Pomija monit o potwierdzenie.

   Zostanie wyświetlony ten monit, jeśli pakiet NuGet nie został skonfigurowany:

   NuGet provider is required to continue
   PowerShellGet requires NuGet provider version '2.8.5.201' or newer to interact with NuGet-based repositories.
   The NuGet provider must be available in 'C:\Program Files\PackageManagement\ProviderAssemblies' or
   'C:\Users\t\AppData\Local\PackageManagement\ProviderAssemblies'. You can also install the NuGet provider by running
   'Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force'. Do you want PowerShellGet to install and import
   the NuGet provider now?
   [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"):
   

3. Skonfiguruj Galeria programu PowerShell jako zaufane repozytorium.

   • Opis: domyślnie Galeria programu PowerShell jest niezaufanym repozytorium.
   • Dokumentacja: Set-PSRepository.
   • Polecenie: Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted.
   • Opcjonalny parametr:
     • -Proxy. Określa serwer proxy dla żądania.

   Zostanie wyświetlony ten monit, jeśli Galeria programu PowerShell nie jest zaufany:

   Untrusted repository
   You are installing the modules from an untrusted repository.
   If you trust this repository, change its InstallationPolicy value
   by running the Set-PSRepository cmdlet. Are you sure you want to
   install the modules from 'PSGallery'?
   [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):
   

   Tę zmianę i przeprowadź inspekcję PSRepositoriesGet-PSRepository , uruchamiając polecenie .

4. Zainstaluj najnowszą wersję modułu PowerShellGet.

   • Opis: Ten moduł zawiera narzędzia używane do pobierania innych modułów z Galeria programu PowerShell. Wersja 1.0.0.1 jest dostarczana z systemami Windows 10 i Windows Server. Wymagana jest wersja 1.6.0 lub nowsza. Aby określić, która wersja jest zainstalowana, uruchom Get-Command -Module PowerShellGet polecenie .
   • Dokumentacja: Instalowanie modułu PowerShellGet.
   • Polecenie: Install-Module -Name PowerShellGet.
   • Parametry opcjonalne:
     • -Proxy. Określa serwer proxy dla żądania.
     • -Force. Pomija ostrzeżenie "już zainstalowane" i instaluje najnowszą wersję.

   Ten błąd występuje, jeśli nie używasz najnowszej wersji modułu PowerShellGet:

   Install-Module : A parameter cannot be found that matches parameter name 'AllowPrerelease'.
   At line:1 char:20
   Install-Module abc -AllowPrerelease
                  ~~~~~~~~~~~~~~~~
   CategoryInfo          : InvalidArgument: (:) [Install-Module], ParameterBindingException
   FullyQualifiedErrorId : NamedParameterNotFound,Install-Module
   

5. Uruchom ponownie program PowerShell. Nie można załadować nowej wersji w bieżącej sesji. Nowe sesje programu PowerShell ładują najnowszą wersję modułu PowerShellGet.

Pobieranie i instalowanie modułu za pośrednictwem Galeria programu PowerShell

Te kroki umożliwiają pobranie modułu Az.ApplicationMonitor z Galeria programu PowerShell.

1. Upewnij się, że zostały spełnione wszystkie wymagania wstępne dotyczące Galeria programu PowerShell.
2. Uruchom program PowerShell jako administrator z zasadami wykonywania z podwyższonym poziomem uprawnień.
3. Zainstaluj moduł Az.ApplicationMonitor.
   • Dokumentacja: Install-Module.
   • Polecenie: Install-Module -Name Az.ApplicationMonitor.
   • Parametry opcjonalne:
     • -Proxy. Określa serwer proxy dla żądania.
     • -AllowPrerelease. Umożliwia instalację wersji alfa i beta.
     • -AcceptLicense. Pomija monit "Zaakceptuj licencję"
     • -Force. Pomija ostrzeżenie "Niezaufane repozytorium".

Pobieranie i instalowanie modułu ręcznie (opcja offline)

Jeśli z jakiegokolwiek powodu nie możesz nawiązać połączenia z modułem programu PowerShell, możesz ręcznie pobrać i zainstalować moduł Az.ApplicationMonitor.

Ręczne pobieranie najnowszego pliku nupkg

1. Przejdź do https://www.powershellgallery.com/packages/Az.ApplicationMonitor.
2. Wybierz najnowszą wersję pliku w tabeli Historia wersji .
3. W obszarze Opcje instalacji wybierz pozycję Pobieranie ręczne.

Opcja 1. Instalowanie w katalogu modułów programu PowerShell

Zainstaluj ręcznie pobrany moduł programu PowerShell w katalogu programu PowerShell, aby można go było odnaleźć za pomocą sesji programu PowerShell. Aby uzyskać więcej informacji, zobacz Instalowanie modułu programu PowerShell.

Rozpakuj plik nupkg jako plik zip przy użyciu polecenia Expand-Archive (wersja 1.0.1.0)

• Opis: Podstawowa wersja pliku Microsoft.PowerShell.Archive (wersja 1.0.1.0) nie może rozpakować plików nupkg. Zmień nazwę pliku na rozszerzenie .zip.

• Dokumentacja: Rozwiń archiwum.

• Polecenie:

  $pathToNupkg = "C:\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
  

Rozpakuj nupkg przy użyciu polecenia Expand-Archive (wersja 1.1.0.0)

• Opis: Użyj bieżącej wersji rozszerzenia Expand-Archive, aby rozpakować pliki nupkg bez zmiany rozszerzenia.

• Dokumentacja: Expand-Archive i Microsoft.PowerShell.Archive.

• Polecenie:

  $pathToNupkg = "C:\az.applicationmonitor.0.2.1-alpha.nupkg"
  $pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\az.applicationmonitor"
  Expand-Archive -LiteralPath $pathToNupkg -DestinationPath $pathInstalledModule
  

Opcja 2. Rozpakuj i zaimportuj nupkg ręcznie

Zainstaluj ręcznie pobrany moduł programu PowerShell w katalogu programu PowerShell, aby można go było odnaleźć za pomocą sesji programu PowerShell. Aby uzyskać więcej informacji, zobacz Instalowanie modułu programu PowerShell.

Jeśli instalujesz moduł w innym katalogu, ręcznie zaimportuj moduł przy użyciu polecenia Import-Module.

Ważne

Biblioteki dynamicznych łączy (DLL) instalują się poprzez ścieżki względne. Zapisz zawartość pakietu w zamierzonym katalogu środowiska uruchomieniowego i upewnij się, że uprawnienia dostępu zezwalają na odczyt, ale nie zapis.

1. Zmień rozszerzenie na ".zip" i wyodrębnij zawartość pakietu do zamierzonego katalogu instalacyjnego.
2. Znajdź ścieżkę pliku Az.ApplicationMonitor.psd1.
3. Uruchom program PowerShell jako administrator z zasadami wykonywania z podwyższonym poziomem uprawnień.
4. Załaduj moduł przy użyciu Import-Module Az.ApplicationMonitor.psd1 polecenia .

Kierowanie ruchu przez serwer proxy

Podczas monitorowania komputera w prywatnym intranecie należy kierować ruch HTTP przez serwer proxy.

Polecenia programu PowerShell służące do pobierania i instalowania polecenia Az.ApplicationMonitor z Galeria programu PowerShell obsługują -Proxy parametr . Zapoznaj się z poprzednimi instrukcjami podczas pisania skryptów instalacji.

Zestaw SDK usługi Application Insights musi wysyłać dane telemetryczne aplikacji do firmy Microsoft. Zalecamy skonfigurowanie ustawień serwera proxy dla aplikacji w pliku web.config. Aby uzyskać więcej informacji, zobacz Jak mogę osiągnąć przejście przez serwer proxy?.

Włączanie monitorowania

Użyj polecenia , Enable-ApplicationInsightsMonitoring aby włączyć monitorowanie.

Zobacz dokumentację interfejsu API, aby uzyskać szczegółowy opis użycia tego cmdlet.

Dokumentacja interfejsu API

Na tej karcie opisano następujące polecenia cmdlet, które są elementami członkowskimi modułu Az.ApplicationMonitor programu PowerShell:

• Włącz InstrumentationEngine
• Enable-ApplicationInsightsMonitoring (Włącz monitorowanie Application Insights)
• Wyłącz InstrumentationEngine
• Disable-ApplicationInsightsMonitoring (wyłączanie monitorowania Application Insights)
• Get-ApplicationInsightsMonitoringConfig
• Get-ApplicationInsightsMonitoringStatus
• Set-ApplicationInsightsMonitoringConfig (Konfiguracja monitorowania Application Insights)
• Start-ApplicationInsightsMonitoringTrace

Uwaga

• Aby rozpocząć, potrzebujesz parametry połączenia. Aby uzyskać więcej informacji, zobacz Tworzenie zasobu.
• To polecenie cmdlet wymaga przejrzenia i zaakceptowania naszej licencji i zasad zachowania poufności informacji.

Uwaga

31 marca 2025 r. zostanie zakończone świadczenie pomocy technicznej dla pozyskiwania klucza instrumentacji. Pozyskiwanie klucza instrumentacji będzie nadal działać, ale nie udostępnimy już aktualizacji ani obsługi funkcji. Przejście do parametrów połączenia w celu skorzystania z nowych możliwości.

Ważne

To polecenie cmdlet wymaga sesji programu PowerShell z uprawnieniami administratora i zasadami wykonywania z podwyższonym poziomem uprawnień. Aby uzyskać więcej informacji, zobacz Uruchamianie programu PowerShell jako administrator przy użyciu zasad wykonywania z podwyższonym poziomem uprawnień.

• To polecenie cmdlet wymaga przejrzenia i zaakceptowania naszej licencji i zasad zachowania poufności informacji.
• Silnik instrumentacji zwiększa obciążenie i jest domyślnie wyłączony.

Enable-InstrumentationEngine

Włącza aparat instrumentacji, ustawiając niektóre klucze rejestru. Uruchom ponownie usługi IIS, aby zmiany zaczęły obowiązywać.

Aparat instrumentacji może uzupełniać dane zebrane przez zestawy SDK (Software Development Kit) platformy .NET. Zbiera zdarzenia i komunikaty opisujące wykonywanie zarządzanego procesu. Te zdarzenia i komunikaty obejmują kody wyników zależności, czasowniki HTTP i tekst polecenia SQL.

Włącz aparat instrumentacji, jeśli:

• Włączono już monitorowanie za Enable pomocą polecenia cmdlet , ale nie włączono aparatu instrumentacji.
• Aplikacja została ręcznie instrumentowana przy użyciu zestawów SDK platformy .NET i chcesz zebrać dodatkowe dane telemetryczne.

Przykłady

Enable-InstrumentationEngine

Parametry

-AkceptujLicencję

Opcjonalny. Użyj tego przełącznika, aby zaakceptować licencję i zasady zachowania poufności informacji w instalacjach bez głowy.

-Gadatliwy

Wspólny parametr. Użyj tego przełącznika, aby wyświetlić szczegółowe dzienniki.

Wyjście

Przykładowe dane wyjściowe z pomyślnego włączenia aparatu instrumentacji

Configuring IIS Environment for instrumentation engine...
Configuring registry for instrumentation engine...

Enable-ApplicationInsightsMonitoring

Umożliwia bez kodowe monitorowanie aplikacji usług IIS na komputerze docelowym.

To polecenie cmdlet modyfikuje plik applicationHost.config usług IIS i ustawia niektóre klucze rejestru. Tworzy on plik applicationinsights.ikey.config, który definiuje klucz instrumentacji używany przez każdą aplikację. Usługi IIS ładują moduł RedfieldModule podczas uruchamiania, który wprowadza zestaw SDK usługi Application Insights do aplikacji podczas uruchamiania aplikacji. Uruchom ponownie usługi IIS, aby zmiany zaczęły obowiązywać.

Po włączeniu monitorowania zalecamy używanie metryk na żywo , aby szybko sprawdzić, czy aplikacja wysyła nam dane telemetryczne.

Przykłady

Przykład z pojedynczym parametry połączenia

W tym przykładzie wszystkie aplikacje na bieżącym komputerze są dostarczane z pojedynczym ciągiem połączenia.

Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

Przykład z pojedynczym kluczem instrumentacji

W tym przykładzie aplikacje na bieżącym komputerze są dostarczane z jednym kluczem do instrumentacji.

Enable-ApplicationInsightsMonitoring -InstrumentationKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Przykład z mapą klucza instrumentacji

W tym przykładzie:

• MachineFilter pasuje do bieżącego komputera przy użyciu symbolu wieloznakowego '.*' .
• AppFilter='WebAppExclude' null zapewnia klucz instrumentacji. Określona aplikacja nie jest instrumentowana.
• AppFilter='WebAppOne' przypisuje określonej aplikacji unikatowy klucz instrumentacji.
• AppFilter='WebAppTwo' przypisuje określonej aplikacji unikatowy klucz instrumentacji.
• AppFilter używa symbolu wieloznakowego '.*' , aby dopasować wszystkie aplikacje internetowe, których jeszcze nie pasuje, i przypisuje domyślny klucz instrumentacji.
• Miejsca są dodawane w celu zapewnienia czytelności.

Enable-ApplicationInsightsMonitoring -InstrumentationKeyMap `
    ` @(@{MachineFilter='.*';AppFilter='WebAppExclude'},
        ` @{MachineFilter='.*';AppFilter='WebAppOne';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx1'}},
        ` @{MachineFilter='.*';AppFilter='WebAppTwo';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx2'}},
        ` @{MachineFilter='.*';AppFilter='.*';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxdefault'}})

• MachineFilter to wymagany rejestr języka C# nazwy komputera lub maszyny wirtualnej.
  • '.*' pasuje do wszystkich
  • Wartość "ComputerName" odpowiada tylko komputerom o określonej nazwie.
• AppFilter jest wymaganym wyrażeniem regularnym C# dla nazwy witryny IIS. Listę witryn na serwerze można uzyskać, uruchamiając polecenie get-iissite.
  • '.*' pasuje do wszystkich
  • Element "SiteName" odpowiada tylko witrynie usług IIS z określoną dokładną nazwą.
• Klucz instrumentacji jest wymagany do włączenia monitorowania aplikacji pasujących do poprzednich dwóch filtrów.
  • Pozostaw tę wartość null, jeśli chcesz zdefiniować reguły wykluczania monitorowania.

-WłączSilnikInstrumentacji

Opcjonalny. Ten przełącznik umożliwia aparatowi instrumentacji zbieranie zdarzeń i komunikatów dotyczących tego, co dzieje się podczas wykonywania zarządzanego procesu. Te zdarzenia i komunikaty obejmują kody wyników zależności, czasowniki HTTP i tekst polecenia SQL.

Aparat instrumentacji dodaje obciążenie i jest domyślnie wyłączony.

-AkceptujLicencję

Opcjonalny. Użyj tego przełącznika, aby zaakceptować licencję i zasady zachowania poufności informacji w instalacjach bez głowy.

-IgnoreSharedConfig

Jeśli masz klaster serwerów internetowych, możesz użyć konfiguracji udostępnionej. Nie można wstrzykiwać modułu HttpModule do tej udostępnionej konfiguracji. Ten skrypt kończy się niepowodzeniem z komunikatem, że wymagane są dodatkowe kroki instalacji. Użyj tego przełącznika, aby zignorować to sprawdzanie i kontynuować instalowanie wymagań wstępnych. Aby uzyskać więcej informacji, zobacz znany konflikt z usługami iis-shared-configuration

-Gadatliwy

Wspólny parametr. Użyj tego przełącznika, aby wyświetlić szczegółowe dzienniki.

-WhatIf

Wspólny parametr. Użyj tego przełącznika, aby przetestować i zweryfikować parametry wejściowe bez faktycznego włączenia monitorowania.

Wyjście

Przykładowe dane wyjściowe z pomyślnego włączenia

Initiating Disable Process
Applying transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config'
'C:\Windows\System32\inetsrv\config\applicationHost.config' backed up to 'C:\Windows\System32\inetsrv\config\applicationHost.config.backup-2019-03-26_08-59-52z'
in :1,237
No element in the source document matches '/configuration/location[@path='']/system.webServer/modules/add[@name='ManagedHttpModuleHelper']'
Not executing RemoveAll (transform line 1, 546)
Transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config' was successfully applied. Operation: 'disable'
GAC Module will not be removed, since this operation might cause IIS instabilities
Configuring IIS Environment for codeless attach...
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]
Configuring IIS Environment for instrumentation engine...
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]
Configuring registry for instrumentation engine...
Successfully disabled Application Insights Agent
Installing GAC module 'C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\0.2.0\content\Runtime\Microsoft.AppInsights.IIS.ManagedHttpModuleHelper.dll'
Applying transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config'
Found GAC module Microsoft.AppInsights.IIS.ManagedHttpModuleHelper.ManagedHttpModuleHelper, Microsoft.AppInsights.IIS.ManagedHttpModuleHelper, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
'C:\Windows\System32\inetsrv\config\applicationHost.config' backed up to 'C:\Windows\System32\inetsrv\config\applicationHost.config.backup-2019-03-26_08-59-52z_1'
Transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config' was successfully applied. Operation: 'enable'
Configuring IIS Environment for codeless attach...
Configuring IIS Environment for instrumentation engine...
Configuring registry for instrumentation engine...
Updating app pool permissions...
Successfully enabled Application Insights Agent

Disable-InstrumentationEngine

Wyłącza aparat instrumentacji, usuwając niektóre klucze rejestru. Uruchom ponownie usługi IIS, aby zmiany zaczęły obowiązywać.

Przykłady

Disable-InstrumentationEngine

Parametry

-Gadatliwy

Wspólny parametr. Użyj tego przełącznika, aby wyświetlić szczegółowe dzienniki.

Wyjście

Przykładowe dane wyjściowe z pomyślnego wyłączenia aparatu instrumentacji

Configuring IIS Environment for instrumentation engine...
Registry: removing 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]'
Registry: removing 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]'
Registry: removing 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]'
Configuring registry for instrumentation engine...

Disable-ApplicationInsightsMonitoring

Wyłącza monitorowanie na komputerze docelowym. To polecenie cmdlet usuwa zmiany w pliku applicationHost.config usług IIS i usuwa klucze rejestru.

Przykłady

Disable-ApplicationInsightsMonitoring

Parametry

-Gadatliwy

Wspólny parametr. Użyj tego przełącznika, aby wyświetlić szczegółowe dzienniki.

Wyjście

Przykładowe dane wyjściowe z pomyślnego wyłączenia monitorowania

Initiating Disable Process
Applying transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config'
'C:\Windows\System32\inetsrv\config\applicationHost.config' backed up to 'C:\Windows\System32\inetsrv\config\applicationHost.config.backup-2019-03-26_08-59-00z'
in :1,237
No element in the source document matches '/configuration/location[@path='']/system.webServer/modules/add[@name='ManagedHttpModuleHelper']'
Not executing RemoveAll (transform line 1, 546)
Transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config' was successfully applied. Operation: 'disable'
GAC Module will not be removed, since this operation might cause IIS instabilities
Configuring IIS Environment for codeless attach...
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]
Configuring IIS Environment for instrumentation engine...
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]
Configuring registry for instrumentation engine...
Successfully disabled Application Insights Agent

Get-ApplicationInsightsMonitoringConfig

Pobiera plik konfiguracji i drukuje wartości w konsoli.

Przykłady

Get-ApplicationInsightsMonitoringConfig

Parametry

Brak wymaganych parametrów.

Wyjście

Przykładowe dane wyjściowe z odczytywania pliku konfiguracji

RedfieldConfiguration:
Filters:
0)InstrumentationKey: AppFilter: WebAppExclude MachineFilter: .*
1)InstrumentationKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx2 AppFilter: WebAppTwo MachineFilter: .*
2)InstrumentationKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxdefault AppFilter: .* MachineFilter: .*

Get-ApplicationInsightsMonitoringStatus

To polecenie cmdlet zawiera informacje dotyczące rozwiązywania problemów z agentem usługi Application Insights. Użyj tego polecenia cmdlet, aby zbadać stan monitorowania, wersję modułu programu PowerShell i sprawdzić uruchomiony proces. To polecenie cmdlet zgłasza informacje o wersji i informacje o kluczowych plikach wymaganych do monitorowania.

Przykłady

Przykład: stan aplikacji

Uruchom polecenie Get-ApplicationInsightsMonitoringStatus , aby wyświetlić stan monitorowania witryn sieci Web.

Get-ApplicationInsightsMonitoringStatus

IIS Websites:

SiteName               : Default Web Site
ApplicationPoolName    : DefaultAppPool
SiteId                 : 1
SiteState              : Stopped

SiteName               : DemoWebApp111
ApplicationPoolName    : DemoWebApp111
SiteId                 : 2
SiteState              : Started
ProcessId              : not found

SiteName               : DemoWebApp222
ApplicationPoolName    : DemoWebApp222
SiteId                 : 3
SiteState              : Started
ProcessId              : 2024
Instrumented           : true
InstrumentationKey     : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx123

SiteName               : DemoWebApp333
ApplicationPoolName    : DemoWebApp333
SiteId                 : 4
SiteState              : Started
ProcessId              : 5184
AppAlreadyInstrumented : true

W tym przykładzie:

• Identyfikator komputera jest identyfikatorem anonimowym używanym do unikatowego identyfikowania serwera. Jeśli tworzysz wniosek o pomoc techniczną, potrzebujemy tego identyfikatora, aby znaleźć dzienniki dla serwera.

• Domyślna witryna sieci Web jest zatrzymana na serwerze IIS

• Usługi IIS pokazują , że aplikacja DemoWebApp111 została uruchomiona, ale aplikacja nie odbiera żadnych żądań. Raport nie pokazuje uruchomionego procesu (ProcessId: not found).

• Aplikacja DemoWebApp222 jest uruchomiona i jest monitorowana (Instrumented: true). Na podstawie konfiguracji użytkownika klucz instrumentacji xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxx123 został dopasowany dla tej witryny.

• DemoWebApp333 jest ręcznie instrumentowany przy użyciu zestawu SDK usługi Application Insights. Agent usługi Application Insights wykrywa zestaw SDK i nie monitoruje tej witryny.

• Obecność AppAlreadyInstrumented : true oznacza, że agent Application Insights zidentyfikował konfliktującą bibliotekę DLL załadowaną w aplikacji internetowej, przyjął, że aplikacja jest instrumentowana ręcznie, i dlatego agent wycofał się i nie instrumentuje tego procesu.

• Instrumented : true wskazuje, że agent usługi Application Insights pomyślnie instrumentował aplikację internetową uruchomioną w określonym procesie w3wp.exe.

Przykład: informacje o module programu PowerShell

Uruchom polecenie Get-ApplicationInsightsMonitoringStatus -PowerShellModule , aby wyświetlić informacje o bieżącym module:

Get-ApplicationInsightsMonitoringStatus -PowerShellModule

PowerShell Module version:
0.4.0-alpha

Application Insights SDK version:
2.9.0.3872

Executing PowerShell Module Assembly:
Microsoft.ApplicationInsights.Redfield.Configurator.PowerShell, Version=2.8.14.11432, Culture=neutral, PublicKeyToken=31bf3856ad364e35

PowerShell Module Directory:
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\0.2.2\content\PowerShell

Runtime Paths:
ParentDirectory (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content

ConfigurationPath (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\applicationInsights.ikey.config

ManagedHttpModuleHelperPath (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AppInsights.IIS.ManagedHttpModuleHelper.dll

RedfieldIISModulePath (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll

InstrumentationEngine86Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation32\MicrosoftInstrumentationEngine_x86.dll

InstrumentationEngine64Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\MicrosoftInstrumentationEngine_x64.dll

InstrumentationEngineExtensionHost86Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation32\Microsoft.ApplicationInsights.ExtensionsHost_x86.dll

InstrumentationEngineExtensionHost64Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.ApplicationInsights.ExtensionsHost_x64.dll

InstrumentationEngineExtensionConfig86Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation32\Microsoft.InstrumentationEngine.Extensions.config

InstrumentationEngineExtensionConfig64Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.InstrumentationEngine.Extensions.config

ApplicationInsightsSdkPath (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.dll

Przykład: stan środowiska uruchomieniowego

Możesz sprawdzić proces na instrumentowanych komputerach, aby sprawdzić, czy załadowano wszystkie biblioteki DLL. Jeśli monitorowanie działa, należy załadować co najmniej 12 bibliotek DLL.

Uruchom polecenie Get-ApplicationInsightsMonitoringStatus -InspectProcess.

Get-ApplicationInsightsMonitoringStatus -InspectProcess

iisreset.exe /status
Status for IIS Admin Service ( IISADMIN ) : Running
Status for Windows Process Activation Service ( WAS ) : Running
Status for Net.Msmq Listener Adapter ( NetMsmqActivator ) : Running
Status for Net.Pipe Listener Adapter ( NetPipeActivator ) : Running
Status for Net.Tcp Listener Adapter ( NetTcpActivator ) : Running
Status for World Wide Web Publishing Service ( W3SVC ) : Running

handle64.exe -accepteula -p w3wp
BF0: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.ServerTelemetryChannel.dll
C58: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.AzureAppServices.dll
C68: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.DependencyCollector.dll
C78: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.WindowsServer.dll
C98: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.Web.dll
CBC: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.PerfCounterCollector.dll
DB0: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.Agent.Intercept.dll
B98: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll
BB4: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.Contracts.dll
BCC: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.Redfield.Lightup.dll
BE0: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.dll

listdlls64.exe -accepteula w3wp
0x0000000019ac0000  0x127000  C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\MicrosoftInstrumentationEngine_x64.dll
0x00000000198b0000  0x4f000   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.ApplicationInsights.ExtensionsHost_x64.dll
0x000000000c460000  0xb2000   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.ApplicationInsights.Extensions.Base_x64.dll
0x000000000ad60000  0x108000  C:\Windows\TEMP\2.4.0.0.Microsoft.ApplicationInsights.Extensions.Intercept_x64.dll

Parametry

(Brak parametrów)

Domyślnie to polecenie cmdlet zgłasza stan monitorowania aplikacji internetowych. Użyj tej opcji, aby sprawdzić, czy aplikacja została pomyślnie instrumentowana. Możesz również sprawdzić, który klucz instrumentacji został dopasowany do witryny.

-PowerShellModule

Opcjonalnie. Użyj tego przełącznika, aby zgłosić numery wersji i ścieżki bibliotek DLL wymaganych do monitorowania. Użyj tej opcji, jeśli musisz zidentyfikować wersję dowolnej biblioteki DLL, w tym zestaw SDK usługi Application Insights.

-InspectProcess

Opcjonalnie. Użyj tego przełącznika, aby zgłosić, czy usługi IIS są uruchomione. Pobiera on narzędzia zewnętrzne w celu określenia, czy wymagane biblioteki DLL są ładowane do środowiska uruchomieniowego usług IIS.

Jeśli ten proces zakończy się niepowodzeniem z jakiegokolwiek powodu, możesz uruchomić te polecenia ręcznie:

• iisreset.exe /status
• [handle64.exe](/sysinternals/downloads/handle) -p w3wp | findstr /I "InstrumentationEngine AI. ApplicationInsights"
• [listdlls64.exe](/sysinternals/downloads/listdlls) w3wp | findstr /I "InstrumentationEngine AI ApplicationInsights"

-Siła

Opcjonalnie. Używane tylko w przypadku funkcji InspectProcess. Użyj tego przełącznika, aby pominąć monit użytkownika wyświetlany przed pobraniem większej liczby narzędzi.

Set-ApplicationInsightsMonitoringConfig

Ustawia plik konfiguracji bez wykonywania pełnej ponownej instalacji. Uruchom ponownie usługi IIS, aby zmiany zaczęły obowiązywać.

Ważne

To polecenie cmdlet wymaga sesji programu PowerShell z uprawnieniami administratora.

Przykłady

Przykład z pojedynczym kluczem instrumentacji

W tym przykładzie aplikacje na bieżącym komputerze są dostarczane z jednym kluczem do instrumentacji.

Enable-ApplicationInsightsMonitoring -InstrumentationKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Przykład z mapą klucza instrumentacji

W tym przykładzie:

• MachineFilter pasuje do bieżącego komputera przy użyciu symbolu wieloznakowego '.*' .
• AppFilter='WebAppExclude' null zapewnia klucz instrumentacji. Określona aplikacja nie jest instrumentowana.
• AppFilter='WebAppOne' przypisuje określonej aplikacji unikatowy klucz instrumentacji.
• AppFilter='WebAppTwo' przypisuje określonej aplikacji unikatowy klucz instrumentacji.
• AppFilter używa symbolu wieloznakowego '.*' , aby pasować do aplikacji internetowych, które nie są jeszcze zgodne i przypisuje domyślny klucz instrumentacji.
• Miejsca są dodawane w celu zapewnienia czytelności.

Enable-ApplicationInsightsMonitoring -InstrumentationKeyMap `
    ` @(@{MachineFilter='.*';AppFilter='WebAppExclude'},
      ` @{MachineFilter='.*';AppFilter='WebAppOne';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx1'}},
      ` @{MachineFilter='.*';AppFilter='WebAppTwo';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx2'}},
      ` @{MachineFilter='.*';AppFilter='.*';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxdefault'}})

Parametry

-InstrumentationKey (Klucz Instruktażowy)

Wymagany. Użyj tego parametru, aby podać pojedynczy klucz instrumentacji do użycia przez wszystkie aplikacje na komputerze docelowym.

-InstrumentationKeyMap

Wymagany. Użyj tego parametru, aby podać wiele kluczy instrumentacji i mapowanie kluczy instrumentacji używanych przez każdą aplikację. Można utworzyć pojedynczy skrypt instalacyjny dla kilku komputerów, ustawiając wartość MachineFilter.

Ważne

Aplikacje są zgodne z regułami w podanej kolejności. Najpierw określ najbardziej specyficzne reguły, a na końcu najbardziej ogólne reguły.

Ważne

InstrumentationKeyMap to zaawansowana funkcja routingu, która mapuje aplikacje usług Internet Information Services (IIS) działające na tym samym komputerze na zasoby Application Insights. Ta funkcja dotyczy aplikacji ASP.NET i ASP.NET Core hostowanych przez usługi IIS, które są automatycznie instrumentowane przez agenta Application Insights.

Jak działa dopasowywanie

• Mapa definiuje uporządkowaną listę reguł o nazwie filters. Pierwsza zgodna reguła wchodzi w życie. Najpierw umieść określone reguły i zakończ je regułą catch-all.
• Każda reguła może przypisać inny zasób usługi Application Insights do pasujących aplikacji. Preferuj używanie parametrów połączenia w obsługiwanych scenariuszach, ponieważ klucze instrumentacji są starsze.

Dostępne filtry

• MachineFilter lub machineFilter: wyrażenie regularne języka C#, które jest zgodne z nazwą komputera lub maszyny wirtualnej. .* pasuje do wszystkich nazw.
• AppFilter lub appFilter: wyrażenie regularne języka C# zgodne z nazwą witryny usług IIS (HostingEnvironment.SiteName). Ten filtr jest wymagany, jeśli VirtualPathFiltervirtualPathFilter nie jest podany.
• VirtualPathFilter lub virtualPathFilter: wyrażenie regularne języka C# zgodne ze ścieżką wirtualną usług IIS (HostingEnvironment.ApplicationVirtualPath). Użyj tego filtru, aby wybrać pojedynczą aplikację w obrębie witryny.

Mapowanie terminologii

• Polecenia cmdlet programu PowerShell używają MachineFilter, AppFilter i VirtualPathFilter.
• Rozszerzenie JSON maszyn wirtualnych platformy Azure i zestawów skalowania maszyn wirtualnych używa machineFilter, appFilter i virtualPathFilter, i ustawia zasób za pomocą instrumentationSettings.

Wskazówka

Dołącz ostateczną regułę zgodną ze wszystkimi aplikacjami, taką jak .*, i zastosuj zasób domyślny, aby jawnie ustawić zachowanie.

Kształt mapy tego polecenia cmdlet

• Podaj -InstrumentationKeyMap jako tablicę programu PowerShell tabel skrótów.
• Dla tego polecenia cmdlet ustaw zasób docelowy zgodnie z regułą za pomocą InstrumentationSettings=@{ InstrumentationKey = '<ikey>' }.
• Jeśli chcesz mieć jeden zasób dla wszystkich aplikacji na maszynie, użyj polecenia -ConnectionString lub -InstrumentationKey zamiast tego.

Start-ApplicationInsightsMonitoringTrace

Zbiera zdarzenia śledzenia zdarzeń systemu Windows (ETW), które emituje środowisko uruchomieniowe dołączania bez kodu. Użyj tego polecenia cmdlet jako prostszej alternatywy dla uruchamiania narzędzia PerfView.

Zdarzenia są drukowane w konsoli w czasie rzeczywistym, a także zapisywane w .etl pliku. Plik można otworzyć w .etl PerfView w celu dokładniejszej analizy.

To polecenie cmdlet jest uruchamiane, dopóki nie osiągnie limitu czasu, wartość domyślna to 5 minut lub do momentu ręcznego zatrzymania go za pomocą polecenia Ctrl + C.

Przykłady

Jak zbierać zdarzenia

Użyj tego przepływu, gdy musisz zbadać, dlaczego aplikacja IIS nie jest monitorowana.

Środowisko uruchomieniowe dołączania bez kodu emituje zdarzenia ETW po uruchomieniu usług IIS i uruchomieniu aplikacji.

1. W wierszu polecenia administracyjnego uruchom polecenie iisreset /stop , aby zatrzymać usługi IIS i wszystkie aplikacje internetowe.
2. Rozpocznij śledzenie, uruchamiając polecenie cmdlet.
3. W wierszu polecenia administracyjnego uruchom polecenie iisreset /start , aby uruchomić usługi IIS.
4. Zainicjuj uruchamianie, otwierając aplikację.
5. Po zakończeniu ładowania aplikacji naciśnij Ctrl + C , aby zatrzymać lub zezwolić na zakończenie sesji.

Jakie zdarzenia mają być zbierane

Możesz wybrać źródła zdarzeń do uwzględnienia:

1. -CollectSdkEvents zbiera zdarzenia z zestawu SDK usługi Application Insights.
2. -CollectRedfieldEvents zbiera zdarzenia od agenta Application Insights oraz środowiska uruchomieniowego Redfield, co jest przydatne przy diagnostyce uruchamiania IIS i aplikacji.
3. Zbierz oba zestawy, określając oba przełączniki.
4. Jeśli nie określisz przełącznika, oba zestawy są zbierane domyślnie.

Parametry

-MaksymalnyCzasTrwaniaWMinutach

Opcjonalny. Określa czas zbierania przed upływem limitu czasu. Wartość domyślna to 5 minut.

-LogDirectory

Opcjonalny. Katalog, w którym powinien zostać zapisany plik .etl. Domyślnie plik jest tworzony w katalogu modułu programu PowerShell. Pełna ścieżka jest wyświetlana po rozpoczęciu sesji.

-KolekcjonujZdarzeniaSDK

Opcjonalny. Uwzględnij zdarzenia zestawu SDK usługi Application Insights.

-ZbierajZdarzeniaRedfield

Opcjonalny. Uwzględnij zdarzenia z agenta usługi Application Insights i środowiska uruchomieniowego Redfield.

-Gadatliwy

Wspólny parametr. Generuje szczegółowe dzienniki.

Wyjście

Przykład dzienników uruchamiania aplikacji

Start-ApplicationInsightsMonitoringTrace -CollectRedfieldEvents
Starting...
Log File: C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\logs\20190627_144217_ApplicationInsights_ETW_Trace.etl
Tracing enabled, waiting for events.
Tracing will timeout in 5 minutes. Press CTRL+C to cancel.
2:42:31 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Resolved variables to: MicrosoftAppInsights_ManagedHttpModulePath='C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll', MicrosoftAppInsights_ManagedHttpModuleType='Microsoft.ApplicationInsights.RedfieldIISModule.RedfieldIISModule'
2:42:31 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Resolved variables to: MicrosoftDiagnosticServices_ManagedHttpModulePath2='', MicrosoftDiagnosticServices_ManagedHttpModuleType2=''
2:42:31 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Environment variable 'MicrosoftDiagnosticServices_ManagedHttpModulePath2' or 'MicrosoftDiagnosticServices_ManagedHttpModuleType2' is null, skipping managed dll loading