Поделиться через


start

Отображает параметры запуска средства ведения журнала.

xperf [-start [LoggerName] [ProfileFileName!ProfileName|SessionName]|-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] -flush [LoggerName] -save ProfileFileName!ProfileName|SessionName merged.etl -setprofint [<n>] [cached] -seteresourcesample <n1> <n2> <n3> -setspinlocksample <n1> <n2> <n3> -pooltag <P1>+<P2>+<P3>+<P4> -on (GUID|KnownProviderName)[:Flags[:Level[<:0xnnnnnnnn|’stack|[,]sid[,]tsid’]]]

Параметры

Команда Description

-start [LoggerName]|[ ProfileFileName! ProfileName|SessionName]]

Запускает сеанс ведения журнала для LoggerName, запускает журналы в profileName, определенный в файле ProfileFileName, или запускает имя сеанса ведения журнала, определенное в файле ProfileFileName.

-update [LoggerName]|[ ProfileFileName! ProfileName|SessionName]]

Обновляет сеанс ведения журнала для LoggerName, обновляет средства ведения журнала в профиле ProfileName, определенный в файле ProfileFileName, или обновляет имя сеанса ведения журнала, определенное в файле ProfileFileName.

-flush LoggerName

Очищает сеанс ведения журнала для LoggerName. Этот параметр необходим для сохранения трассировки буферного режима (см . параметр буферизации ниже). Чтобы сохранить трассировку режима буфера, необходимо выдать параметр -flush .

-capturestate LoggerName Flags

Записывает состояние в сеанс ведения журналов, отличный от ядра, от поставщиков, указанных в флагах. Допустимый формат поставщика совпадает с форматом - on. Если заданы флаги и уровни, они включены при записи состояния.

Это вызывается для трассировки, запущенной с параметром буферизации . За ним должно следовать –остановить трассировку.

-on Flags |Группы

Для сеансов ведения журнала ядра последовательность флагов и групп ядра, разделенных знаками плюса (+). Для сеансов ведения журнала пользователей последовательность поставщиков, разделенная знаками плюса (+). Допустимый формат поставщика.(GUID|KnownProviderName)[:Flags[:Level]] Ознакомьтесь с поставщиками списка допустимых флагов.

-f имя файла

Записывает события в указанный файл. Значение по умолчанию — \Kernel.etl для трассировок ядра и \User.etl для трассировок пользователей.

-buffersize Size

Задает размер буфера трассировки в кб. Возможные значения : 4–1024. Значение по умолчанию — 64.

-minbuffers n

Задает минимальное количество буферов трассировки на n. Значение по умолчанию — 64.

-maxbuffers n

Задает максимальное количество буферов трассировки на n. Значение по умолчанию — 320.

-maxfile Size

Задает максимальный размер файла в мб .

-flushtimer n

Задает таймер очистки на n секунд.

-boottrace Flags |Группы|off

Настраивает трассировку событий для средства ведения журнала Windows для трассировки загрузки. Установите флажки "отключить", чтобы отключить трассировку загрузки. Все элемент управления ведением журнала можно использовать вместе с этим. Используйте в сочетании с -f для входа в файл, отличный от \Perf.etl.

-realtime

Включает трассировку в режиме реального времени.

-буферизация

Включает трассировку режима буферизации. Чтобы сохранить, используйте -flush. Параметр -stop не сохраняет трассировку.

Режим -filemode

Задает режим файла. Значение по умолчанию — "Последовательный". Возможные режимы: "Последовательный", "Цикл", "Добавление" и "NewFile".

-clocktype ClockType

Задает тип часов. Значение по умолчанию — PerfCounter. Возможные типы: Cycle, PerfCounter и SystemTime.

-stackwalk flags |@file

Включает стек для событий, указанных как Flag+..., или анализирует файл для флагов. Дополнительные сведения см. в разделе stackwalk.

-pids pid [...]

Применяет флаги к процессам pid [...]. Используется в сочетании с частными средствами ведения журнала.

При указании нескольких pids разделите их пробелом, как и в -Pids 1234 6789

-pidnewprocess <command-line>

Применяет флаги к новому процессу, который Xperf начнется с <командной строки>. Используется в сочетании с частными средствами ведения журнала.

-waitfornewprocess

Ожидает, пока новый процесс, созданный с помощью -pidNewProcess , возвращается перед выходом.

-куча

Включает трассировку кучи в процессах, указанных Pids и PidNewProcess.

-critsec

Включает трассировку критических разделов в процессах, указанных Pids и PidNewProcess.

-setprofint [<n>] [cached]

Задает интервал <n> [1221..10000000]выборки профиля в значение . Если кэшируется, интервалы кэшируются в ETW и повторно применяются при каждом запуске новых средств ведения журнала ядра ETW с примерами профиля. Единицы — 100 000. Значение по умолчанию для n равно 10000; то есть 1 мс: не кэшировано.

-save ProfileFileName! ProfileName|SessionName merged.etl

Удаляет средства ведения журнала в profileName, определенный в файле ProfileFileName, и объединяет файлы ETL в merge.etl; или очищает имя сеанса ведения журнала, определенное в файле ProfileFileName, и объединяет файл ETL с Merged.etl.

-seteresourcesample <n1><n2><n3>

Задает выборку ERESOURCE, где частота выборки выпуска n1 больше или равна 1000, частота выборки n2 больше или равно 1, а число чрезмерных тайм-аутов больше или равно 1. Частота конфликтов — это скорость получения событий спинлока при возникновении столкновений. Например, если это значение равно 100, то для каждой сотни конфликтов спин-блокировки приобретается одно событие спин-блокировки.

-setspinlocksample <n1><n2><n3>

Задает пороговую группу <n1> [ >=1]спина спина в спине. Задает скорость <n2> [ >= 1000]получения выборки в спинлоке. Задает частоту <n3> [ >= 1]выборки разблокировки. Только 64-разрядная версия Windows 7, Windows Server 2008 R2 и более новые версии операционной системы поддерживают инструментирование спинлока.

-pooltag <P1>+P2>+<<P3>+<P4>

Задает фильтры тегов пула (Pn), разделенные знаками плюса (+) или точкой с запятой (;). Используйте вопросительный знак (?) для подстановочного знака с одним символом или звездочки (*) для подстановочного знака с несколькими символами. Можно указать не более четырех фильтров.

Замечания

Несколько средств ведения журнала можно запустить с помощью нескольких параметров запуска, каждый из которых следует применить к этому средству ведения журнала. Если параметр LoggerName или -start LoggerName опущен, средство ведения журнала ядра подразумевается. В любое время может существовать только один экземпляр средства ведения журнала ядра. Если один из средств ведения журнала не запускается, все средства ведения журнала, которые уже запущены, остановлены.

Параметры Xperf