Pojęcia dotyczące elementu TraceView

W tym temacie opisano pojęcia, które są używane w usłudze TraceView.

Aby uzyskać informacje na temat pojęć, które są wspólne dla narzędzi śledzenia w zestawie WDK, zobacz Pojęcia dotyczące narzędzi do śledzenia.

Grupa sesji śledzenia

Funkcja TraceView umożliwia łączenie wyświetlania dzienników śledzenia lub sesji śledzenia w czasie rzeczywistym w grupę sesji śledzenia i zarządzanie nimi tak, jakby były one pojedynczą sesją. Gdy dzienniki śledzenia lub sesje znajdują się w tej samej grupie sesji śledzenia, ich komunikaty są łączone na jednej liście komunikatów śledzenia.

Domyślnie każda sesja śledzenia jest członkiem grupy sesji śledzenia, która składa się tylko z tej sesji śledzenia.

Aby uzyskać informacje na temat tworzenia grup sesji śledzenia, zobacz Grupowanie sesji śledzenia.

Obszar roboczy

W usłudze TraceView obszar roboczy to zestaw właściwości sesji śledzenia i właściwości wyświetlania dziennika śledzenia, które można zapisywać i używać ponownie. W przypadku obszarów roboczych można wyświetlić często używany dziennik lub rozpocząć starannie skonfigurowaną sesję śledzenia w jednym szybkim kroku.

Obszar roboczy obejmuje:

• Wszystkie właściwości sesji śledzenia, w tym bufory, flagi, poziom oraz lokalizacja dziennika śledzenia

• Lokalizacja pliku symboli bazy danych programu (PDB),pliku formatu komunikatu śledzenia (TMF) lub ścieżki wyszukiwania TMF

• Ścieżka i nazwy plików pliku listy TraceView i pliku podsumowania

• Filtry

Po otwarciu obszaru roboczego dla sesji śledzenia w czasie rzeczywistym funkcja TraceView uruchamia nową sesję śledzenia z zapisanymi właściwościami i ustawieniami konfiguracji. Po otwarciu obszaru roboczego na potrzeby wyświetlania dziennika śledzenia dziennik jest wyświetlany dokładnie tak, jak został skonfigurowany.

Aby uzyskać więcej informacji, zobacz Using TraceView Workspaces (Używanie obszarów roboczych TraceView).

Określanie dostawców śledzenia

Aby utworzyć sesję śledzenia, należy zidentyfikować dostawców śledzenia i zlokalizować instrukcje formatowania dla binarnych komunikatów śledzenia generowanych przez dostawców. Możesz to zrobić na jeden z następujących sposobów:

• Znajdź plik wykonywalny dla kodu źródłowego związanego z dostawcami. Element TraceView może wyodrębnić wszystkie informacje niezbędne do włączenia i sformatowania funkcji TraceLogging oraz manifestowanych zdarzeń ETW. Podejmie również próbę zlokalizowania pliku symboli PDB, aby umożliwić działanie jakimkolwiek dostawcom śledzenia oprogramowania WPP.

• Znajdź plik symboli PDB dla kodu źródłowego zawierającego śledzenie oprogramowania WPP dostawców. Element TraceView może wyodrębnić z pliku PDB wszystkie informacje potrzebne do zidentyfikowania dostawców i sformatować komunikaty śledzenia.

• Znajdź plik GUID (ctl) kontrolki dla dostawcy i określ plik TMF lub podaj ścieżkę do katalogu, w którym przechowywane są pliki TMF.

• Wprowadź GUID kontrolny dostawcy i określ plik TMF lub ścieżkę do katalogu, w którym są przechowywane pliki TMF.

  Jeśli wprowadzisz nazwę dostawcy poprzedzoną gwiazdką (np. *SampleProvider), funkcja TraceView automatycznie przekształci nazwę w identyfikator GUID przy użyciu standardowego algorytmu. Nie wszyscy dostawcy przestrzegają tego standardu, ale wielu, takich jak dostawcy napisani przy użyciu klasy EventSource platformy .NET, robią to.

• Wybierz zarejestrowanego dostawcę z listy zestawów TraceView i określ plik TMF lub ścieżkę do katalogu, w którym są przechowywane pliki TMF.

• Wybierz sesję śledzenia rejestratora jądra NT, a następnie wybierz co najmniej jedno zdarzenie systemu operacyjnego do śledzenia.

Ustaw ścieżkę wyszukiwania TMF i wybierz opcje plików TMF

Podczas włączania dostawców WPP, chyba że masz plik symboli PDB dla dostawcy, należy określić katalog, w którym TraceView może znaleźć pliki TMF lub musi zlokalizować pliki TMF dla komunikatów śledzenia dostawcy.

Element TraceView obsługuje dwie metody:

• Użyj opcji Ustaw ścieżkę wyszukiwania TMF , jeśli nie masz pewności, które pliki TMF mają być używane dla dostawcy śledzenia. TraceView przeszukuje wszystkie pliki TMF w określonym katalogu i dopasowuje identyfikator GUID wygenerowanego komunikatu do nazwy pliku TMF. Pliki TMF muszą znajdować się w określonym katalogu. Funkcja TraceView nie wyszukuje rekursywnie.

• Użyj opcji Wybierz pliki TMF , jeśli wiesz, który plik TMF do użycia dla dostawcy śledzenia lub gdy potrzebne pliki TMF znajdują się w różnych katalogach. Należy również użyć tej opcji, jeśli nazwa pliku TMF nie jest identyfikatorem GUID komunikatu, ponieważ program TraceView nie może go znaleźć w katalogu.

Jeśli określone pliki TMF lub te znalezione przez TraceView w określonym katalogu nie są zgodne z komunikatami śledzenia generowanymi przez dostawcę śledzenia, TraceView nie może sformatować komunikatów. Zamiast tego wyświetla identyfikator GUID komunikatu śledzenia i następujący komunikat o błędzie:

No Format Information found.

Aby utworzyć pliki TMF na podstawie pliku symboli PDB, w oknie wiersza polecenia użyj narzędzia Tracepdb.