Środowisko Monitoring .NET Framework

Obsługiwane systemy operacyjne

Do monitorowania środowiska .NET Framework obsługiwany jest tylko system Windows ®. Obsługiwane systemy operacyjne Windows są takie same, jak wymagania agenta Windows.

Obsługiwane wersje

Instana obsługuje monitorowanie aplikacji działających w środowisku .NET Framework w wersji 4.5.1 i nowszych.

Obsługiwane biblioteki i środowiska na potrzeby śledzenia

W przypadku rejestrowania można ustawić zmienną środowiskową INSTANA_LOG_LEVEL_CAPTURE , aby zapobiec tworzeniu zakresów dla dzienników o poziomie niższym niż ustawiony. Wartością może być WARN, ERRORlub OFF (aby wyłączyć tę opcję). Wartością domyślną jest WARN.

Podpisy poprawności

Dla każdego czujnika w sposób ciągły sprawdzana jest baza wiedzy sygnatur poprawności w odniesieniu do przychodzących wielkości mierzonych. Na podstawie oceny zgłaszane są problemy lub incydenty w zależności od wpływu użytkownika.

Wbudowane zdarzenia wyzwalają problemy lub incydenty na podstawie niesprawnych sygnatur poprawności jednostek, a zdarzenia niestandardowe wyzwalają problemy lub incydenty na podstawie progów pojedynczej wielkości mierzonej dla każdego obiektu.

Więcej informacji na temat wbudowanych zdarzeń dla czujnika .NET zawiera sekcja Skorowidz wbudowanych zdarzeń.

Jak działa śledzenie

Po włączeniu śledzenia przez zmianę pliku konfiguracyjnego dane śledzenia są gromadzone dla wszystkich aplikacji, które korzystają z obsługiwanych technologii. .NET Framework-Śledzenie używa tego samego schematu, co wszystkie inne pakiety śledzenia. Rozproszone ślady w aplikacjach poliglot są automatycznie gromadzone i wyświetlane w interfejsie użytkownika Instana.

Podczas uruchamiania aplikacji z włączonym śledzeniem może okazać się, że czas uruchamiania jest dłuższy niż czas uruchamiania bez śledzenia. Jest to spowodowane dołączaniem reguły profilującej, sprawdzaniem klas zawartych w przywoływanych zespołach, a następnie kompilowaniem kodu niektórych metod na potrzeby instrumentacji. Po zastosowaniu instrumentacji, wpływ na wydajność środowiska wykonawczego aplikacji jest bardzo niski, tak jak w przypadku innych pakietów śledzenia, które są udostępniane przez Instana.

Konfiguracja komponentu śledzenia jest w większości przypadków funkcją automatyczną agenta. Aby jednak skonfigurować śledzenie, należy wykonać krok ręczny opisany w poniższych sekcjach.

Konfigurowanie śledzenia dla środowiska .NET Framework

Gdy agent Instana jest uruchamiany na komputerze z systemem Windows, agent Instana instaluje rozszerzenie śledzenia dla środowiska .NET Framework. Rozszerzenie składa się z kilku plików, które zawierają rzeczywiste komponenty śledzenia. Ponieważ Instana używa interfejsu API profilowania zdefiniowanego w środowisku .NET, obejmuje on biblioteki COM i zarządzane zespoły. Jeśli śledzenie jest włączone, pliki są rejestrowane, dzięki czemu wszystkie aplikacje mogą ich używać do śledzenia. Rozszerzenia czujnika i śledzenia są domyślnie włączone.

Po uruchomieniu agenta InstanaPCP rejestruje informacje o procesie włączania śledzenia, jak pokazano w poniższym przykładzie (skrócone wiersze dziennika). Przedstawia configuration.yaml z włączonym śledzeniem .NET Framework.

INFO  | com.instana.agent - 1.1.326 | Writing location for instrumentation-advices to registry
INFO  | com.instana.agent - 1.1.326 | Setting up tracing-environment
INFO  | com.instana.agent - 1.1.326 | Registering native profiler for .NET
INFO  | com.instana.agent - 1.1.326 | Agent UUID received:ac:bc:32:ff:fe:90:7d:bb
INFO  | com.instana.agent - 1.1.326 | Registering System.Collections.Immutable.dll in GAC
INFO  | com.instana.agent - 1.1.326 | .NET Tracing is enabled
INFO  | com.instana.agent - 1.1.326 | Registering instrumentation-DLLs in GAC
INFO  | com.instana.agent - 1.1.326 | Registering Instana.ManagedTracing.dll in GAC
INFO  | com.instana.agent - 1.1.326 | Setting environment-variables for .NET tracing
INFO  | com.instana.agent - 1.1.326 | Registry-Key for WAS-Environment does not exist, will create now
INFO  | com.instana.agent - 1.1.326 | Setting environment for WAS
WARN  | com.instana.agent - 1.1.326 | You should consider restarting the service WAS in order to make it use the new profiler. Already running application will not use it until restarted.
INFO  | com.instana.agent - 1.1.326 | Registry-Key for W3SVC-Environment does not exist, will create now
INFO  | com.instana.agent - 1.1.326 | Setting environment for W3SVC
WARN  | com.instana.agent - 1.1.326 | You should consider restarting the service W3SVC in order to make it use the new profiler. Already running application will not use it until restarted.
INFO  | com.instana.agent - 1.1.326 | Setting memoryUsageExcessThreshold set to configured value of 100000000
INFO  | com.instana.agent - 1.1.326 | Self-Monitoring for Windows-Extensions has been started successfully
INFO  | com.instana.agent - 1.1.326 | Setting memoryUsageWarningThreshold set to configured value of 80000000
INFO  | com.instana.agent - 1.1.326 | Starting tracing-session
INFO  | com.instana.agent - 1.1.326 | Windows-Extension REST-Endpoint has been setup successfully at http://localhost:42657
INFO  | com.instana.agent - 1.1.326 | Registering Instana.ManagedTracing.Modules.dll in GAC
INFO  | com.instana.agent - 1.1.326 | Instana ETW-Reader setup and listening

Rozszerzenie rejestruje plik COM-DLL (profiler) z trzema zarządzanymi zespołami, które zawierają rzeczywisty kod instrumentacji lub są wymagane do działania instrumentacji (Instana.ManagedTracing.dll, Instana.ManagedTracing.Base.dll, System.Collections.Immutable.dll). Po zarejestrowaniu komponentów rozszerzenie aktualizuje rejestr, tak aby wszystkie instancje W3SVC lub WebSphere Application Server przyłączały profiler przy następnym uruchomieniu. Do dzienników zostanie dodane ostrzeżenie o restartowaniu już uruchomionych aplikacji. Instana nie restartuje tych usług automatycznie, ponieważ nie chcemy przerywać usług.

Włączanie śledzenia dla aplikacji udostępnianych przez serwer IIS

Jeśli używane są aplikacje obsługiwane przez serwer IIS, nie trzeba wykonywać żadnych dodatkowych czynności konfiguracyjnych. InstanaPCP zajmuje się wszystkimi wszystkimi aplikacjami. Po uruchomieniu agenta Instana i aplikacji InstanaPCP uruchom resetowanie IIS. Korzystając z Menedżera zadań dla systemu Windows, można sprawdzić, czy usługa InstanaPCP jest uruchomiona.

Uwaga: Jeśli resetowanie serwera IIS nie zostanie uruchomione, pracownicy serwera IIS nie będą wiedzieć, że muszą być instrumentowani i nie będzie można śledzić aplikacji udostępnianych przez serwer IIS.

Włączanie śledzenia dla aplikacji udostępnianych przez serwery inne niż IIS

Agent Instana nie włącza śledzenia dla każdej aplikacji opartej na technologii .NET, ponieważ może to spowodować niepożądane zachowanie komponentu. Na przykład śledzenie aplikacji systemu Windows, które nie są w zasięgu potrzeb monitorowania.

SET COR_ENABLE_PROFILING=1
SET COR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}

COR_ENABLE_PROFILING=1
COR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}

Śledzenie niestandardowe

Instany.NET Tracing SDK włącza niestandardowe śledzenie w miejscu, w którym nie ma zastosowania automatyczna instrumentacja Instany (tzn. używane są komponenty, których Instana nie śledzi automatycznie).

Wyłączanie śledzenia dla środowiska .NET Framework

Aby zatrzymać śledzenie aplikacji .NET Framework, zmień stan pliku konfiguracyjnego z powrotem na stan początkowy lub ustaw odpowiednią flagę na wartość "false".

configuration.yaml z wyłączonym śledzeniem .NET Framework

# CLR Tracing
    com.instana.plugin.clr:
      tracing:
        enabled: false

Po przywróceniu początkowego stanu konfiguracji zrestartuj agenta, aby zmiany odniosły skutek.

Wyłączenie śledzenia w agencie nie powoduje usunięcia ani odłączenia reguły profilującej od procesów, które zostały uruchomione z włączonym śledzeniem (czyli procesów roboczych). Aby upewnić się, że reguła profilująca nie zostanie załadowana do aplikacji, należy zrestartować proces hosta.

Nie zdefiniowano zmiennej środowiskowej

Typ problemu monitorowania: clr_env_var_not_defined

Co najmniej jedna zmienna środowiskowa, która jest wymagana do aktywowania śledzenia środowiska Instana .NET Framework, nie jest poprawnie ustawiona.

• W przypadku aplikacji udostępnianych na serwerze IIS komenda iisreset mogła nie zostać wydana lub została wydana przed zarejestrowaniem przez agenta bibliotek, które są wymagane do śledzenia. Jako rozwiązanie wykonaj komendę iisreset z wiersza komend z podwyższonym poziomem uprawnień.

  Jeśli to nie pomoże, należy rozważyć zrestartowanie komputera. W zależności od wersji systemu Windows oraz od tego, czy aplikacje były instalowane lub deinstalowane podczas uruchamiania agenta Instana, może być konieczne wykonanie restartu.

• W przypadku aplikacji, które nie są obsługiwane przez serwer IIS, należy zapoznać się z sekcją Włączanie śledzenia dla aplikacji obsługiwanych przez serwer inny niż IIS , aby uzyskać listę zmiennych środowiskowych i wartości, które należy ustawić w celu śledzenia aplikacji środowiska .NET Framework.

Zmienna środowiskowa ma niepoprawną wartość

Typ problemu monitorowania: clr_env_var_invalid_value

Co najmniej jedna zmienna środowiskowa, która jest wymagana do aktywowania śledzenia Instana .NET Framework, nie ma odpowiedniej wartości. (W zależności od tego, których zmiennych środowiskowych brakuje, nadal mogą być wyświetlane pomiary na panelach kontrolnych Instana dla aplikacji .NET Framework, ale na pewno nie dla danych śledzenia). Listę zmiennych środowiskowych i wartości, które należy ustawić w celu śledzenia aplikacji .NET Framework za pomocą Instana, zawiera sekcja Włączanie śledzenia dla aplikacji udostępnianych przez serwery inne niż IIS .

Ponadto zmienna środowiskowa może mieć niepoprawną wartość, ponieważ istnieje inne narzędzie APM. (W celu przyłączenia środowiska wykonawczego .NET różne narzędzia APM używają podobnych mechanizmów). Ta sytuacja jest opisana w komunikacie w interfejsie użytkownika Instana.

Zanim Instana będzie mogła śledzić aplikację .NET Framework, wyłącz innego agenta APM, przynajmniej dla monitorowania .NET Framework. Więcej informacji na temat wyłączania innego agenta APM zawiera dokumentacja innego narzędzia APM.

InstanaPCP nie działa

Typ problemu monitorowania: clr_instana_pcp_not_running

W dzienniku agenta mogą znajdować się komunikaty ostrzegawcze informujące o tym, że InstanaPCP does not seem to be running. Ten komunikat jest wyzwalany, gdy agent próbuje współdziałać z InstanaPCP , ale nie może tego zrobić. Zwykle agent uruchamia program InstanaPCP na początku procesu startowego i może się z nim komunikować. W następujących okolicznościach uruchomienie programu InstanaPCP może nie być możliwe:

• Agent nie jest uruchomiony z wystarczającymi uprawnieniami (nie działa jako lokalny system lub administrator).
• Wersja środowiska .NET na hoście nie jest obsługiwana. Obsługiwane jest tylko środowisko .NET Framework 4.5.1 i nowsze wersje.
• InstanaPCP zrestartował się z powodu nadmiernego wykorzystania pamięci.

Jeśli ten komunikat jest wyświetlany wielokrotnie, wykonaj następujące czynności:

1. Upewnij się, że agent działa z użytkownikiem, który ma lokalne uprawnienia administracyjne. Jeśli nie, użyj innego konta użytkownika, aby uruchomić agenta, lub nadaj użytkownikowi lokalne uprawnienia administracyjne. Podczas instalowania agenta Instana z pakietu instalacyjnego usługa jest zwykle uruchamiana jako system lokalny, co daje usłudze wystarczające uprawnienia.

2. Sprawdź, która wersja środowiska .NET Framework jest zainstalowana na komputerze. Pakiet instalatora Windows automatycznie instaluje minimalną wersję środowiska .NET Framework wymaganą przez InstanaPCP . Jeśli jednak agent hosta jest instalowany z archiwum ZIP, może być konieczne samodzielne zainstalowanie środowiska. Jeśli nie masz pewności, czy masz poprawną wersję, spróbuj ręcznie uruchomić program InstanaPCP z poziomu wiersza komend, umieszczając go w katalogu <agent-dir>\system\com\instana\agent-windows-extensions\<latest>\agent-windows-extensions-<latest> . Jeśli nie zainstalowano poprawnej wersji środowiska .NET Framework, zostanie wyświetlony powiązany monit.

3. Sprawdź, czy w dzienniku są wyświetlane następujące komunikaty wskazujące na nadmierną konsumpcję:

   InstanaPCP.exe Private-Bytes is above warning-treshhold for XXX times now
   
   Killing InstanaPCP.exe for excessive memory-usage. Possible memory-leak in native Windows-Libraries.
   

   Te komunikaty są spowodowane przez jeden z następujących dwóch problemów:

   1. Na komputerze z systemem Windows, na którym jest uruchomiony InstanaPCP , znajduje się stara wersja interfejsu IIS7 i występuje przeciek pamięci. Ten przeciek może zostać poprawiony przez zainstalowanie aktualizacji firmy Microsoft. Ten problem może wystąpić na komputerach z systemem Windows 2008. Przed zainstalowaniem tej aktualizacji Microsoft należy skontaktować się z działem wsparcia Instana, aby upewnić się, że problem z przeciekiem pamięci występuje na komputerze. Zespół wsparcia może następnie udostępnić odsyłacz do aktualizacji pakietu Microsoft.

   2. Na serwerze działa wiele aplikacji .NET, które generują wiele danych śledzenia. W takim przypadku należy zwiększyć limity pamięci dla InstanaPCP , wprowadzając zmiany w następujących ustawieniach w pliku configuration.yaml agenta:

      com.instana.plugin.clr:
        pcp_warn_limit: <MB-treshold before warning>
        pcp_stop_limit: <MB-treshold  to stop / restart the process>
      

InstanaPCP nie nawiązano połączenia

Typ problemu monitorowania: clr_instana_pcp_not_connected

Agent hosta nie może połączyć się z procesem InstanaPCP , co uniemożliwia pobieranie i przetwarzanie danych śledzenia oraz metryk czasu wykonywania dla procesów .NET.

Jest to zwykle przejściowe niepowodzenie, które rozwiązuje się szybko po zakończeniu inicjowania InstanaPCP . Jeśli nie, skontaktuj się z działem wsparcia Instana.