CMTrace

  • Статья

Относится к Configuration Manager (Current Branch)

CMTrace является одним из Configuration Manager инструментов. Он позволяет просматривать и отслеживать файлы журналов, включая следующие типы:

  • Файлы журнала в формате Configuration Manager или клиентского диспетчера компонентов (CCM)

  • Обычные текстовые файлы ASCII или Юникод, например журналы установщика Windows

Средство помогает анализировать файлы журналов путем выделения, фильтрации и поиска ошибок.

Примечание.

CMTrace не регистрируется в Windows автоматически, чтобы открыть файл с расширением .log. Дополнительные сведения см. в разделе Сопоставления файлов.

Configuration Manager версии 2107 включает несколько улучшений производительности средства просмотра журналов CMTrace.

Расположения

Configuration Manager автоматически устанавливает CMTrace в следующих расположениях:

  • Каталог средств сервера сайта. Пример: cd.latest\SMSSETUP\Tools\CMTrace.exe
  • Каталог установки точки управления. Пример: C:\SMS_CCM\CMTrace.exe
  • Каталог установки клиента. Пример: C:\Windows\CCM\CMTrace.exe
  • Загрузочные образы развертывания ОС. Пример: X:\sms\bin\x64\CMTrace.exe

Если у вас есть копия CMTrace в другом расположении, попробуйте удалить ее и использовать копию в одном из путей по умолчанию. Если он находится в пользовательском расположении, которое соответствует вашим бизнес-требованиям, убедитесь, что у вас есть процесс, позволяющий поддерживать его в актуальном состоянии. Если ваше пользовательское расположение может оказаться полезным для других клиентов, отправьте отзыв о продукте.

Дополнительные сведения см. в разделе Прямые ссылки на элементы центра сообщества.

Применение

Запустите CMTrace.exe. При первом запуске средства отображается запрос на сопоставление файлов. Дополнительные сведения см. в разделе Сопоставления файлов.

Большинство действий в CMTrace выполняются из следующих меню:

меню "Файл"

В меню Файл доступны следующие действия:

В меню Файл также перечислены последние восемь последних файлов. Быстро откройте один из этих журналов, выбрав его в меню Файл.

Открыть

Отображает диалоговое окно Открыть для поиска файла журнала.

Отфильтруйте представление для файлов следующих типов:

  • Файлы журнала (*.log)
  • Старые файлы журнала (*.lo_)
  • Все файлы (*.*)

Следующие два параметра не выбраны по умолчанию:

  • Игнорировать существующие строки. Если этот параметр выбран, CMTrace игнорирует существующее содержимое выбранного файла журнала и отображает новые строки только по мере их добавления. Используйте этот параметр для отслеживания только новых действий, если вам не требуется полный журнал файла журнала.

  • Объединить выбранные файлы. Если этот параметр включен и выбрано несколько файлов журнала, CMTrace объединяет выбранные журналы в представлении. Они отображаются так, как если бы они были одним файлом журнала. Объединенный журнал обновляет то же самое и поддерживает все остальные функции CMTrace, как если бы это один файл журнала.

Открыть на сервере

Перейдите в папку журналов Configuration Manager на компьютере системы сайта с помощью стандартного диалогового окна Обзор. Вы также можете просмотреть сеть для удаленного компьютера.

При выборе удаленного компьютера для просмотра CMTrace проверяет наличие Configuration Manager общей папки. Если не удается найти общий ресурс с файлами журнала Configuration Manager, отобразится сообщение об ошибке.

Чтобы подключиться непосредственно к известному компьютеру без просмотра, используйте действие Открыть . Затем введите имя сервера и общий ресурс в формате UNC.

Печать

Отображение стандартного диалогового окна "Печать Windows". Это действие отправляет текущий файл журнала на принтер. Он форматирует выходные данные в соответствии с параметрами на вкладке Печать параметров CMTrace.

Настройки

Настройка параметров для CMTrace. Доступны следующие варианты представления:

  • Вкладка "Общие "

    • Интервал обновления. Определяет частоту проверки CMTrace на наличие изменений в файлах журнала и загрузку новых строк. По умолчанию это значение равно 500 миллисекундам.

    • Выделение. Задает цвет, используемый CMTrace при выделении строк журнала. По умолчанию этот цвет является основным желтым (красный: 255, зеленый: 255, синий: 0).

    • Столбцы. Настраивает столбцы, видимые в представлении журнала, и порядок их отображения. По умолчанию отображается текст журнала, компонент, дата и время и поток.

  • Вкладка "Печать"

    • Столбцы. Настройте столбцы, используемые при печати файлов журнала, и порядок их отображения. По умолчанию он выводит те же столбцы, что и отображаемые.

    • Ориентация. Задает ориентацию печати по умолчанию при печати файлов журнала. Переопределите этот параметр в диалоговом окне Печать. По умолчанию используется книжная ориентация.

  • Вкладка "Дополнительно "

    • Интервал обновления: принуждает CMTrace обновлять представление журнала с заданным интервалом при загрузке большого количества строк. По умолчанию этот параметр отключен со значением, равным нулю.

      Примечание.

      Как правило, не изменяйте интервал обновления. Это может значительно увеличить время, необходимое для открытия больших файлов журнала.

Меню «Сервис»

В меню Сервис доступны следующие действия:

Найти

Выполните поиск указанной текстовой строки в открытом файле журнала.

Найти далее

Находит следующую соответствующую строку, как было указано ранее в диалоговом окне Найти.

Копировать в буфер

Копирует выделенные строки в виде обычного текста в буфер обмена Windows. Если вы просматриваете файлы журнала Configuration Manager и CCM, столбцы копируются в том же порядке, что и представление. Каждый столбец разделяется символом табуляции. Используйте это действие при копировании журналов в сообщения электронной почты или другие документы.

Highlight

Введите строку, которую CMTrace использует для поиска текста каждой записи журнала. Затем он выделяет любой текст журнала, соответствующий введенной строке.

  • Выделение использует цвет, указанный в параметрах.

  • Чтобы отключить выделение, очистите строку из этого поля.

  • Если ввести десятичное или шестнадцатеричное число, CMTrace попытается сопоставить значение со столбцом Thread. Используйте это поведение, чтобы выделить обработку одного потока, не отфильтровывая другие потоки, которые могут взаимодействовать с ним.

  • Чтобы сравнить строки по регистру, включите параметр с учетом регистра.

Filter

Отображение или скрытие строк журнала на основе указанных условий. Примените фильтры к любому из четырех столбцов независимо от того, видны ли они. Эти параметры применяются к каждому открытому файлу журнала.

Примеры:

  • Отфильтруйте smsts.log по тексту записи, содержащей "действие" или "группу".
  • Фильтрация InventoryAgent.log, где текст записи содержит "назначение".

Поиск ошибок

Введите или вставьте код ошибки в десятичном или шестнадцатеричном формате, чтобы отобразить описание. Возможные источники ошибок: Windows, WMI или Winhttp.

Пауза

Приостановка или перезапуск мониторинга журналов. Следующие варианты использования являются некоторыми из возможных причин для использования этого действия:

  • Если CMTrace отображает сведения о файле журнала слишком быстро

  • При приостановке мониторинга журналов информация, отображаемая CMTrace, не теряется, если текущий файл перевернется в новый журнал.

  • Если вы хотите запретить CMTrace отображать новые данные при проверке файла журнала

Отображение и скрытие сведений

Отображение или скрытие всех столбцов, отличных от текста журнала. Он также расширяет текстовый столбец журнала до ширины окна. Используйте это действие при просмотре журналов на компьютере с низким разрешением экрана. В нем отображается больше текста журнала.

Примечание.

При просмотре файлов в виде обычного текста CMTrace автоматически скрывает сведения, так как они всегда пусты.

Показать и скрыть область сведений

Отображение или скрытие области Сведений. Используйте это действие при просмотре журналов на компьютере с низким разрешением экрана. В нем отображаются дополнительные сведения о ведении журнала.

Область журнала

Область журнала находится в верхней части окна CMTrace. В нем отображаются строки из файлов журнала.

При выборе строки она временно выделяется с помощью цветовой схемы выбора Windows.

Выделенные строки соответствуют критериям, заданным с помощью параметра Выделить в меню Сервис . В выделении используется цвет, указанный в параметрах.

CMTrace отображает строки с ошибками, используя красный фон и желтый цвет текста. В журналах в формате CCM записи журнала имеют явное значение типа, указывающее запись как ошибку. Для других форматов журналов CMTrace выполняет поиск без учета регистра в каждой записи для любой текстовой строки, соответствующей "error".

На нем отображаются линии с предупреждениями на желтом фоне. В журналах в формате CCM записи журнала имеют явное значение типа, указывающее запись в качестве предупреждения. Для других форматов журналов CMTrace выполняет поиск без учета регистра в каждой записи для любой текстовой строки, соответствующей "warn".

Панель сведений

Область Сведений находится в нижней части окна CMTrace. Он включает в себя следующие функции:

  • Сведения о текущей выбранной записи журнала

  • Текстовое поле, отображающее текст журнала

  • Он отображает возврат каретки, что упрощает чтение отформатированного текста

  • Упрощено чтение длинных записей, которые не полностью видны в области журналов

Отображение или скрытие области сведений с помощью параметра Показать и скрыть область сведений в меню Сервис . Если область Сведений занимает более половины окна журнала, CMTrace автоматически скрывает ее.

Индикатор выполнения

При первом открытии файла журнала CMTrace заменяет панель сведений индикатором выполнения. Этот ход выполнения указывает, сколько содержимого файла загружено. Ход выполнения достигает 100 процентов. CMTrace удаляет индикатор выполнения и заменяет его панелью Сведений. При загрузке больших файлов это поведение дает представление о том, сколько времени может занять загрузка.

Строка состояния

Для файлов журналов в формате Configuration Manager и CCM в строке состояния отображается затраченное время для выбранных записей журнала. Если выбрать одну запись, средство отображает время от первой записи журнала до выбранной записи. При выборе нескольких записей вычисляется время от верхней выбранной записи до самой нижней выбранной записи. CMTrace форматирует эти сведения следующим образом:

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

Интеграция оболочки Windows

CMTrace поддерживает сопоставления файлов и перетаскивание.

Сопоставления файлов

CMTrace может связывать себя с расширениями .log и .lo_ имен файлов. При запуске программа проверяет реестр, чтобы определить, связан ли он уже с этими расширениями имен файлов. Если CMTrace еще не связан с расширениями имен файлов, вам будет предложено связать расширения имен файлов с CMTrace. Если вы наберете флажок Не спрашивать меня, CMTrace пропускает этот проверка при каждом запуске на этом компьютере.

Перетаскивание

CMTrace поддерживает основные функции перетаскивания. Перетащите файл журнала из Windows Обозреватель в CMTrace, чтобы открыть его.

Другие советы

Раздел реестра Last Directory

По умолчанию CMTrace сохраняет последнее открытое расположение журнала. Это поведение полезно на сервере сайта, так как по умолчанию по умолчанию используется путь к журналам каждый раз.

При первом запуске на клиенте по умолчанию используется текущий рабочий каталог. Это может быть путь, по которому вы сохранили CMTrace, или путь, например %userprofile%\Desktop.

Это расположение по умолчанию определяется значением Last Directory в разделе HKEY_CURRENT_USER\Software\Microsoft\Trace32 реестра. Если для клиентов задано значение , %windir%\CCM\Logs CMTrace открывает файлы в расположении журнала клиента при первом запуске.

Дальнейшие действия

OneTrace — это средство просмотра журналов в Центре поддержки. Он работает аналогично CMTrace с улучшениями. Дополнительные сведения см. в разделе Центр поддержки OneTrace.