Команды элемента управления TraceView
Примечание.
Параметры командной строки TraceView устарели. Используйте tracepdb.exe и tracefmt.exe для синтаксического анализа PDF-файлов и анализа ETL-файлов в текст соответственно.content
Используйте команду элемента управления Traceview для управления сеансами трассировки, включая запуск и остановку сеанса, включение и отключение поставщиков, обновление свойств сеанса трассировки и очистку буферов трассировки.
traceview {-start | -stop | -update | -enable | -disable | -flush | -q} SessionName [Parameters]
traceview {-enumguid | -l | -h | -x}
Параметры команд
Действия
Параметры
Имя сеанса
При использовании с -start Имя сеанса — это имя, выбранное для представления сеанса трассировки. При использовании всех других команд Имя сеанса определяет сеанс трассировки.
-f [LogFile]
При использовании с -start -f запускает сеансы журнала трассировки. LogFile указывает путь (необязательно) и имя файла журнала трассировки событий (etl). Значение по умолчанию — C:\LogFile.etl.
При использовании с -update -f отправляет все новые сообщения трассировки только в указанный журнал трассировки. Используйте этот параметр для преобразования сеанса трассировки в сеанс журнала трассировки в режиме реального времени или запуска нового журнала трассировки для существующего сеанса журнала трассировки. Чтобы отправлять сообщения трассировки в потребитель трассировки в режиме реального времени и в журнал трассировки, используйте параметры -rt и -f в команде -update .
-rt
При использовании с -start -rt запускает сеансы трассировки в режиме реального времени (сеанс журнала трассировки (-f) — это значение по умолчанию.) При использовании -rt и -f в команде -start сообщения трассировки отправляются потребителю трассировки и файлу журнала трассировки событий.
При использовании с -update -rt добавляет доставку сообщений в режиме реального времени в сеанс журнала трассировки. Все новые сообщения трассировки отправляются непосредственно потребителю трассировки (как в сеансе трассировки в режиме реального времени) в дополнение к журналу трассировки.
-guid {#GUID GUIDFile | }
Указывает один или несколько поставщиков трассировки. Используйте функцию -start для включения поставщиков для сеанса трассировки. Используйте функцию -enable для включения поставщиков или изменения их значений флага или уровня . Используйте функцию -disable , чтобы указать поставщиков для отключения.
GUID может указать один guid элемента управления (перед символом числа (#)) или путь (необязательно) и имя файла текстового файла, например GUID элемента управления (ctl), который содержит идентификаторы guid элемента управления одного или нескольких поставщиков трассировки.
Если не указан параметр -guid из команды -start , TraceView запускает сеанс трассировки средства ведения журнала ядра NT.
TraceView передает значения следующих подпараметров указанным поставщикам.
| Параметр | Описание |
|---|---|
| Имя сеанса | При использовании с -start Имя сеанса — это имя, выбранное для представления сеанса трассировки. При использовании всех других команд Имя сеанса определяет сеанс трассировки. |
| -f \[LogFile\] | При использовании с -start -f запускает сеансы журнала трассировки. LogFile указывает путь (необязательно) и имя файла журнала трассировки событий (etl). Значение по умолчанию — C:\\LogFile.etl. При использовании с -update -f отправляет все новые сообщения трассировки только в указанный [журнал трассировки](trace-log.md). Используйте этот параметр для преобразования сеанса трассировки в сеанс журнала трассировки в режиме реального времени или запуска нового журнала трассировки для существующего сеанса журнала трассировки. Чтобы отправлять сообщения трассировки в потребитель трассировки в режиме реального времени и в журнал трассировки, используйте параметры -rt и -f в команде -update . |
| -rt | При использовании с -start -rt запускает сеансы трассировки в режиме реального времени (сеанс журнала трассировки (-f) — это значение по умолчанию.) При использовании -rt и -f в команде -start сообщения трассировки отправляются потребителю трассировки и файлу журнала трассировки событий. При использовании с -update -rt добавляет доставку сообщений в режиме реального времени в сеанс журнала трассировки. Все новые сообщения трассировки отправляются непосредственно потребителю трассировки (как в сеансе трассировки в режиме реального времени) в дополнение к [журналу трассировки](trace-log.md). |
| -guid {\#GUID GUIDFile | } | Указывает один или несколько поставщиков трассировки. Используйте функцию -start для включения поставщиков для сеанса трассировки. Используйте функцию -enable для включения поставщиков или изменения их значений флага или уровня . Используйте функцию -disable , чтобы указать поставщиков для отключения. GUID может указать один [control GUID](control-guid.md) (перед символом номера (\#)) или путь (необязательно) и имя файла текстового файла, например GUID элемента управления (CTL), который содержит идентификаторы GUID элемента управления одного или нескольких поставщиков трассировки. Если вы опустите параметр -guid из команды -start , TraceView запускает [сеанс трассировки средства ведения журнала ядра NT](nt-kernel-logger-trace-session.md). |
TraceView передает значения следующих подпараметров указанному поставщику:
-b BufferSize
Задает размер в КБ каждого буфера, выделенного для сеанса трассировки. Используйте только с -start.
Значение по умолчанию определяется количеством процессоров, объемом физической памяти и используемой операционной системой.
-Мин NumberOfBuffers
Указывает количество буферов, изначально выделенных для хранения сообщений трассировки. Используйте только с -start.
Значение по умолчанию определяется количеством процессоров, объемом физической памяти и используемой операционной системой.
-Макс NumberOfBuffers
При использовании с -start значение -max указывает максимальное количество буферов, выделенных для сеанса трассировки. Значение по умолчанию определяется количеством процессоров, объемом физической памяти и используемой операционной системой.
При использовании с -update значение -max изменяет максимальное количество буферов, выделенных для сеанса трассировки.
-фут FlushTime
Если используется с -start, -ft указывает, как часто буферы сообщений трассировки удаляются в секундах. При использовании с -update - ft изменяет время очистки до указанного времени.
Минимальное время очистки составляет 1 секунду. Значение по умолчанию равно 0 (без принудительного сброса).
Это принудительное очистка в дополнение к очисткам, которые происходят автоматически при заполнении буфера сообщения трассировки и при остановке сеанса трассировки.
См. также: -flush.
-Вызвала
Использует страницируемую память для буферов сообщений трассировки. По умолчанию трассировка событий использует неизменяемую память для буферов. Используйте только с -start.
Не используйте этот параметр, если поставщик является драйвером, который может создавать сообщения трассировки в IRQL больше DISPATCH_LEVEL.
Этот параметр не поддерживается в Windows 2000.
-последовательный MaxFileSize
Указывает последовательное ведение журнала (в конце файла, остановка записи событий) в файл журнала трассировки событий (etl). Используйте только с -start.
MaxFileSize указывает максимальный размер файла в МБ. Без значения MaxFileSize этот параметр игнорируется.
Последовательное ведение журнала — это значение по умолчанию, но этот параметр можно использовать для задания максимального размера файла или использования -prealloc. Без этого параметра нет ограничения размера файла.
-циркуляция MaxFileSize
Указывает циклическое ведение журнала (в конце файла, запись новых сообщений по старым сообщениям) в файле журнала трассировки событий (etl). Используйте только с -start.
MaxFileSize указывает максимальный размер файла в МБ. Без значения MaxFileSize этот параметр игнорируется.
Значение по умолчанию — это последовательное ведение журнала без ограничения размера файла.
-prealloc
Резервирует место для файла журнала трассировки событий (ETL) перед его выделением. Используйте только с -start.
Для этого параметра требуется -seq или -cir с MaxFileSize. Недопустимый файл - newfile.
Флаг представляет значение флага , определенное в поставщике трассировки в десятичном или шестнадцатеричном формате. Значение по умолчанию равно 0. Значения от 0x01000000 до 0xFF000000 зарезервированы для дальнейшего использования.
Значение флагов определяется независимо каждым поставщиком трассировки. Как правило, флаги представляют все более подробные уровни отчетности.
В команде -start значение флагов применяется ко всем поставщикам трассировки в сеансе трассировки. Чтобы задать разные флаги для каждого поставщика трассировки, используйте отдельную команду -enable для каждого поставщика трассировки.
| Подпараметры guid | Description |
|---|---|
-flag Flag |
|
|
Уровень -level |
Задает уровень трассировки для поставщиков в сеансе трассировки. Уровень определяет, какие события генерирует поставщик трассировки. Уровень представляет значение уровня в десятичном или шестнадцатеричном формате. Значение по умолчанию равно 0. Значение значения уровня определяется независимо каждым поставщиком трассировки. Как правило, уровень трассировки представляет серьезность события (сведения, предупреждение или ошибка). В команде -start значение уровня применяется ко всем поставщикам трассировки в сеансе трассировки. Чтобы задать разные уровни для каждого поставщика трассировки, используйте отдельную команду -enable для каждого поставщика трассировки. |
| -b BufferSize | Задает размер в КБ каждого буфера, выделенного для сеанса трассировки. Используйте только с -start.
Значение по умолчанию определяется количеством процессоров, объемом физической памяти и используемой операционной системой. |
| -min NumberOfBuffers | Указывает количество буферов, изначально выделенных для хранения сообщений трассировки. Используйте только с -start.
Значение по умолчанию определяется количеством процессоров, объемом физической памяти и используемой операционной системой. |
| -max NumberOfBuffers | При использовании с -start значение -max указывает максимальное количество буферов, выделенных для сеанса трассировки. Значение по умолчанию определяется количеством процессоров, объемом физической памяти и используемой операционной системой.
При использовании с -update значение -max изменяет максимальное количество буферов, выделенных для сеанса трассировки. |
| -ft FlushTime | Если используется с -start, -ft указывает, как часто буферы сообщений трассировки удаляются в секундах. При использовании с -update - ft изменяет время очистки до указанного времени.
Минимальное время очистки составляет 1 секунду. Значение по умолчанию равно 0 (без принудительного сброса). Это принудительное очистка в дополнение к очисткам, которые происходят автоматически при заполнении буфера сообщения трассировки и при остановке сеанса трассировки. См. также: -flush. |
| -age AgeLimit | Если используется с -start, -age указывает, сколько времени (в минутах) неиспользуемые буферы трассировки хранятся до их освобождения. При использовании с -update -age изменяет предел возраста на указанное значение.
Ограничение возраста указывает, сколько времени (в минутах) неиспользуемые буферы трассировки хранятся до их освобождения. Значение по умолчанию — 15 минут. Этот параметр действителен только в Windows 2000. |
| -Вызвала | Использует страницируемую память для буферов сообщений трассировки. По умолчанию трассировка событий использует неизменяемую память для буферов. Используйте только с -start.
Не используйте этот параметр, если поставщик является драйвером, который может создавать сообщения трассировки в IRQL больше, чем DISPATCH\_LEVEL. Этот параметр не поддерживается в Windows 2000. |
| -seq MaxFileSize | Указывает последовательное ведение журнала (в конце файла, остановка записи событий) в файл журнала трассировки событий (etl). Используйте только с -start.
MaxFileSize указывает максимальный размер файла в МБ. Без значения MaxFileSize этот параметр игнорируется. Последовательное ведение журнала — это значение по умолчанию, но этот параметр можно использовать для задания максимального размера файла или использования -prealloc. Без этого параметра нет ограничения размера файла. |
| -cir MaxFileSize | Указывает циклическое ведение журнала (в конце файла, запись новых сообщений по старым сообщениям) в файле журнала трассировки событий (etl). Используйте только с -start.
MaxFileSize указывает максимальный размер файла в МБ. Без значения MaxFileSize этот параметр игнорируется. Значение по умолчанию — это последовательное ведение журнала без ограничения размера файла. |
| -prealloc | Резервирует место для файла журнала трассировки событий (ETL) перед его выделением. Используйте только с -start.
Для этого параметра требуется -seq или -cir с MaxFileSize. Недопустимый файл - newfile. Система создает файл журнала трассировки событий (etl) с размером, равным значению MaxFileSize , указанному с помощью параметров -seq или -cir . При остановке сеанса файл журнала уменьшается до размера его содержимого. |
| -newfile MaxFileSize | Создает новый файл журнала трассировки событий (etl), когда существующий файл достигает MaxFileSize. Используйте только с -start.
MaxFileSize указывает максимальный размер каждого файла журнала в МБ. Без значения MaxFileSize этот параметр игнорируется. При использовании -newfile необходимо также использовать параметр -f LogFile, а значение LogFile должно быть именем, которое содержит символы %d, указывающее десятичный шаблон, например trace%d.etl. В противном случае команда завершается ошибкой с помощью ERROR\_INVALID\_NAME. Windows увеличивает десятичное значение в имени файла при каждом создании нового файла. Этот параметр недопустим с предварительным размещением (-prealloc logging (-cir), сеансом ведения журнала ядра NT или для частных сеансов трассировки. Он не поддерживается в Windows 2000. |
| -прибавлять | Добавляет сообщения трассировки в существующий файл журнала трассировки событий (etl). По умолчанию создается новый файл. Используйте только с -start.
Этот параметр действителен только для последовательных файлов, и только если используется -f и -rt не используется. Он не поддерживается в Windows 2000. |
| -kd | Перенаправляет сообщения трассировки в KD или Windbg, независимо от того, что подключено. Этот параметр также задает размер буфера трассировки в 3 КБ, максимальный размер буфера для отладчика и игнорирует все параметры -b в команде. Используйте только с -start. |
Комментарии
Команда traceview без параметров открывает окно TraceView.
Для запуска сеанса трассировки глобального средства ведения журнала можно использовать команду TraceView -start. Для этого используйте следующий формат команды. В отличие от других команд, слово GlobalLogger в этом формате команды учитывает регистр.
traceview -start GlobalLogger [parameters]