Przykład 4. Aktualizowanie sesji śledzenia

Podczas uruchamiania sesji śledzenia można zaktualizować następujące właściwości sesji śledzenia w czasie rzeczywistym lub zarejestrowanej sesji śledzenia:

• Przekonwertuj sesję śledzenia w czasie rzeczywistym na sesję dziennika śledzenia (przy użyciu -f).

• Utwórz nowy dziennik śledzenia dla istniejącej sesji dziennika śledzenia (przy użyciu -f).

• Dodaj funkcję dostarczania komunikatów śledzenia w czasie rzeczywistym do istniejącej sesji dziennika śledzenia (przy użyciu -rt).

• Zmień maksymalną liczbę buforów (przy użyciu -max), ale nie zmieniaj minimalnej liczby buforów.

• Zmień interwał czasu opróżniania (przy użyciu -ft).

• Wyczyść bufory śledzenia (przy użyciu -dziennika śledzenia -flush).

Nie można użyć tracelog -update polecenia, aby zmienić flagi i poziom dostawcy śledzenia. Zamiast tego użyj polecenia tracelog -enable , jak pokazano w przykładzie 5: Włączanie dostawców śledzenia.

Parametry -rt i -f działają inaczej w poleceniu tracelog -update . Parametr -rt dodaje dostarczanie komunikatów w czasie rzeczywistym do sesji dziennika śledzenia. W związku z tym nowe komunikaty śledzenia są wysyłane bezpośrednio do odbiorcy śledzenia i do dziennika śledzenia. Jednak przed dodaniem dostarczania komunikatów w czasie rzeczywistym do sesji dziennika śledzenia, bufory muszą zostać opróżnione przy użyciu polecenia tracelog -flush. Gdy parametr -f jest używany do aktualizowania sesji śledzenia w czasie rzeczywistym, zastępuje dostarczanie komunikatów w czasie rzeczywistym dostarczaniem do dziennika śledzenia. W związku z tym nowe komunikaty śledzenia są wysyłane tylko do dziennika śledzenia; nie są już wysyłane bezpośrednio do konsumenta śledzenia.

Następujące polecenie zmienia sesję śledzenia w czasie rzeczywistym o nazwie "MyTrace" na sesję dziennika śledzenia. Polecenie używa parametru -f , aby określić lokalizację pliku dziennika C:\tracing\MyTrace.etl. Używa również parametru -max z wartością 35, aby zwiększyć maksymalną liczbę buforów do 35.

tracelog -update MyTrace -f c:\tracing\mytrace.etl -max 35

W odpowiedzi tracelog wyświetla właściwości sesji śledzenia, w tym właściwości, które zostały właśnie zmienione.

W wyniku tego polecenia wszystkie nowe komunikaty śledzenia generowane przez dostawcę oraz wszystkie komunikaty śledzenia przechowywane w buforze podczas przesyłania polecenia są zapisywane tylko w pliku dziennika. Nie są już wysyłane bezpośrednio do konsumenta śledzenia, jak to ma miejsce w sesji śledzenia w czasie rzeczywistym.

Aby dodać dziennik śledzenia do sesji śledzenia w czasie rzeczywistym, tak aby komunikaty śledzenia zostały wysłane do odbiorcy śledzenia i do dziennika śledzenia, uwzględnij parametry -rt i -f , jak pokazano w poniższym poleceniu.

tracelog -update MyTrace -rt -f c:\tracing\mytrace.etl -max 35

Możesz także opróżnić bufory śledzenia, gdy sesja jest uruchomiona. Jest to wymuszone opróżnienie, które nie jest koordynowane z czasomierzem opróżniania. System ponownie opróżni bufory po wygaśnięciu czasomierza opróżniania i zatrzymaniu sesji śledzenia.

Aby opróżnić bufory istniejącej sesji śledzenia, użyj parametru -flush, jak pokazano w poniższym przykładzie. Parametr -flush nie jest parametrem podrzędnym polecenia tracelog-update.

tracelog -flush MyTrace

W odpowiedzi tracelog wyświetla poprawione właściwości sesji śledzenia.