Narzędzie do przeglądania danych śledzenia usług (SvcTraceViewer.exe)
Narzędzie podglądu śledzenia usługi Windows Communication Foundation (WCF) ułatwia analizowanie śladów diagnostycznych generowanych przez program WCF. Przeglądarka śledzenia usługi umożliwia łatwe scalanie, wyświetlanie i filtrowanie komunikatów śledzenia w dzienniku, dzięki czemu można diagnozować, naprawiać i weryfikować problemy z usługą WCF.
Konfigurowanie śledzenia
Ślady diagnostyczne zawierają informacje pokazujące, co dzieje się w całej operacji aplikacji. Jak wskazuje nazwa, można również wykonywać operacje ze źródła do miejsca docelowego i za pośrednictwem punktów pośrednich.
Śledzenie można skonfigurować przy użyciu pliku konfiguracji aplikacji — web.config dla aplikacji hostowanych w sieci Web lub appname.config dla aplikacji hostowanych samodzielnie. Poniżej przedstawiono przykład:
<system.diagnostics>
<trace autoflush="true" />
<sources>
<source name="System.ServiceModel"
switchValue="Information, ActivityTracing"
propagateActivity="true">
<listeners>
<add name="sdt"
type="System.Diagnostics.XmlWriterTraceListener"
initializeData= "SdrConfigExample.e2e" />
</listeners>
</source>
</sources>
</system.diagnostics>
W tym przykładzie określono nazwę i typ odbiornika śledzenia. Odbiornik ma nazwę sdt , a jako typ jest dodawany standardowy odbiornik śledzenia programu .NET Framework (System.Diagnostics.XmlWriterTraceListener). Atrybut initializeData służy do ustawiania nazwy pliku dziennika dla tego odbiornika na SdrConfigExample.e2e. W przypadku pliku dziennika można zastąpić w pełni kwalifikowaną ścieżką dla prostej nazwy pliku.
Przykład tworzy plik w katalogu głównym o nazwie SdrConfigExample.e2e. Gdy używasz przeglądarki śledzenia do otwierania pliku zgodnie z opisem w sekcji "Otwieranie i wyświetlanie plików śledzenia programu WCF", zobaczysz wszystkie wysłane komunikaty.
Poziom śledzenia jest kontrolowany switchValue przez ustawienie. Dostępne poziomy śledzenia opisano w poniższej tabeli.
| Poziom śledzenia | opis |
|---|---|
| Krytyczne | — Rejestruje wpisy dziennika awarii i dziennika zdarzeń oraz informacje o korelacji śledzenia. Poniżej przedstawiono kilka przykładów użycia poziomu krytycznego: — Element AppDomain poszedł w dół z powodu nieobsługiwanego wyjątku. — Nie można uruchomić aplikacji. — komunikat, który spowodował błąd pochodzący z procesu MyApp.exe. |
| Błąd | — Rejestruje wszystkie wyjątki. Poziom Błędu można użyć w następujących sytuacjach: — Kod uległ awarii z powodu nieprawidłowego wyjątku rzutowania. — Wyjątek "nie można utworzyć punktu końcowego" powoduje niepowodzenie aplikacji podczas uruchamiania. |
| Ostrzeżenie | - Istnieje warunek, który może następnie spowodować błąd lub błąd krytyczny. Tego poziomu można użyć w następujących sytuacjach: — Aplikacja odbiera więcej żądań, niż zezwala na jej ustawienia ograniczania. - Kolejka odbierającego wynosi 98 procent skonfigurowanej pojemności. |
| Informacja | - Komunikaty przydatne do monitorowania i diagnozowania stanu systemu, mierzenia wydajności lub profilowania są generowane. Takie informacje można wykorzystać do planowania pojemności i zarządzania wydajnością. Tego poziomu można użyć w następujących sytuacjach: — Wystąpił błąd po dotarciu komunikatu do domeny aplikacji i został zdeserializowany. — Wystąpił błąd podczas tworzenia powiązania HTTP. |
| Pełne informacje | — Śledzenie na poziomie debugowania dla kodu użytkownika i obsługi. Ustaw ten poziom, gdy: — Nie masz pewności, która metoda w kodzie została wywołana, gdy wystąpił błąd. — Skonfigurowano niepoprawny punkt końcowy, a uruchomienie usługi nie powiodło się, ponieważ wpis w magazynie rezerwacji jest zablokowany. |
| ActivityTracing | Przepływ zdarzeń między działaniami przetwarzania i składnikami. Ten poziom umożliwia administratorom i deweloperom korelowanie aplikacji w tej samej domenie aplikacji. - Ślady granic działań: uruchamianie/zatrzymywanie. - Ślady transferów. |
Można użyć add określić nazwę i typ odbiornik śledzenia ma być używany. W przykładowej konfiguracji odbiornik ma nazwę sdt , a standardowy odbiornik śledzenia programu .NET Framework (System.Diagnostics.XmlWriterTraceListener) jest dodawany jako typ. Użyj initializeData polecenia , aby ustawić nazwę pliku dziennika dla tego odbiornika. Ponadto można zastąpić w pełni kwalifikowaną ścieżkę dla prostej nazwy pliku.
Począwszy od programu .NET Framework 4.8, kontrolki ComboBox w niektórych motywach o wysokim kontraście są wyświetlane w poprawnym kolorze. Tę zmianę można wyłączyć, usuwając następujące ustawienie z pliku svcTraceViewer.exe.config :
<AppContextSwitchOverrides value="Switch.UseLegacyAccessibilityFeatures=false;Switch.UseLegacyAccessibilityFeatures.2=false" />
Korzystanie z narzędzia podglądu śledzenia usługi
Otwieranie i wyświetlanie plików śledzenia programu WCF
Przeglądarka śledzenia usługi obsługuje trzy typy plików:
Plik śledzenia programu WCF (.svcLog)
Plik śledzenia zdarzeń (etl)
Plik śledzenia szkarłatny
Przeglądarka śledzenia usługi umożliwia otwieranie dowolnego obsługiwanego pliku śledzenia, dodawanie i integrowanie dodatkowych plików śledzenia lub otwieranie i scalanie grupy plików śledzenia jednocześnie.
Aby otworzyć plik śledzenia
- Uruchom podgląd śledzenia usługi przy użyciu okna polecenia, aby przejść do lokalizacji instalacji programu WCF (C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin), a następnie wpisz
SvcTraceViewer.exe.
Uwaga
Narzędzie Podgląd śledzenia usługi może kojarzyć się z dwoma typami plików: .svclog i stvproj. W wierszu polecenia można użyć dwóch parametrów, aby zarejestrować i wyrejestrować rozszerzenia plików.
/register: zarejestruj skojarzenie rozszerzeń plików ".svclog" i ".stvproj" za pomocą SvcTraceViewer.exe
/unregister: wyrejestrowywanie skojarzenia rozszerzeń plików ".svclog" i ".stvproj" za pomocą SvcTraceViewer.exe
Po uruchomieniu podglądu śledzenia usługi kliknij pozycję Plik , a następnie wskaż polecenie Otwórz. Przejdź do lokalizacji, w której są przechowywane pliki śledzenia.
Kliknij dwukrotnie plik śledzenia, który chcesz otworzyć.
Uwaga
Naciśnij klawisze SHIFT, klikając wiele plików śledzenia, aby wybrać i otworzyć je jednocześnie. Przeglądarka śledzenia usługi scala zawartość wszystkich plików i przedstawia jeden widok. Na przykład można otwierać pliki śledzenia zarówno klienta, jak i usługi. Jest to przydatne, gdy włączono rejestrowanie komunikatów i propagację działań w konfiguracji. W ten sposób można sprawdzić wymianę komunikatów między klientem a usługą. Możesz również przeciągnąć wiele plików do przeglądarki lub użyć karty Projekt . Aby uzyskać więcej informacji, zobacz sekcję Zarządzanie projektem.
Aby dodać dodatkowe pliki śledzenia do otwartej kolekcji, kliknij pozycję Plik , a następnie wskaż polecenie Dodaj. W wyświetlonym oknie przejdź do lokalizacji plików śledzenia i kliknij dwukrotnie plik, który chcesz dodać.
Uwaga
Nie zaleca się ładowania pliku dziennika śledzenia większego niż 200 MB. Jeśli próbujesz załadować plik większy niż ten limit, proces ładowania może zająć dużo czasu, w zależności od zasobu komputera. Narzędzie Podgląd śledzenia usługi może nie odpowiadać przez długi czas lub może wyczerpać pamięć maszyny. Zaleca się skonfigurowanie częściowego ładowania, aby tego uniknąć. Aby uzyskać więcej informacji na temat tego, jak to zrobić, zobacz sekcję "Ładowanie dużych plików śledzenia".
Śledzenie zdarzeń i śledzenie szkarłatne
Natywny format przeglądarki to format śledzenia działań emitujący program WCF. Ślady emitowane w innym formacie muszą zostać przekonwertowane przed wyświetleniem ich przez przeglądarkę. Obecnie oprócz formatu śledzenia aktywności przeglądarka obsługuje śledzenie zdarzeń i śledzenie szkarłatne.
Po otwarciu pliku, który nie zawiera śladów aktywności, przeglądarka próbuje przekonwertować plik. Należy określić nazwę i lokalizację pliku, który będzie zawierać przekonwertowane dane śledzenia. Po przekonwertowaniu danych przeglądarka wyświetla zawartość nowego pliku.
Uwaga
Konwersja wymaga miejsca na dysku do przechowywania przekonwertowanych danych śledzenia. Przed rozpoczęciem konwersji upewnij się, że masz wystarczającą ilość miejsca na dysku do przechowywania danych. W przeciwnym razie konwersja nie powiedzie się.
Zarządzanie projektami
Przeglądarka obsługuje projekty ułatwiające wyświetlanie wielu plików śledzenia. Jeśli na przykład masz plik śledzenia klienta i plik śledzenia usługi, możesz dodać je do projektu. Następnie za każdym razem, gdy otworzysz projekt, wszystkie pliki śledzenia w projekcie są ładowane jednocześnie.
Istnieją dwa sposoby zarządzania projektami:
W menu Plik można otwierać, zapisywać i zamykać projekty.
Na karcie Project (Projekt ) możesz dodawać pliki do projektu.
Wyświetlanie śladów programu WCF
Program WCF emituje ślady przy użyciu formatu śledzenia aktywności. W modelu śledzenia aktywności poszczególne ślady są grupowane w działaniach zgodnie z ich celem. Przepływ sterowania logicznego jest przesyłany między działaniami. Na przykład w okresie istnienia aplikacji pojawia się wiele "działań wysyłania komunikatów" i znika. Aby uzyskać więcej informacji na temat wyświetlania śladów i działań oraz interfejsu użytkownika podglądu śledzenia usługi, zobacz Używanie podglądu śledzenia usługi do wyświetlania skorelowanych śladów i rozwiązywania problemów.
Przełączanie do różnych widoków
Przeglądarka śledzenia usługi udostępnia następujące różne widoki. Są one wyświetlane jako karty w okienku po lewej stronie przeglądarki, a także można uzyskać do nich dostęp z menu Widok .
Widok działania
Widok projektu
Widok komunikatów
Widok wykresu
Widok działania
Po otwarciu plików śledzenia można zobaczyć ślady pogrupowane w działania i wyświetlane w widoku Działania w okienku po lewej stronie.
W widoku Działanie są wyświetlane nazwy działań, liczba śladów w działaniu, czas trwania, czas rozpoczęcia i godzina zakończenia.
Klikając dowolne z wymienionych działań, ślady w tym działaniu są wyświetlane w okienku śledzenia po prawej stronie. Następnie możesz wybrać ślad, aby wyświetlić jego szczegóły.
Możesz zaznaczyć wiele działań, naciskając klawisz Ctrl lub Shift i klikając żądane działania. W okienku śledzenia są wyświetlane wszystkie ślady wybranych działań.
Możesz kliknąć dwukrotnie działanie, aby wyświetlić je w widoku grafu . Alternatywnym sposobem jest wybranie działania i przełączenie się do widoku grafu .
Uwaga
Działanie "0000000000000" jest specjalnym działaniem, którego nie można wyświetlić w widoku programu Graph. Ponieważ wszystkie inne działania są z nim powiązane, wyświetlanie tego działania ma poważny wpływ na wydajność.
Możesz kliknąć tytuł kolumny, aby posortować listę działań. Działania zawierające ślady ostrzegawcze mają żółte tło, a te, które zawierają ślady błędów, mają czerwony.
Istnieją różne typy działań, a każdy typ odpowiada ikonie po lewej stronie każdego działania. Aby uzyskać ich znaczenie, możesz zapoznać się z sekcją Opis ikon śledzenia.
Widok projektu
Ten widok umożliwia zarządzanie plikami śledzenia w bieżącym projekcie. Aby uzyskać więcej informacji, zobacz sekcję Zarządzanie projektem.
Widok komunikatów
Ten widok umożliwia wyświetlanie wszystkich śladów dziennika komunikatów, w tym akcji, daty/godziny, procesu, działania i z/do oraz przechodzenia do szczegółów skojarzonego śledzenia dziennika komunikatów. Możesz zgrupować ślady dziennika komunikatów według granicy działania, procesu/wątku lub wyślij i odbierz, aby ułatwić nawigację przepływu komunikatów.
Widok wykresu
Ten widok wyświetla dane śledzenia dla danego działania w formularzu wykresu. Formularz wykresu umożliwia wyświetlanie krokowego wykonywania zdarzeń i interrelationships między wieloma działaniami w miarę przemieszczania się między nimi danych.
Aby przełączyć się do widoku programu Graph, wybierz działanie w widoku Działania i kliknij kartę Działanie lub ślad dziennika komunikatów w widoku komunikatów. Jeśli załadowano wiele plików śledzenia i działanie obejmuje ślady z więcej niż jednego pliku, wszystkie odpowiednie ślady są wyświetlane w widoku grafu. Dwukrotne kliknięcie działań i śladów dziennika komunikatów prowadzi również do widoku grafu .
W widoku programu Graph każda kolumna pionowa reprezentuje działanie, a każdy blok w kolumnie reprezentuje ślad. Działania są grupowane według procesu (lub wątku). Małe strzałki między działaniami reprezentują transfery. Duże strzałki między procesami reprezentują wymianę komunikatów. Działanie w zaznaczeniu jest zawsze żółte.
Wybieranie śladów w grafie
Kliknij blok na grafie.
Użyj klawiszy w górę i w dół, aby wybrać sąsiadujące ślady.
Obserwuj informacje śledzenia w okienku śledzenia i okienku szczegółów.
Rozszerzanie lub zwijanie transferów działań
Możesz rozwinąć transfery działań, gdy działanie w zaznaczeniu zostanie przeniesione do innego działania. Umożliwia śledzenie transferów.
Aby rozwinąć lub zwinąć transfery działań,
Znajdź ślad transferu z podpisem "+" po lewej stronie ikony transferu.
Kliknij przycisk "+" lub naciśnij klawisze Ctrl i "+" przy użyciu klawiatury.
Następne działanie zostanie wyświetlone na wykresie.
Po lewej stronie ikony transferu zostanie wyświetlony element "-". Kliknij znak "-" lub naciśnij klawisze Ctrl i "-", a transfer działań zwija się.
Uwaga
Gdy działanie ma wiele transferów do niego i rozwijasz jeden z transferów, wyświetlane są działania prowadzące do nowego działania z działania głównego. Te nowe działania pojawiają się w zwiniętym formularzu. Jeśli chcesz wyświetlić szczegóły tych działań, rozwiń je w pionie, klikając ikonę rozwijania w nagłówku grafu.
Rozwijanie lub zwijanie działań w pionie
Przeglądarka ukrywa niepotrzebne szczegóły na wykresie działań przez zwijanie działań. W zwiniętym działaniu poszczególne ślady nie są wyświetlane. Wyświetlane są tylko dane śledzenia transferów. Jeśli chcesz wyświetlić wszystkie ślady w działaniu, rozwiń działanie w pionie, klikając symbol rozwijania działania w nagłówku grafu.
Aby rozwinąć lub zwinąć działania w pionie,
Kliknij ikonę "+" w nagłówku działania, aby rozwinąć działanie w pionie.
Zwróć uwagę, że wszystkie ślady są wyświetlane na wykresie.
Kliknij ikonę "-" w nagłówku działania, aby zwinąć działanie w pionie.
Zwróć uwagę, że w działaniu są wyświetlane tylko ważne transfery, dzienniki komunikatów, ślady ostrzeżeń i wyjątków.
Opcje
W menu Opcja w widoku programu Graph możesz wybrać dwie opcje.
Pokaż ślady granic działania, które po niezaznaczonej opcji ignorują ślady granic działań na wykresie.
Pokaż ślady niezwiązane z komunikatami, które w przypadku niezaznaczonego ignorują pełne ślady na poziomie, z wyjątkiem śladów komunikatów. W większości przypadków pełne ślady na poziomie są mniej ważne do analizy. Ta opcja jest przydatna, gdy nie chcesz analizować pełnych śladów na poziomie i chcesz skupić się tylko na ważniejszych śladach.
Tryb układu
Przeglądarka ma dwa tryby układu: Proces i Wątek. To ustawienie definiuje największą jednostkę organizacji. Domyślny tryb układu to Proces, co oznacza, że działania są pogrupowane według procesów na grafie.
Lista wykonywania
Możesz wybrać proces lub wątek, który ma być wyświetlany na wykresie z tej listy rozwijanej. Jeśli na przykład masz pliki śledzenia dwóch klientów (A i B) i jedną otwartą usługę, a chcesz wyświetlić usługę i klienta A na wykresie, możesz usunąć zaznaczenie klienta B z listy.
Wyświetlanie szczegółów śledzenia
Aby wyświetlić szczegóły śledzenia, wybierz ślad w okienku Śledzenie. Szczegóły są wyświetlane w okienku Szczegóły.
Okienko śledzenia
Prawe górne okienko w Podglądzie śledzenia usługi to okienko śledzenia. Wyświetla listę wszystkich śladów w wybranym działaniu z dodatkowymi informacjami, na przykład poziom śledzenia, identyfikator wątku i nazwę procesu.
Pierwotny kod XML śledzenia można skopiować do schowka, klikając prawym przyciskiem myszy ślad i wybierając polecenie Kopiuj ślad do Schowka.
Okienko szczegółów
Lewym dolnym okienku w Podglądzie śledzenia usługi jest okienko szczegółów. Udostępnia trzy karty do wyświetlania szczegółów śledzenia.
Widok Sformatowany wyświetla informacje w bardziej zorganizowany sposób. Zawiera listę wszystkich znanych elementów XML w tabelach i drzewach, co ułatwia odczytywanie i interpretowanie informacji.
Widok XML wyświetla kod XML odpowiadający wybranemu śladowi. Obsługuje wyróżnianie i kolor składni. Gdy używasz funkcji Znajdź do wyszukiwania ciągów, wyróżnia wyniki wyszukiwania.
Widok Komunikat wyświetla część komunikatu XML w śladach dziennika komunikatów. Jest niewidoczny po wybraniu śladu innego niż komunikat.
Filtrowanie śladów programu WCF
Aby ułatwić analizę śledzenia, można je filtrować w następujący sposób:
Pasek narzędzi filtru zapewnia dostęp do wstępnie zdefiniowanych i niestandardowych filtrów. Można ją włączyć za pomocą menu Widok .
Wstępnie zdefiniowany filtr przeglądarki może służyć do selektywnego filtrowania części śladów programu WCF. Domyślnie jest ona ustawiona tak, aby zezwalać na przekazywanie wszystkich śladów infrastruktury. Ustawienia tego filtru są zdefiniowane w menu podrzędnym Opcje filtru w menu Widok.
Niestandardowe filtry XPath zapewniają użytkownikom pełną kontrolę nad filtrowaniem. Można je zdefiniować w filtrze niestandardowym w menu Widok.
Wyświetlane są tylko ślady przechodzące przez wszystkie filtry.
Korzystanie z paska narzędzi filtru
Pasek narzędzi filtru jest wyświetlany w górnej części narzędzia. Jeśli nie jest obecny, możesz go aktywować w menu Widok . Pasek ma trzy składniki:
Wyszukaj: Wyszukaj , aby zdefiniować temat do wyszukania w operacji filtrowania. Jeśli na przykład chcesz znaleźć wszystkie ślady, które zostały wyemitowane w kontekście procesu X, ustaw to pole na X, a pole Wyszukaj w polu na "Nazwa procesu". To pole zmienia się na kontrolkę selektora DateTime po wybraniu filtru opartego na czasie.
Wyszukiwanie w: to pole definiuje typ filtru do zastosowania.
Poziom: ustawienie poziomu definiuje minimalny poziom śledzenia dozwolony przez filtr. Jeśli na przykład poziom jest ustawiony na Wartość Błąd i W górę, wyświetlane są tylko ślady na poziomie Błędy i krytyczne. Ten filtr łączy się z kryteriami określonymi przez wyszukiwanie i wyszukiwanie w.
Przycisk Filtruj teraz uruchamia operację filtrowania. Niektóre filtry, szczególnie w przypadku zastosowania ich do dużego zestawu danych, trwają długo. Możesz anulować operację filtrowania, naciskając przycisk Zatrzymaj wyświetlany na pasku stanu w menu Operacje .
Przycisk Wyczyść resetuje wstępnie zdefiniowane i niestandardowe filtry, aby umożliwić przekazywanie wszystkich śladów.
Opcje filtru
Przeglądarka może automatycznie usuwać ślady programu WCF z widoku. Może selektywnie usuwać ślady emitowane przez określone obszary programu WCF, na przykład usuwając ślady powiązane z transakcjami z widoku.
Ustawienia tego filtru są zdefiniowane w menu podrzędnym Opcje filtru w menu Widok.
Filtry niestandardowe
Jeśli znasz język ścieżki XML (XPath), możesz użyć go do konstruowania filtrów niestandardowych w celu wyszukania danych śledzenia dla dowolnego interesującego elementu XML. Filtry są dostępne za pośrednictwem paska narzędzi filtru.
Filtry niestandardowe mogą zawierać parametry. Możesz również zaimportować istniejące filtry niestandardowe.
Tworzenie filtru niestandardowego
Filtry można tworzyć na dwa sposoby:
Tworzenie filtru niestandardowego przy użyciu Kreatora szablonów
Możesz kliknąć istniejący ślad i utworzyć filtr na podstawie struktury śledzenia. W tym przykładzie tworzony jest niestandardowy filtr na podstawie identyfikatora wątku.
W okienku śledzenia w prawym górnym obszarze przeglądarki wybierz ślad zawierający element, dla którego chcesz filtrować.
Kliknij przycisk Utwórz filtr niestandardowy znajdujący się w górnej części okienka śledzenia.
W wyświetlonym oknie dialogowym wprowadź nazwę filtru. W tym przykładzie wprowadź .
Thread IDMożesz również podać opis filtru.Widok drzewa po lewej stronie wyświetla strukturę rekordu śledzenia wybranego w kroku 1. Przejdź do elementu, dla którego chcesz utworzyć warunek. W tym przykładzie przejdź do identyfikatora ThreadID, aby znajdować się w węźle XPath: /E2ETraceEvent/System/Execution/@ThreadID. Kliknij dwukrotnie atrybut ThreadID w widoku drzewa. Spowoduje to utworzenie wyrażenia dla atrybutu po prawej stronie okna dialogowego.
Zmień pole parametru warunku ThreadID z None na "{0}". Ten krok umożliwia skonfigurowanie wartości ThreadID podczas stosowania filtru. (Zobacz sekcję Jak zastosować filtr) Można zdefiniować maksymalnie cztery parametry. Warunki są łączone przy użyciu operatora OR.
Kliknij przycisk OK , aby utworzyć filtr.
Uwaga
Po utworzeniu filtru przy użyciu kreatora szablonu można go edytować tylko ręcznie. Nie można aktywować kreatora dla utworzonego wcześniej filtru. Ponadto warunki filtru XPath utworzonego w kreatorze szablonu są łączone przy użyciu operatora OR. Jeśli potrzebujesz operacji AND, możesz edytować wyrażenie filtru po jego utworzeniu.
Ręczne tworzenie filtru niestandardowego
Menu Filtry niestandardowe umożliwia ręczne wprowadzanie filtrów XPath.
W menu Widok kliknij element menu Filtry niestandardowe.
W wyświetlonym oknie dialogowym kliknij pozycję Nowy.
Określ co najmniej nazwę filtru i wyrażenie XPath.
Kliknij przycisk OK.
Stosowanie filtru niestandardowego
Po utworzeniu filtru niestandardowego jest dostępny za pomocą paska narzędzi filtru. Wybierz filtr, który chcesz zastosować w polu Wyszukaj na pasku narzędzi filtru. W poprzednim przykładzie wybierz pozycję "Identyfikator wątku".
Określ wartość, której szukasz w polu Znajdź co . W naszym przykładzie wprowadź identyfikator wątku, którego chcesz wyszukać.
Kliknij pozycję Filtruj teraz i obserwuj wynik operacji.
Jeśli filtr używa wielu parametrów, wprowadź je przy użyciu ciągu ";" jako separatora w polu Znajdź co . Na przykład następujący ciąg definiuje 3 parametry: "1; Findvalue; tekst". Przeglądarka stosuje wartość "1" do {0} parametru filtru. Wartości "findValue" i "text" są stosowane odpowiednio do {1} elementów i {2} .
Udostępnianie filtrów niestandardowych
Filtry niestandardowe mogą być udostępniane między różnymi sesjami i różnymi użytkownikami. Filtry można wyeksportować do pliku definicji i zaimportować ten plik w innej lokalizacji.
Aby zaimportować filtr niestandardowy:
W menu Widok kliknij pozycję Filtry niestandardowe.
W wyświetlonym oknie dialogowym kliknij przycisk Importuj.
Przejdź do niestandardowego pliku filtru (stvcf), kliknij plik i kliknij przycisk Otwórz .
Aby wyeksportować filtr niestandardowy:
W menu Widok kliknij pozycję Filtry niestandardowe.
W wyświetlonym oknie dialogowym wybierz filtr, który chcesz wyeksportować.
Kliknij przycisk Eksportuj.
Określ nazwę i lokalizację pliku definicji filtru niestandardowego (stvcf), a następnie kliknij przycisk Zapisz .
Uwaga
Te filtry niestandardowe można importować i eksportować tylko z podglądu śledzenia usługi. Nie można ich odczytać za pomocą innych narzędzi.
Znajdowanie danych
Przeglądarka udostępnia następujące sposoby znajdowania danych:
Pasek narzędzi Znajdź zapewnia szybki dostęp do najbardziej typowych opcji znajdowania.
Okno dialogowe Znajdowanie zawiera więcej opcji znajdowania. Jest dostępny za pośrednictwem menu Edycja lub za pomocą krótkiego klawisza Ctrl + F.
Pasek narzędzi znajdowania jest wyświetlany w górnej części przeglądarki. Jeśli nie jest obecny, możesz go aktywować w menu Widok . Pasek ma dwa składniki:
Znajdź, co: umożliwia wprowadzanie słowa kluczowego wyszukiwania.
Szukaj w: umożliwia wprowadzenie zakresu wyszukiwania. Możesz wybrać, czy wyszukiwać we wszystkich działaniach, czy tylko w bieżącym działaniu.
Okno dialogowe znajdowania zawiera dwie dodatkowe opcje:
Znajdź element docelowy:
Opcja "Nieprzetworzone dane dziennika" wyszukuje słowo kluczowe we wszystkich danych pierwotnych.
Opcje "Tekst XML" i "Atrybut XML" wyszukują tylko w elementach XML.
Opcja "Zarejestrowana wiadomość" wyszukuje słowo kluczowe tylko w komunikatach.
Ignoruj działanie główne: wyszukiwanie ignoruje ślady w działaniu "000000000000". Zwiększa to wydajność w dużych plikach śledzenia, gdy aktywność główna ma tysiące śladów, z których większość jest transferowane.
Nawigowanie po śladach
Ze względu na to, że ślady są rejestrowane krok po kroku podczas wykonywania aplikacji, nawigowanie po śladach może pomóc w debugowaniu aplikacji. Przeglądarka śledzenia usługi udostępnia różne sposoby nawigowania w śladach.
Krok do przodu lub do tyłu
Jeśli każdy ślad zostanie uznany za wiersz kodu w programie, krok naprzód jest bardzo podobny do "Krok do przodu" w zintegrowanym środowisku projektowym (IDE) programu Visual Studio. Różnica polega na tym, że można również przejść do tyłu w śladach. Krok do przodu oznacza przejście do następnego śledzenia w działaniu.
Krok naprzód: użyj menu Działanie lub naciśnij klawisz "F10". Możesz również użyć klawisza strzałki "w dół" w okienku śledzenia.
Krok do tyłu : użyj menu Działanie lub naciśnij klawisz "F9". Możesz również użyć klawisza strzałki "w górę" w okienku śledzenia.
Uwaga
Może to prowadzić do działania występującego w innym procesie, a nawet na innym komputerze, ponieważ komunikaty programu WCF mogą przenosić identyfikatory działań obejmujące maszyny.
Obserwowanie transferu
Ślady transferu są specjalnymi śladami w pliku śledzenia. Działanie może zostać przeniesione do innego działania za pomocą śledzenia transferu. Na przykład "Działanie A" może zostać przeniesione do "Działanie B". W takim przypadku w obszarze "Działanie A" znajduje się ślad transferu o nazwie "Do: Działanie" i ikona transferu. Ten ślad transferu jest połączeniem między dwoma śladami. W obszarze "Działanie B" na końcu działania może być również ślad transferu, który ma zostać przeniesiony z powrotem do "Działania A". Jest to podobne do wywołań funkcji w programach: wywołania B, a następnie B zwraca.
"Obserwuj transfer" jest podobny do "Krok do" w debugerze. Następuje przeniesienie z A do B. Nie ma żadnego wpływu na inne ślady.
Istnieją dwa sposoby przesyłania: myszą lub klawiaturą:
Według myszy: kliknij dwukrotnie ślad transferu w okienku śledzenia.
Za pomocą klawiatury: wybierz ślad transferu i użyj polecenia "Obserwuj transfer" w menu Działanie lub naciśnij klawisz "F11"
Uwaga
W wielu przypadkach, gdy działanie A przenosi się do działania B, działanie A czeka, aż działanie B przeniesie się z powrotem do działania A. Oznacza to, że działanie A nie ma zarejestrowanego śladu w okresie, gdy działanie B jest aktywnie śledzone. Istnieje jednak również możliwość, że działanie A nie czeka i kontynuuje rejestrowanie śladów. Istnieje również możliwość, że działanie B nie jest przenoszone z powrotem do działania A. W związku z tym transfery działań są nadal inne niż wywołania funkcji w tym sensie. Możesz lepiej zrozumieć transfery działań w widoku programu Graph.
Przejdź do następnego lub poprzedniego transferu
Podczas analizowania bieżącego działania lub wybranych działań po wybraniu wielu działań możesz szybko znaleźć działania, do których są one transferowane. Opcja "Przeskocz do następnego transferu" umożliwia zlokalizowanie następnego śledzenia transferu w działaniu. Po znalezieniu śledzenia transferu możesz użyć polecenia "Obserwuj transfer", aby przejść do następnego działania.
Przejdź do następnego transferu: użyj menu Działanie lub naciśnij klawisze "Ctrl + F10".
Przejdź do poprzedniego transferu: użyj menu Działanie lub naciśnij klawisze "Ctrl + F9".
Nawigowanie w widoku programu Graph
Mimo że nawigowanie w okienku działań i okienku śledzenia jest podobne do debugowania, użycie widoku programu Graph zapewnia znacznie lepsze środowisko nawigacji. Aby uzyskać więcej informacji, zobacz sekcję "Widok grafu".
Ładowanie dużych plików śledzenia
Pliki śledzenia mogą być bardzo duże. Jeśli na przykład włączysz śledzenie na poziomie "Pełne", wynikowy plik śledzenia na kilka minut może być łatwy do uruchomienia setek megabajtów lub nawet większych, w zależności od szybkości sieci i wzorca komunikacji.
Po otwarciu bardzo dużego pliku śledzenia w podglądzie śledzenia usługi wydajność systemu może mieć negatywny wpływ. Szybkość ładowania i czas odpowiedzi po załadowaniu mogą być powolne. Rzeczywista szybkość różni się od czasu do czasu, w zależności od konfiguracji sprzętu. W większości komputerów ładowanie pliku śledzenia większego niż 200 mln ma poważny wpływ na wydajność. W przypadku plików śledzenia większych niż 1G narzędzie może używać całej dostępnej pamięci lub przestać odpowiadać przez bardzo długi czas.
Aby uniknąć powolnego ładowania i czasu odpowiedzi podczas analizowania dużych plików śledzenia, przeglądarka śledzenia usługi udostępnia funkcję o nazwie "Częściowe ładowanie", która ładuje tylko niewielką część śledzenia naraz. Na przykład może istnieć plik śledzenia o rozmiarze ponad 1 GB uruchomiony przez kilka dni na serwerze. Jeśli wystąpiły pewne błędy i chcesz przeanalizować ślad, nie trzeba otwierać całego pliku śledzenia. Zamiast tego można załadować ślady w określonym przedziale czasu, kiedy mógł wystąpić błąd. Ponieważ zakres jest mniejszy, narzędzie Service Trace Viewer może ładować plik szybciej i można zidentyfikować błędy przy użyciu mniejszego zestawu danych.
Włączanie ładowania częściowego
Nie trzeba ręcznie włączać ładowania częściowego. Jeśli łączny rozmiar plików śledzenia, które próbujesz załadować, przekracza 40 MB, przeglądarka śledzenia usługi automatycznie wyświetla okno dialogowe Częściowe ładowanie, aby wybrać część, którą chcesz załadować.
Uwaga
Ponieważ ślady mogą nie być dystrybuowane równomiernie w przedziale czasu, długość okresu określonego na pasku narzędzi Częściowe ładowanie może nie być proporcjonalna do pokazanego rozmiaru ładowania. Rzeczywisty rozmiar ładowania może być mniejszy niż szacowany rozmiar w oknie dialogowym częściowego ładowania.
Dostosowywanie częściowego ładowania
Po częściowym załadowaniu pliku śledzenia możesz zmienić ładowany zestaw danych. Można to zrobić, dostosowując pasek narzędzi Częściowe ładowanie w górnej części przeglądarki.
Przenieś pasek narzędzi za pomocą myszy lub wprowadź godzinę rozpoczęcia i zakończenia.
Kliknij przycisk Dostosuj.
Opis ikon śledzenia
Poniżej znajduje się lista ikon używanych przez narzędzie Podgląd śledzenia usługi w widoku działania , widoku programu Graph i okienku Ślad do reprezentowania różnych elementów.
Uwaga
Niektóre ślady, które nie są kategoryzowane (na przykład "komunikat jest zamknięty") nie mają ikony.
Ślady śledzenia aktywności
| Icon | opis |
|---|---|
 |
Ślad ostrzeżenia: ślad emitowany na poziomie ostrzeżenia |
 |
Ślad błędu: ślad emitowany na poziomie błędu. |
 |
Ślad rozpoczęcia działania: ślad, który oznacza początek działania. Zawiera nazwę działania. Jako projektant aplikacji lub deweloper należy zdefiniować jedno działanie Rozpocznij śledzenie na identyfikator działania na proces lub wątek. Jeśli identyfikator działania jest propagowany między źródłami śledzenia na potrzeby korelacji śledzenia, można zobaczyć wiele uruchomień dla tego samego identyfikatora działania (jeden na źródło śledzenia). Ślad rozpoczęcia jest emitowany, jeśli dla źródła śledzenia włączono funkcję ActivityTracing. |
 |
Śledzenie zatrzymania działania: ślad, który oznacza koniec działania. . Zawiera nazwę działania. Jako projektant aplikacji lub deweloper należy zdefiniować jedno działanie Zatrzymaj śledzenie na identyfikator działania dla źródła śledzenia. Żadne ślady z danego źródła śledzenia nie są wyświetlane po działaniu Zatrzymaj emitowane przez to źródło śledzenia, z wyjątkiem sytuacji, gdy stopień szczegółowości czasu śledzenia nie jest wystarczająco mały. W takim przypadku dwa ślady z tym samym czasem, w tym zatrzymanie, mogą być przeplatane po wyświetleniu. Jeśli identyfikator działania jest propagowany między źródłami śledzenia w celu korelacji śledzenia, można zobaczyć wiele zatrzymań dla tego samego identyfikatora działania (jeden na źródło śledzenia). Ślad zatrzymania jest emitowany, jeśli dla źródła śledzenia włączono funkcję ActivityTracing. |
 |
Śledzenie wstrzymania działania: ślad, który oznacza czas wstrzymania działania. Żadne ślady nie są emitowane w wstrzymanym działaniu do momentu wznowienia działania. Wstrzymane działanie oznacza, że żadne przetwarzanie nie odbywa się w tym działaniu w zakresie źródła śledzenia. Śledzenie wstrzymania/wznawiania jest przydatne do profilowania. Ślad wstrzymania jest emitowany, jeśli funkcja ActivityTracing jest włączona dla źródła śledzenia. |
 |
Śledzenie wznawiania działania: ślad, który oznacza czas wznowienia działania po jego zawieszeniu. Ślady mogą być ponownie emitowane w tym działaniu. Śledzenie wstrzymania/wznawiania jest przydatne do profilowania. Ślad wznawiania jest emitowany, jeśli element ActivityTracing jest włączony dla źródła śledzenia. |
 |
Transfer: ślad emitowany, gdy przepływ sterowania logicznego jest przesyłany z jednego działania do innego. Działanie, z którego pochodzi transfer, może kontynuować pracę równolegle z działaniem, do którego przechodzi transfer. Ślad transferu jest emitowany, jeśli dla źródła śledzenia jest włączona funkcja ActivityTracing. |
 |
Transfer Z: ślad definiujący transfer z innego działania do bieżącego działania. |
 |
Transfer do: ślad definiujący transfer przepływu logicznego sterowania z bieżącego działania do innego działania. |
Ślady programu WCF
| Icon | opis |
|---|---|
 |
Śledzenie dziennika komunikatów: ślad emitowany po zarejestrowaniu komunikatu WCF przez funkcję rejestrowania komunikatów po włączeniu System.ServiceModel.MessageLogging źródła śledzenia. Kliknięcie tego śladu powoduje wyświetlenie komunikatu. Istnieją cztery konfigurowalne punkty rejestrowania dla komunikatu: ServiceLevelSendRequest, TransportSend, TransportReceive i ServiceLevelReceiveRequest, który można również określić przez messageSource atrybut w śladzie dziennika komunikatów. |
 |
Ślad odebrany komunikatu: ślad emitowany po odebraniu komunikatu programu WCF, jeśli System.ServiceModel źródło śledzenia jest włączone na poziomie Informacje lub Pełne. Ten ślad jest niezbędny do wyświetlenia strzałki korelacji komunikatów w widoku wykresu działania. |
 |
Śledzenie wysłanego komunikatu: ślad emitowany podczas wysyłania komunikatu WCF, jeśli System.ServiceModel źródło śledzenia jest włączone na poziomie Informacje lub Pełne. Ten ślad jest niezbędny do wyświetlenia strzałki korelacji komunikatów w widoku wykresu działania. |
Działania
| Icon | opis |
|---|---|
 |
Działanie: wskazuje, że bieżące działanie jest działaniem ogólnym. |
 |
Działanie główne: wskazuje działanie główne procesu. |
Działania programu WCF
| Icon | opis |
|---|---|
 |
Działanie środowiska: działanie, które tworzy, otwiera lub zamyka hosta lub klienta WCF. W tym działaniu pojawią się błędy, które wystąpiły w tych fazach. |
 |
Działanie nasłuchiwania: działanie, które rejestruje ślady związane z odbiornikiem. Wewnątrz tego działania możemy wyświetlić informacje o odbiorniku i żądania połączenia. |
 |
Działanie odbierania bajtów: działanie, które grupuje wszystkie ślady związane z odbieraniem bajtów przychodzących w połączeniu między dwoma punktami końcowymi. To działanie jest niezbędne w korelacji z działaniami transportu, które propagują identyfikator działania, takie jak http.sys. błędy Połączenie ion, takie jak przerwania, będą wyświetlane w tym działaniu. |
 |
Działanie komunikatu procesu: działanie, które grupuje ślady związane z tworzeniem komunikatu WCF. Błędy spowodowane złą kopertą lub źle sformułowanym komunikatem pojawi się w tym działaniu. Wewnątrz tego działania możemy sprawdzić nagłówki komunikatów, aby sprawdzić, czy identyfikator działania został rozpropagowany z obiektu wywołującego. Jeśli jest to prawda, gdy przeniesiemy do działania akcji procesu (następna ikona), możemy również przypisać do tego działania identyfikator propagowanego działania w celu korelacji między obiektem wywołującym i wywołaniem śladów. |
|
Działanie akcji procesu: działanie, które grupuje wszystkie ślady związane z żądaniem WCF w dwóch punktach końcowych. Jeśli propagateActivity dla obu punktów końcowych w konfiguracji ustawiono true wartość , wszystkie ślady z obu punktów końcowych są scalane w jedno działanie w celu bezpośredniej korelacji. Takie działanie będzie zawierać błędy spowodowane transportem lub przetwarzaniem zabezpieczeń, rozszerzając granicę kodu użytkownika i z powrotem (jeśli istnieje odpowiedź). |
|
Działanie Wykonaj kod użytkownika: działanie, które grupuje ślady kodu użytkownika na potrzeby przetwarzania żądania. |
Rozwiązywanie problemów
Jeśli nie masz uprawnień do zapisu w rejestrze, podczas rejestrowania narzędzia zostanie wyświetlony następujący komunikat o błędzie "Przeglądarka śledzenia usługi firmy Microsoft nie została zarejestrowana w systemie" przy użyciu polecenia "svctraceviewer /register". W takim przypadku należy zalogować się przy użyciu konta, które ma dostęp do zapisu w rejestrze.
Ponadto narzędzie Podgląd śledzenia usługi zapisuje niektóre ustawienia (na przykład niestandardowe filtry i opcje filtru) do pliku SvcTraceViewer.exe.settings w folderze zestawu. Jeśli nie masz uprawnień do odczytu dla pliku, nadal możesz uruchomić narzędzie, ale nie możesz załadować ustawień.
Jeśli podczas otwierania pliku etl zostanie wyświetlony komunikat o błędzie "Wystąpił nieznany błąd podczas przetwarzania co najmniej jednego śladu", oznacza to, że format pliku etl jest nieprawidłowy.
Jeśli otworzysz dziennik śledzenia utworzony przy użyciu arabskiego systemu operacyjnego, możesz zauważyć, że filtr czasu nie działa. Na przykład rok 2005 odpowiada rokowi 1427 w kalendarzu arabskim. Jednak zakres czasu obsługiwany przez filtr narzędzia Podgląd śledzenia usługi nie obsługuje daty wcześniejszej niż 1752. Może to oznaczać, że nie możesz wybrać prawidłowej daty w filtrze. Aby rozwiązać ten problem, możesz utworzyć filtr niestandardowy (Wyświetl/Filtry niestandardowe) przy użyciu wyrażenia XPath w celu uwzględnienia określonego zakresu czasu.