Debugowanie aplikacji poprzez pliki dziennika IntelliTrace (.iTrace)

Artykuł
02/27/2013

Można uruchomić sesję debugowania IntelliTrace bezpośrednio z pliku dziennika IntelliTrace (.iTrace).Ten plik zawiera wyjątki, żądania sieci Web, wątki, kroki testowe, moduły i inne informacje systemowe, które zostały zarejestrowane przez IntelliTrace podczas pracy Twojej aplikacji.

Zobacz, jak działa IntelliTrace:

Zbieranie i analizowanie danych IntelliTrace w przypadku debugowania (wideo Channel 9)
Programowanie, testowania i debugowania produkcji na potrzeby programu SharePoint (wideo Channel 9)

Wymagania

Plik .iTrace z jednego z następujących źródeł:
- Sesja IntelliTrace w Visual Studio Ultimate.Zobacz Rejestrowanie wykonywania kodu za pomocą narzędzia IntelliTrace na potrzeby debugowania w programie Visual Studio.
- Sesja testowa w Menedżerze testów firmy Microsoft.Dołącza plik .iTrace do elementu roboczego programu Team Foundation Server.Zobacz Jak: zbieranie danych IntelliTrace problemy, trudne debugowania.
- Autonomiczny moduł zbierający dla aplikacji działających poza programem Visual Studio.Zobacz Zbieranie danych IntelliTrace poza programem Visual Studio za pomocą modułu Standalone Collector.
- Visual Studio 2012.1: Aplikacje monitorowane przez System Center 2012 Service Pack 1 (SP1) - Operations Manager zawierający IntelliTrace Profiling Management Pack.Zob. Sposoby konfigurowania integracji za pomocą IntelliTrace w programie System Center 2012.
Visual Studio Ultimate na komputerze deweloperskim lub innym komputerze, aby otworzyć pliki .iTrace

[!UWAGA]

Aby debugować IntelliTrace i przejść przez kod, musisz mieć pasujące pliki źródłowe i pliki z symbolami.Upewnij się, że pliki symbol znajdują się w ścieżce symbol Visual Studio.W przeciwnym razie program Visual Studio nie może rozpoznać lokalizacji źródłowych i wyświetla komunikat „Nie można odnaleźć symboli”. Zobacz Wyszukiwanie plików symboli (.pdb) oraz plików źródłowych i binarnych.

Co chcesz zrobić?

Otwórz plik dziennika IntelliTrace
Odczytaj plik dziennika IntelliTrace
Rozpocznij debugowanie z pliku dziennika IntelliTrace

Otwórz plik dziennika IntelliTrace

Otwórz plik .iTrace na komputerze za pomocą programu Visual Studio Ultimate.

Kliknij dwukrotnie plik .iTrace, poza Visual Studio, lub otworzyć plik z programie Visual Studio.

- lub -
Jeśli plik .iTrace jest dołączony do elementu pracy programu Team Foundation Server, wykonaj następujące kroki w elemencie pracy:
- W opcji Wszystkie łącza znajdź plik .iTrace.Otwórz go.
  
  - lub -
- W opcji Kroki odtwarzania wybierz łącze IntelliTrace.

Porada
Jeśli plik .iTrace został zamknięty podczas debugowania, możesz łatwo go ponownie otworzyć.Przejdź do Debuguj wybierz opcję IntelliTrace, Pokaż podsumowanie dziennika.Możesz także wybrać Pokaż podsumowanie dziennika w oknie IntelliTrace.Jest to dostępne tylko podczas debugowania za pomocą IntelliTrace.

Odczytaj plik dziennika IntelliTrace

Niektóre z poniższych sekcji w pliku .iTrace są wyświetlane tylko wtedy, gdy zostały zebrane dane z konkretnego źródła, na przykład z aplikacji Test Manager lub SharePoint 2010 z autonomicznym modułem zbierającym.

Sekcja	Zawiera	Źródło gromadzenia (Visual Studio Ultimate, Menedżer testów, autonomiczny moduł zbierający)
Analiza	Tylko dla aplikacji programu SharePoint 2010.Ta sekcja umożliwia badanie zdarzeń IntelliTrace i SharePoint, takich jak zdarzenia debugera, zdarzenia usługi ULS, wyjątki i inne dane zarejestrowane przez moduł zbierający.	Samodzielny moduł zbierający IntelliTrace dla Visual Studio 2012.1
Lista wątków	Wątki, które uruchomiono podczas procesu kolekcji	Wszystkie źródła
Żądania sieci Web	Żądania sieci Web, które zostały przesłane do puli aplikacji usług IIS.Te dane są podobne do danych zebranych w plikach dziennika usług IIS W3c.	Autonomiczny moduł zbierający: tylko dla aplikacji sieci Web obsługiwanych przez usługi IIS
Dane wyjątku	Wyjątki, które zostały zgłoszone przez aplikację podczas sesji kolekcji, w tym pełny stos wywołania dla każdego wyjątku	Wszystkie źródła
Dane testowe	Etapy testu i ich wyniki z sesji testowej	Menedżer testów
Informacje o systemie	Ustawienia i specyfikacje systemu hosta	Wszystkie źródła
Moduły	Wątki, które wczytano podczas kolekcji	Wszystkie źródła

Rozpocznij debugowanie z pliku dziennika IntelliTrace

W większości sekcji, można przejrzeć zdarzenia lub inne elementy, wybierz element, a następnie wybierz Rozpocznij debugowanie.To powoduje uruchomienie sesji debugowania IntelliTrace w punkcie i w momencie, w którym miało miejsce zdarzenie.

Porada
Aby posortować dane, wybierz nagłówki kolumn.Aby filtrować dane, użyj pola wyszukiwania.Zwykłe wyszukiwanie tekstu działa we wszystkich kolumnach, z wyjątkiem kolumn czasowych.W sekcji Żądania sieci Web możesz także filtrować wyszukiwania do określonej kolumny.

Analiza

Niniejsza sekcja pojawia się w przypadku aplikacji SharePoint 2010 tylko wtedy, gdy dane zostały zarejestrowane przy użyciu modułu zbierającego w programie Visual Studio 2012.1.Zobacz Zbieranie danych IntelliTrace poza programem Visual Studio za pomocą modułu Standalone Collector.

Ta sekcja umożliwia wykonywanie następujących zadań:

Użyj identyfikatora korelacji programu SharePoint, aby znaleźć odpowiadające mu żądania sieci Web i zdarzenia.Możesz wybrać zdarzenie, a następnie rozpocząć debugowanie w punkcie, w którym zdarzenie wystąpiło.
Badanie nieobsługiwanych wyjątków, które znalazł modułu zbierającego.Możesz wybrać wyjątek, a następnie rozpocząć debugowanie w punkcie, w którym wyjątek wystąpił.

[!UWAGA]

Program Visual Studio nie może rozpoznać lokalizacji źródłowych, jeśli wyświetla się komunikat „Nie można odnaleźć symboli”.Upewnij się, że pliki symbol (.pdb) aplikacji znajdują się w ścieżce symbol Visual Studio.Zobacz Wyszukiwanie plików symboli (.pdb) oraz plików źródłowych i binarnych.

Rozpocznij debugowanie z Identyfikatorem korelacji programu SharePoint

Skopiuj identyfikator korelacji SharePoint z jej źródła.

Na przykład:
W pliku .iTrace pod Analizy, można wprowadzić identyfikator korelacji programu SharePointDzięki temu można znaleźć pasujące żądanie i zobaczyć zdarzenia przez nie zarejestrowane.
Używając opcji Żądaj pokazania zdarzeń, zbadaj zdarzenia.Począwszy od góry, zdarzenia są wyświetlane w kolejności ich wystąpienia.
1. Wybierz zdarzenie, aby zobaczyć jego szczegóły.
2. Wybierz polecenie Rozpocznij debugowanie, aby rozpocząć debugowanie w punkcie, w którym wystąpiło zdarzenie.

Możesz wyświetlić zdarzenia programu SharePoint oraz zdarzenia IntelliTrace tego rodzaju:

Zdarzenia profilu użytkownika

Te zdarzenia mają miejsce, gdy program SharePoint ładuje profil użytkownika i gdy właściwości profilu użytkownika są odczytywane lub zmieniane.

Zdarzenia ujednoliconego systemu rejestrowania (ULS)

Autonomiczny moduł zbierający zapisuje podzbiór zdarzeń logu (ULS) programu SharePoint i następujące pola:

Pole IntelliTrace	Pole ULS programu SharePoint
Identyfikator	Identyfikator zdarzenia
Poziom	Poziom
Kategoria Identyfikatora	Kategoria Identyfikatora
Kategoria	Kategoria
Obszar	Produkt
Dane wyjściowe	Wiadomość
Identyfikator korelacji	Identyfikator korelacji

Rozpocznij debugowanie od nieobsłużonego wyjątku

Wybierz identyfikator korelacji programu SharePoint dla wyjątku.Wyjątki są pogrupowane według typów i stosów wywołań.
(Opcjonalnie) Rozwiń węzeł Stos wywołań Aby zobaczyć stos wywołań dla grupy wyjątki.
Wybierz Wyjątek debugowania, aby rozpocząć debugowanie w punkcie, w którym wystąpił wyjątek.

Aby zobaczyć instruktaż, zobacz Wskazówki: debugowanie aplikacji SharePoint przy użyciu narzędzia IntelliTrace.Do tego rodzaju danych, które rejestruje moduł zbierający, zobacz Rejestrowanie wykonywania kodu za pomocą narzędzia IntelliTrace na potrzeby debugowania w programie Visual Studio.

Lista wątków

Ta sekcja pokazuje zarejestrowane wątki, które uruchomiono w procesie docelowym.Możesz uruchomić debugowanie od pierwszego prawidłowego zdarzenia IntelliTrace w wybranym wątku.

Aby rozpocząć debugowanie z określonego wątku

W opcji Lista wątków wybierz wątek.
W dolnej części opcji Lista wątków wybierz Rozpocznij debugowanie.Możesz także dwukrotnie kliknąć na wątek.

Aby rozpocząć debugowanie z miejsca, gdzie rozpoczyna się aplikacja, kliknij dwukrotnie Główny wątek.Zobacz Rejestrowanie wykonywania kodu za pomocą narzędzia IntelliTrace na potrzeby debugowania w programie Visual Studio.

Dane wątku, które tworzy użytkownik, mogą być bardziej przydatne niż wątki, które tworzy i którymi zarządza serwer dla aplikacji sieci Web obsługiwanych przez usługi IIS.

Kolumna	Pokazuje
Identyfikator	Numer identyfikatora wątku
Nazwa	Nazwa wątku.Nienazwane wątki są wyświetlane jako „<Bez nazwy>”.
Godzina rozpoczęcia	Czas utworzenia wątku
Godzina zakończenia	Czas zakończenia wątku

Żądania sieci Web

Ta sekcja pokazuje zarejestrowane żądania sieci Web, które zostały przesłane do puli aplikacji usług IIS.Możesz wybrać żądanie sieci Web, aby przejrzeć zdarzenia zarejestrowane dla tego żądania.Możesz rozpocząć debugowanie od określonego zdarzenia.

Żądania sieci Web wyświetlają się domyślnie od góry do dołu w kolejności ich pojawiania na serwerze.

Aby przeglądać zdarzenia zarejestrowane na szczególne żądania sieci Web

W Żądaniach sieci Web wybierz żądanie sieci Web.

W dolnej części Żądań sieci Web wybierz Szczegóły żądania.Możesz także dwukrotnie kliknąć żądanie sieci Web.

Spowoduje to otwarcie strony Szczegóły żądania dla wybranego żądania sieci Web i wyświetlenie serii wydarzeń IntelliTrace, które zostały zapisane w żądaniu.Począwszy od góry, zdarzenia są wyświetlane w kolejności ich wystąpienia.Filtruj zdarzenia, wybierając z listy kategorii lub przy użyciu pola wyszukiwania.Zobacz Rejestrowanie wykonywania kodu za pomocą narzędzia IntelliTrace na potrzeby debugowania w programie Visual Studio.

Porada
Strona Szczegóły żądania otwiera się w karcie podglądu.Gdy wybierzesz kolejne żądanie sieci Web, ta karta zostanie zastąpiona nową stroną Szczegóły żądania.Aby zachować kartę podglądu, wybierz Podwyższ poziom na karcie.Kolejne żądanie sieci Web zostanie otwarte w nowej karcie podglądu.

Aby rozpocząć debugowanie z określonego zdarzenia

W opcji Zdarzenia żądań wybierz zdarzenie.

W dolnej części opcji Zdarzenia żądań wybierz Rozpocznij debugowanie.Możesz także dwukrotnie kliknąć na zdarzenie.

Porada
Jeśli plik .iTrace zawiera informacje na temat wywołań funkcji, możesz przejść przez kod, począwszy od lokalizacji zdarzenia.Możesz też zobaczyć parametr i zwracane wartości. Aby zebrać informacje na temat wywołania: Aby zebrać informacje wywołań, skonfiguruj IntelliTrace w Visual Studio Ultimate.Zobacz Rejestrowanie wykonywania kodu za pomocą narzędzia IntelliTrace na potrzeby debugowania w programie Visual Studio. Dla autonomicznego modułu zbierającego IntelliTrace, użyj planu kolekcji collection_plan.ASP.NET.trace.xml, albo dostosowany plan kolekcji.Zobacz Zbieranie danych IntelliTrace poza programem Visual Studio za pomocą modułu Standalone Collector. Program Visual Studio nie może rozpoznać lokalizacji źródłowych, jeśli wyświetla się komunikat „Nie można odnaleźć symboli”.Upewnij się, że pliki symbol (.pdb) aplikacji sieci Web znajdują się w ścieżce symbol Visual Studio.Zobacz Wyszukiwanie plików symboli (.pdb) oraz plików źródłowych i binarnych.

Jeśli plik .iTrace zawiera informacje na temat wywołań funkcji, możesz przejść przez kod, począwszy od lokalizacji zdarzenia.Możesz też zobaczyć parametr i zwracane wartości.

Aby zebrać informacje na temat wywołania:

Aby zebrać informacje wywołań, skonfiguruj IntelliTrace w Visual Studio Ultimate.Zobacz Rejestrowanie wykonywania kodu za pomocą narzędzia IntelliTrace na potrzeby debugowania w programie Visual Studio.
Dla autonomicznego modułu zbierającego IntelliTrace, użyj planu kolekcji collection_plan.ASP.NET.trace.xml, albo dostosowany plan kolekcji.Zobacz Zbieranie danych IntelliTrace poza programem Visual Studio za pomocą modułu Standalone Collector.

Program Visual Studio nie może rozpoznać lokalizacji źródłowych, jeśli wyświetla się komunikat „Nie można odnaleźć symboli”.Upewnij się, że pliki symbol (.pdb) aplikacji sieci Web znajdują się w ścieżce symbol Visual Studio.Zobacz Wyszukiwanie plików symboli (.pdb) oraz plików źródłowych i binarnych.

Kolumna	Pokazuje
Metoda	Metoda HTTP przekazana z żądaniem
Docelowy adres URL	Docelowy adres URL przekazany z żądaniem
Czas (ms)	Czas (w milisekundach) między odebraniem żądania przez serwer a wysłaniem odpowiedzi przez serwer
Stan	Kod stanu HTTP zwracany w wyniku
Identyfikator sesji	Identyfikator sesji używany przez usługi IIS do rozróżniania użytkowników. Wartość Identyfikator sesji jest tylko rosnącą liczbą całkowitą używaną do rozróżniania użytkowników sesji i nie wiąże się z pojęciem ASP.NET dotyczącym identyfikatora sesji.Żądania sieci Web, które mają ten sam Identyfikator sesji należą do tej samej sesji użytkownika.
Identyfikator klienta	Adres IP zapisywany przez usługi IIS dla przesłanego żądania
Agent użytkownika	Wartość ciągu agenta użytkownika, przekazana z uwzględnieniem żądania HTTP
Godzina rozpoczęcia	Czas, w którym serwer odebrał żądanie
Godzina zakończenia	Czas, w którym serwer udzielił odpowiedzi klientowi

Aby wyświetlić dane z punktu widzenia użytkownika, filtruj i grupuj żądania sieci Web.Na przykład:
- Aby znaleźć błędy, filtruj żądania według Stanu.
- Aby wyświetlić trendy lub zachowania użytkowników, grupuj błędy według Docelowego adresu URL lub Identyfikatora sesji.
Możesz także filtrować wyszukiwania do określonej kolumny.Wpisz nazwę kolumny bez spacji, dwukropka ani wartości wyszukiwania.

Aby znaleźć na przykład żądania sieci Web, które używało metody GET z określonym identyfikatorem sesji, wpisz:

Metoda:GET;SessionId:2

Możesz użyć jednego filtru na kolumnę.Aby wyświetlić możliwe do filtrowania kolumny, zobacz etykietkę pola wyszukiwania Żądania sieci Web.

Dane wyjątku

Ta sekcja umożliwia zbadanie zarejestrowanych wyjątków, które zostały wygenerowane przez aplikację.Najnowsze wyjątki pojawiają się domyślnie jako pierwsze, ponieważ wyjątki są sortowane według Czasu zdarzenia w kolejności malejącej.

Aby rozpocząć debugowanie z określonego wyjątku

W opcji Dane wyjątku wybierz wyjątek.
W dolnej części opcji Dane wyjątku wybierz Rozpocznij debugowanie.Możesz także dwukrotnie kliknąć na wyjątek.

Uruchomiony zostanie program debugowania w czasie, kiedy wystąpił wyjątek.

Porada
Poszukaj wielu wyjątków, które mają taki sam Typ i Identyfikator wątku oraz są wyświetlane kolejno.Jest to często spowodowane przez jeden wyjątek, który został wygenerowany, wychwycony, a następnie ponownie wygenerowany. Aby przekonać się, czy tak jest, wybierz każdy z tych wyjątków i spójrz na stos wywołań.Zobacz, czy wywołanie stosu się zwiększa lub zmniejsza.Jeśli krótszy stos jest taki sam jak początek dłuższego stosu wywołań oraz identyczny jest Identyfikator wątku, istnieje możliwość, że ponownie wygenerowany został ten sam wyjątek.Wyjątek z najdłuższym stosem wywołań może być najbliżej źródła problemu.

Poszukaj wielu wyjątków, które mają taki sam Typ i Identyfikator wątku oraz są wyświetlane kolejno.Jest to często spowodowane przez jeden wyjątek, który został wygenerowany, wychwycony, a następnie ponownie wygenerowany.

Aby przekonać się, czy tak jest, wybierz każdy z tych wyjątków i spójrz na stos wywołań.Zobacz, czy wywołanie stosu się zwiększa lub zmniejsza.Jeśli krótszy stos jest taki sam jak początek dłuższego stosu wywołań oraz identyczny jest Identyfikator wątku, istnieje możliwość, że ponownie wygenerowany został ten sam wyjątek.Wyjątek z najdłuższym stosem wywołań może być najbliżej źródła problemu.

Kolumna	Pokazuje
Typ	Wyjątek typu .NET
Wiadomość	Komunikat wyjątku
Identyfikator wątku	Identyfikator wątku, który wygenerował wyjątek.
Wynik HResult	Kod błędu określony w wyjątku.Dostępne, jeśli ta wartość została ustawiona w wyjątku.
Godzina zdarzenia	Sygnatura czasowa zapisana, kiedy wygenerowany został wyjątek
Stos wywołań	Stos wywołań dla wyjątku. Aby wyświetlić stos wywołań, wybierz wyjątek z listy.Stos wywołań jest wyświetlany poniżej listy wyjątków.

Dane testowe

Ta sekcja pozwala Ci zbadać dane, które zostały zebrane przez Menedżera testów podczas testowania aplikacji.

Aby rozpocząć debugowanie z określonego etapu testu

Rozwiń Siatkę etapów testu.Wybierz etap testu.
W dolnej części opcji Siatka etapów testu wybierz Rozpocznij debugowanie.Możesz także dwukrotnie kliknąć na etap testu.

Uruchomiony zostanie program debugowania z pierwszego odpowiedniego zdarzenia IntelliTrace po wybraniu etapu testu.

Jeśli istnieją dane testowe, IntelliTrace próbuje rozpoznać skojarzoną kompilację Team Foundation Server, która została użyta do wykonania testu.Jeśli kompilacja zostanie znaleziona, skojarzone z nią symbole dla aplikacji są rozpoznawane automatycznie.

Pole	Pokazuje
Sesja testowa	Sesje testowe, które zostały zapisane.Zazwyczaj jest tylko jedna.Ta lista jest pusta, jeśli dane z badań zostały utworzone za pomocą manualnego testu poznawczego.
Przypadek testowy	Przypadki testowe z wybranej sesji testowej.Ta lista jest pusta, jeśli dane z badań zostały utworzone za pomocą manualnego testu poznawczego.
Siatka etapów testu	Etapy testu, które zostały zapisane w pomyślnym lub niepomyślnym wyniku testu

Informacje o systemie

Ta sekcja przedstawia szczegółowe informacje dotyczące systemu, który obsługiwał aplikację, na przykład sprzęt, system operacyjny, informacje dotyczące środowiska i procesu.

Moduły

Ta sekcja pokazuje Ci listę modułów, które zostały załadowane w procesie ładowania.Moduły pojawiają się w kolejności załadowania.

Kolumna	Pokazuje
Nazwa modułu	Nazwa pliku modułu
Ścieżka modułu	Lokalizację dysku, gdzie moduł został załadowany
Identyfikator modułu	Unikatowy identyfikator modułu, który jest określony dla wersji i wchodzi w skład odpowiednich plików symboli (PDB).Zobacz [OBSOLETE] Porady: określanie lokalizacji symboli i zachowania przy ładowaniu.

Udostępnij za pośrednictwem