CMTrace

  • Artykuł

Dotyczy: programu Configuration Manager (bieżąca gałąź)

CmTrace jest jednym z narzędzi Configuration Manager. Umożliwia ona wyświetlanie i monitorowanie plików dziennika, w tym następujących typów:

  • Pliki dziennika w formacie Configuration Manager lub Client Component Manager (CCM)

  • Zwykłe pliki tekstowe ASCII lub Unicode, takie jak dzienniki instalatora Windows

Narzędzie pomaga analizować pliki dziennika przez wyróżnianie, filtrowanie i wyszukiwanie błędów.

Uwaga

Funkcja CMTrace nie jest automatycznie rejestrowana w systemie Windows w celu otwarcia rozszerzenia pliku dziennika. Aby uzyskać więcej informacji, zobacz Skojarzenia plików.

Configuration Manager wersja 2107 zawiera wiele ulepszeń wydajności przeglądarki dzienników CMTrace.

Lokalizacje

Configuration Manager automatycznie instaluje narzędzie CMTrace w następujących lokalizacjach:

  • Katalog narzędzi serwera lokacji. Przykład: cd.latest\SMSSETUP\Tools\CMTrace.exe
  • Katalog instalacyjny punktu zarządzania. Przykład: C:\SMS_CCM\CMTrace.exe
  • Katalog instalacji klienta. Przykład: C:\Windows\CCM\CMTrace.exe
  • Obrazy rozruchowe wdrożenia systemu operacyjnego. Przykład: X:\sms\bin\x64\CMTrace.exe

Jeśli masz kopię funkcji CMTrace w innej lokalizacji, rozważ jej usunięcie i użycie kopii w jednej ze ścieżek domyślnych. Jeśli znajduje się on w lokalizacji niestandardowej, która spełnia wymagania biznesowe, upewnij się, że masz proces, aby być na bieżąco. Jeśli twoja lokalizacja niestandardowa może być korzystna dla innych klientów, prześlij opinię o produkcie.

Aby uzyskać więcej informacji, zobacz Bezpośrednie linki do elementów centrum społeczności.

Zastosowanie

Uruchom CMTrace.exe. Po pierwszym uruchomieniu narzędzia zostanie wyświetlony monit o skojarzenie pliku. Aby uzyskać więcej informacji, zobacz Skojarzenia plików.

Większość akcji w usłudze CMTrace można wykonać z następujących menu:

Menu Plik

W menu Plik są dostępne następujące akcje:

Menu Plik zawiera również listę ostatnich ośmiu ostatnich plików. Szybko otwórz ponownie jeden z tych dzienników, wybierając go z menu Plik.

Otwórz

Wyświetla okno dialogowe Otwieranie w celu wyszukania pliku dziennika.

Filtruj widok dla plików następujących typów:

  • Pliki dziennika (*.log)
  • Stare pliki dziennika (*.lo_)
  • Wszystkie pliki (*.*)

Następujące dwie opcje nie są domyślnie zaznaczone:

  • Ignoruj istniejące wiersze: po wybraniu polecenia cmtrace ignoruje istniejącą zawartość wybranego pliku dziennika i wyświetla nowe wiersze tylko w miarę ich dodawania. Ta opcja służy do monitorowania tylko nowych akcji, gdy nie potrzebujesz pełnej historii pliku dziennika.

  • Scal wybrane pliki: jeśli włączysz tę opcję i wybierzesz więcej niż jeden plik dziennika, funkcja CMTrace scali wybrane dzienniki w widoku. Wyświetla je tak, jakby były pojedynczym plikiem dziennika. Scalony dziennik jest aktualizowany tak samo i obsługuje wszystkie inne funkcje cmtrace, tak jakby był to pojedynczy plik dziennika.

Otwórz na serwerze

Przejrzyj folder dzienników Configuration Manager na komputerze systemu lokacji przy użyciu standardowego okna dialogowego Przeglądaj. Możesz również przeglądać sieć w poszukiwaniu komputera zdalnego.

Po wybraniu komputera zdalnego do przeglądania funkcja CMTrace sprawdza udział Configuration Manager. Jeśli nie można odnaleźć udziału w plikach dziennika Configuration Manager, zostanie wyświetlony komunikat o błędzie.

Aby połączyć się bezpośrednio ze znanym komputerem bez przeglądania, użyj akcji Otwórz . Następnie wprowadź nazwę serwera i udział przy użyciu formatu UNC.

Drukowania

Wyświetl standardowe okno dialogowe Drukowanie systemu Windows. Ta akcja wysyła bieżący plik dziennika do drukarki. Formatuje dane wyjściowe zgodnie z ustawieniami na karcie Drukowanie preferencji cmtrace.

Preferencje

Skonfiguruj ustawienia dla funkcji CMTrace. Dostępne są następujące opcje:

  • Karta Ogólne

    • Interwał aktualizacji: określa, jak często cmtrace sprawdza zmiany w plikach dziennika i ładuje nowe wiersze. Domyślnie ta wartość to 500 milisekund.

    • Wyróżnij: ustawia kolor używany przez narzędzie CMTrace podczas wyróżniania wybranych wierszy dziennika. Domyślnie ten kolor jest żółty (czerwony: 255, zielony: 255, niebieski: 0).

    • Kolumny: konfiguruje kolumny widoczne w widoku dziennika i kolejność ich wyświetlania. Domyślnie wyświetla tekst dziennika, składnik, datę/godzinę i wątek.

  • Karta Drukowanie

    • Kolumny: skonfiguruj kolumny używane podczas drukowania plików dziennika i kolejność ich wyświetlania. Domyślnie wyświetla te same kolumny, które są wyświetlane.

    • Orientacja: ustawia domyślną orientację drukowania podczas drukowania plików dziennika. Przesłoń to ustawienie w oknie dialogowym Drukowanie. Domyślnie używa orientacji pionowej.

  • Karta Zaawansowane

    • Interwał odświeżania: wymusza na usłudze CMTrace aktualizowanie widoku dziennika w określonym interwale podczas ładowania dużej liczby wierszy. Domyślnie ta opcja jest wyłączona z wartością zero.

      Uwaga

      Ogólnie rzecz biorąc, nie modyfikuj interwału odświeżania. Może znacznie zwiększyć czas otwierania dużych plików dziennika.

Menu Narzędzia

W menu Narzędzia są dostępne następujące akcje :

Znaleźć

Wyszukaj w otwartym pliku dziennika określony ciąg tekstowy.

Znajdź dalej

Znajduje następny pasujący ciąg, zgodnie z wcześniejszymi instrukcjami w oknie dialogowym Znajdowanie.

Kopiuj do schowka

Kopiuje zaznaczone wiersze jako zwykły tekst do schowka systemu Windows. Jeśli sprawdzasz pliki dziennika Configuration Manager i CCM, kopiuje on kolumny w tej samej kolejności co widok. Oddziela każdą kolumnę znakiem tabulacji. Użyj tej akcji podczas kopiowania dzienników do wiadomości e-mail lub innych dokumentów.

Wyróżnij

Wprowadź ciąg używany przez narzędzie CMTrace do przeszukiwania tekstu każdego wpisu dziennika. Następnie wyróżnia dowolny tekst dziennika zgodny z wprowadzonym ciągiem.

  • Wyróżnienie używa koloru określonego w obszarze Preferencje.

  • Aby wyłączyć wyróżnianie, wyczyść ciąg z tego pola.

  • Jeśli wprowadzisz liczbę dziesiętną lub szesnastkową, funkcja CMTrace spróbuje dopasować wartość do kolumny Wątek. To zachowanie służy do wyróżniania przetwarzania pojedynczego wątku bez filtrowania innych wątków, które mogą z nim wchodzić w interakcje.

  • Aby porównać ciągi według wielkości liter, włącz opcję Uwzględnianie wielkości liter.

Filtrowanie

Pokaż lub ukryj wiersze dziennika na podstawie określonych kryteriów. Zastosuj filtry do dowolnej z czterech kolumn niezależnie od tego, czy są one widoczne. Te ustawienia dotyczą każdego otwartego pliku dziennika.

Przykłady:

  • Filtruj smsts.log w tekście wpisu zawierającym "akcję" lub "grupę".
  • Filtr InventoryAgent.log , gdzie tekst wpisu zawiera "miejsce docelowe".

Wyszukiwanie błędów

Wpisz lub wklej kod błędu w formacie dziesiętnym lub szesnastkowym, aby wyświetlić opis. Możliwe źródła błędów to: Windows, WMI lub Winhttp.

Wstrzymaj

Wstrzymywanie lub ponowne uruchamianie monitorowania dziennika. Następujące przypadki użycia to niektóre z możliwych powodów użycia tej akcji:

  • Gdy funkcja CMTrace zbyt szybko wyświetla informacje o pliku dziennika

  • W przypadku wstrzymywania monitorowania dziennika informacje wyświetlane przez funkcję CMTrace nie zostaną utracone, jeśli bieżący plik zostanie przekazany do nowego dziennika

  • Jeśli chcesz uniemożliwić usłudze CMTrace wyświetlanie nowych danych podczas badania pliku dziennika

Pokaż/ukryj szczegóły

Pokaż lub ukryj wszystkie kolumny inne niż tekst dziennika. Rozszerza również kolumnę tekstową dziennika na szerokość okna. Użyj tej akcji podczas wyświetlania dzienników na komputerze o niskiej rozdzielczości wyświetlania. Wyświetla więcej tekstu dziennika.

Uwaga

Podczas wyświetlania plików zwykłego tekstu narzędzie CMTrace automatycznie ukrywa szczegóły, ponieważ są zawsze puste.

Pokaż/Ukryj okienko informacji

Pokaż lub ukryj okienko Informacje. Użyj tej akcji podczas wyświetlania dzienników na komputerze o niskiej rozdzielczości wyświetlania. Wyświetla więcej szczegółów rejestrowania.

Okienko dziennika

Okienko dziennika znajduje się w górnej części okna CMTrace. Wyświetla wiersze z plików dziennika.

Po wybraniu wiersza zostanie on tymczasowo wyróżniony przy użyciu schematu kolorów wyboru systemu Windows.

Wyróżnione wiersze są zgodne z kryteriami zdefiniowanymi za pomocą opcji Wyróżnij w menu Narzędzia . Wyróżnienie używa koloru określonego w obszarze Preferencje.

Funkcja CMTrace wyświetla wiersze z błędami przy użyciu czerwonego tła i żółtego koloru tekstu. W dziennikach w formacie CCM wpisy dziennika mają jawną wartość typu, która wskazuje wpis jako błąd. W przypadku innych formatów dzienników funkcja CMTrace wykonuje wyszukiwanie bez uwzględniania wielkości liter w każdym wpisie dla dowolnego ciągu tekstowego pasującego do ciągu "error".

Wyświetla wiersze z ostrzeżeniami przy użyciu żółtego tła. W dziennikach w formacie CCM wpisy dziennika mają jawną wartość typu, która wskazuje wpis jako ostrzeżenie. W przypadku innych formatów dzienników funkcja CMTrace wykonuje wyszukiwanie bez uwzględniania wielkości liter w każdym wpisie dla dowolnego ciągu tekstowego pasującego do ciągu "warn".

Okienko informacji

Okienko Informacje znajduje się w dolnej części okna CMTrace. Obejmuje ona następujące funkcje:

  • Szczegóły dotyczące aktualnie wybranego wpisu dziennika

  • Pole tekstowe, które wyświetla tekst dziennika

  • Wyświetla ona powroty karetki, dzięki czemu sformatowany tekst jest łatwiejszy do odczytania

  • Łatwiejsze odczytywanie długich wpisów, które nie są w pełni widoczne w okienku Dziennik

Pokaż lub ukryj okienko Informacje za pomocą opcji Pokaż/Ukryj okienko informacji w menu Narzędzia . Jeśli okienko Informacje zajmuje więcej niż połowę okna dziennika, funkcja CMTrace automatycznie je ukrywa.

Pasek postępu

Po pierwszym otwarciu pliku dziennika narzędzie CMTrace zastępuje okienko Informacje paskiem postępu. Ten postęp wskazuje, jaka część istniejącej zawartości pliku została załadowana. Postęp osiąga 100 procent, funkcja CMTrace usuwa pasek postępu i zastępuje go okienkiem Informacje. Podczas ładowania dużych plików to zachowanie zapewnia wskazanie, jak długo może trwać ładowanie.

Pasek stanu

W przypadku plików dziennika w formacie Configuration Manager i CCM na pasku stanu jest wyświetlany czas, który upłynął dla wybranych wpisów dziennika. Jeśli wybierzesz pojedynczy wpis, narzędzie wyświetli czas od pierwszego wpisu dziennika do wybranego wpisu. Jeśli wybierzesz wiele wpisów, obliczy on czas od najbardziej wybranego wpisu do najbardziej wybranego dolnego wpisu. Funkcja CMTrace formatuje te informacje w następujący sposób:

Elapsed time is <hours>h <minutes>m <seconds>s <milliseconds>ms (<seconds+milliseconds> seconds)

Integracja powłoki systemu Windows

Narzędzie CMTrace obsługuje skojarzenia plików oraz przeciąganie i upuszczanie.

Skojarzenia plików

Narzędzie CMTrace może skojarzyć się z rozszerzeniami nazw plików .log i .lo_. Po uruchomieniu programu sprawdza rejestr, aby ustalić, czy jest już skojarzony z tymi rozszerzeniami nazw plików. Jeśli funkcja CMTrace nie jest jeszcze skojarzona z żadnymi rozszerzeniami nazw plików, zostanie wyświetlony monit o skojarzenie rozszerzeń nazw plików z programem CMTrace. Jeśli wybierzesz pozycję Nie pytaj mnie ponownie, funkcja CMTrace pominie tę kontrolę za każdym razem, gdy jest ona uruchamiana na tym komputerze.

Przeciągnij i upuść

Funkcja CMTrace obsługuje podstawowe funkcje przeciągania i upuszczania. Przeciągnij plik dziennika z Eksploratora Windows do narzędzia CMTrace, aby go otworzyć.

Inne porady

Klucz rejestru ostatniego katalogu

Domyślnie funkcja CMTrace zapisuje ostatnią otwartą lokalizację dziennika. To zachowanie jest przydatne na serwerze lokacji, ponieważ za każdym razem jest domyślnie ustawiona ścieżka dzienników.

Przy pierwszym uruchomieniu na kliencie domyślnie jest to bieżący katalog roboczy. Ta lokalizacja może być ścieżką, w której zapisano funkcję CMTrace, lub ścieżką taką jak %userprofile%\Desktop.

Wartość Ostatni katalog w kluczu HKEY_CURRENT_USER\Software\Microsoft\Trace32 rejestru steruje tą lokalizacją domyślną. Jeśli ta wartość %windir%\CCM\Logs zostanie ustawiona na klientach, funkcja CMTrace otworzy pliki w lokalizacji dziennika klienta przy pierwszym uruchomieniu.

Następne kroki

OneTrace to przeglądarka dzienników z Centrum pomocy technicznej. Działa podobnie do funkcji CMTrace z ulepszeniami. Aby uzyskać więcej informacji, zobacz Centrum pomocy technicznej OneTrace.