Udostępnij za pośrednictwem

Usługi i śledzenie zdarzeń programu WCF dla systemu Windows

  • Artykuł

W przykładzie ETWTracing pokazano, jak używać śledzenia analitycznego w programie Windows Communication Foundation (WCF) do emitowania zdarzeń w śledzeniu zdarzeń dla systemu Windows (ETW). Ślady analityczne to zdarzenia emitowane w kluczowych punktach w stosie WCF, które umożliwiają rozwiązywanie problemów z usługami WCF w środowisku produkcyjnym.

Śledzenie analityczne w usługach WCF to śledzenie, które można włączyć w środowisku produkcyjnym z minimalnym wpływem na wydajność. Te ślady są emitowane jako zdarzenia do sesji ETW.

Ten przykład zawiera podstawową usługę WCF, w której zdarzenia są emitowane z usługi do dziennika zdarzeń, które można wyświetlić przy użyciu Podgląd zdarzeń. Można również uruchomić dedykowaną sesję ETW, która nasłuchuje zdarzeń z usługi WCF. Przykład zawiera skrypt służący do tworzenia dedykowanej sesji ETW, która przechowuje zdarzenia w pliku binarnym, który można odczytać przy użyciu Podgląd zdarzeń.

Aby użyć tego przykładu

  1. Za pomocą programu Visual Studio otwórz plik rozwiązania EtwAnalyticTraceSample.sln.

  2. Aby skompilować rozwiązanie, naciśnij klawisze Ctrl+Shift+B.

  3. Aby uruchomić rozwiązanie, naciśnij klawisze Ctrl+F5.

    W przeglądarce internetowej kliknij pozycję Calculator.svc. Identyfikator URI dokumentu WSDL dla usługi powinien zostać wyświetlony w przeglądarce. Skopiuj ten identyfikator URI.

    Domyślnie usługa uruchamia nasłuchiwanie żądań na porcie 1378 http://localhost:1378/Calculator.svc.

  4. Uruchom klienta testowego programu WCF (WcfTestClient.exe).

    Klient testowy programu WCF (WcfTestClient.exe) znajduje się w lokalizacji \<Visual Studio Install Dir>\Common7\IDE\WcfTestClient.exe.

  5. W kliencie testowym programu WCF dodaj usługę, wybierając pozycję Plik, a następnie pozycję Dodaj usługę.

    Dodaj adres punktu końcowego w polu wejściowym. Wartość domyślna to http://localhost:1378/Calculator.svc.

  6. Otwórz aplikację Podgląd zdarzeń.

    Przed wywołaniem usługi uruchom Podgląd zdarzeń i upewnij się, że dziennik zdarzeń nasłuchuje śledzenia zdarzeń emitowanych z usługi WCF.

  7. Z menu Start wybierz pozycję narzędzia Administracja istracyjne, a następnie Podgląd zdarzeń. Włącz dzienniki analityczne i debugowania.

  8. W widoku drzewa w Podgląd zdarzeń przejdź do pozycji Podgląd zdarzeń, dzienniki aplikacji i usług, Microsoft, Windows, a następnie pozycję Application Server-Applications. Kliknij prawym przyciskiem myszy pozycję Aplikacje serwera aplikacji, wybierz pozycję Widok, a następnie pozycję Pokaż dzienniki analityczne i debugowania.

    Upewnij się, że opcja Pokaż dzienniki analityczne i debugowania jest zaznaczona.

  9. Włącz dziennik analityczny.

    W widoku drzewa w Podgląd zdarzeń przejdź do pozycji Podgląd zdarzeń, dzienniki aplikacji i usług, Microsoft, Windows, a następnie pozycję Application Server-Applications. Kliknij prawym przyciskiem myszy pozycję Analityczne i wybierz pozycję Włącz dziennik.

Aby przetestować usługę

  1. Wróć do klienta testowego programu WCF i kliknij Divide dwukrotnie i zachowaj wartości domyślne, które określają mianownik 0.

    Jeśli mianownik ma wartość 0, usługa zgłasza błąd.

  2. Obserwuj zdarzenia emitowane z usługi.

    Wróć do Podgląd zdarzeń i przejdź do Podgląd zdarzeń, dzienników aplikacji i usług, firmy Microsoft, systemu Windows, a następnie pozycji Aplikacje serwera aplikacji. Kliknij prawym przyciskiem myszy pozycję Analityczne i wybierz polecenie Odśwież.

    Zdarzenia śledzenia analitycznego programu WCF są wyświetlane w podglądzie zdarzeń. Zwróć uwagę, że ponieważ usługa zgłosiła błąd, w podglądzie zdarzeń jest wyświetlane zdarzenie śledzenia błędów.

  3. Powtórz kroki 1 i 2, ale z prawidłowymi danymi wejściowymi. Wartość parametru N2 może być dowolną liczbą inną niż 0.

    Odśwież kanał analityczny, aby wyświetlić zdarzenia programu WCF, nie zawierają żadnych zdarzeń błędów.

W przykładzie pokazano zdarzenia śledzenia analitycznego emitowane z usługi WCF.

Aby wyczyścić (opcjonalnie)

  1. Otwórz Podgląd zdarzeń.

  2. Przejdź do pozycji Podgląd zdarzeń, Dzienniki aplikacji i usług, Microsoft, Windows, a następnie Application-Server-Applications. Kliknij prawym przyciskiem myszy pozycję Analityczne i wybierz polecenie Wyłącz dziennik.

  3. Przejdź do pozycji Podgląd zdarzeń, Dzienniki aplikacji i usług, Microsoft, Windows, a następnie Application-Server-Applications. Kliknij prawym przyciskiem myszy pozycję Analityczne i wybierz polecenie Wyczyść dziennik.

  4. Wybierz opcję Wyczyść, aby wyczyścić zdarzenia.

Zobacz też