VSPerfCmd
Средство VSPerfCmd.exe используется для запуска и остановки сбора данных о производительности.Для этого используется следующий синтаксис.
VSPerfCmd [/U] [/options]
В следующих таблицах описываются параметры средства VSPerfCmd.exe.
Команда |
Описание |
|---|---|
U |
Перенаправленный вывод на консоль записывается в кодировке Юникода.Этот параметр необходимо указывать первым. |
Start:mode |
Запускает службу профилирования в заданном режиме. |
Output:filename |
Задает имя выходного файла.Используйте только с Start. |
Включает профилирование в нескольких сеансах Windows.Используйте только с Start, Attach, or Launch. |
|
Пользователь:[domain\]username |
Включает доступ к службе профилировщика для заданной учетной записи.Используйте только с Start. |
WaitStart[:n] |
Ожидает инициализации средство ведения журнала сбора данных.Если указано значение n, средство VSPerfCmd будет ожидать не более n секунд.Если значение n не указано, средство VSPerfCmd ожидает в течение неограниченного периода.Это упрощает использование средства VSPerfCmd в составе пакетного процесса. |
Счетчик:cfg |
При использовании метода профилирования с выборкой указывает на счетчик ЦП и количество событий, которое должно использоваться в качестве интервала выборки.Можно указать только одно значение счетчика. При использовании метода профилирования с инструментированием указывает на счетчик ЦП, значение которого требуется собирать в каждой точке инструментирования.Используйте только с Start:Trace, Attach,или Launch. |
Отображение списка допустимых счетчиков ЦП для текущего компьютера. |
|
WinCounter:path |
Задает событие счетчика производительности Windows, которое следует включить в данные меток профилирования.Используйте только с Start. |
Задает интервал времени (в миллисекундах) между событиями сбора данных счетчика производительности Windows.Используйте с WinCounter. |
|
События:option |
Управляет получением заданной трассировки событий Windows.Данные трассировки событий Windows собираются в файл ITL, который отличается от файлов данных профилирования (VSP). |
Отображает состояние профилировщика, сведения о профилируемых в настоящий момент процессах и учетные записи, которые имеют разрешения на управление профилировщиком. |
|
Shutdown[:n] |
Закрывает файл данных профилирования и отключает профилировщик. |
Возобновляет сбор данных после вызова VSPerfCmdGlobalOff. |
|
Останавливает сбор всех данных, но не завершает сеанс профилирования. |
|
ProcessOn:pid |
Возобновляет сбор данных для заданного процесса, после того как профилирование было приостановлено путем вызова VSPerfCmdProcessOff. |
ProcessOff:pid |
Останавливает сбор данных для заданного процесса. |
Возобновляет профилирование для заданного процесса, после того как профилирование было приостановлено путем вызова VSPerfCmdThreadOff.Используйте параметр ThreadOn только при профилировании методом инструментирования. |
|
Приостанавливает профилирование для заданного потока.Используйте параметр ThreadOff только при профилировании методом инструментирования. |
|
Метка:MarkNum[,MarkText] |
Вставляет метку с необязательным текстом в файл данных профилирования. |
Параметры метода профилирования с выборкой
Следующие параметры доступны только при использовании метода профилирования с выборкой.
Команда |
Описание |
|---|---|
Запуск:Executable |
Запускает заданное приложение и начинает профилирование. |
Args:Arguments |
Задает аргументы командной строки для передачи в запущенное приложение. |
Запускает указанную команду в новом окне командной строки. |
|
Attach:PID[,PID] |
Начинает профилирование указанного процесса.Процессы можно задавать с помощью идентификатора или имени процесса. |
Detach[:PID[,PID]] |
Останавливает профилирование указанного процесса.Процессы можно задавать с помощью идентификатора или имени процесса.Если процесс не указан, профилирование останавливается для всех процессов. |
GC[:{Allocation|Lifetime}] |
Собирает данные о выделении памяти для объектов .NET и времени их существования.Используйте только с VSPerfCmdLaunch. |
Параметры интервала выборки
Следующие параметры определяют тип и продолжительность интервалов выборки.Значение по умолчанию — Timer.Кроме того, можно с помощью параметра Counter задать в качестве интервала счетчик ЦП.Эти параметры можно задавать только с параметром Launch или с первым параметром Attach сеанса профилирования.
Команда |
Описание |
|---|---|
Параметр PF[:n] |
Выборка осуществляется на каждой n-ой ошибке страницы (значение по умолчанию=10). |
Sys (VSPerfCmd)[:n] |
Выборка осуществляется при каждом n-ом системном вызове (значение по умолчанию=10). |
Timer[:n] |
Выборка осуществляется на каждом n-ом цикле процессора (значение по умолчанию=10000000). |
Параметры компонентов служб и драйверов устройств, работающих в режиме ядра
Перечисленные ниже параметры Admin поддерживают компоненты служб профилирования или работающие в режиме ядра драйверы устройств.Параметры Admin задают разрешения профилирования и управляют профилируемой службой или драйвером устройства.
Параметры Admin следует использовать в командной строке, работающей от имени учетной записи с правами администратора.
Команда |
Описание |
|---|---|
Admin:Security <ALLOW|DENY> Right[ Right] <User|Group> |
Запрет или разрешение доступа к службам профилирования для указанного пользователя или группы. Параметр Right может принимать следующие значения: CrossSession — предоставляет пользователю доступ к службе для выполнения профилирования в нескольких сеансах. SampleProfiling — предоставляет пользователю доступ к драйверу для включения профилирования с выборкой;также используется для доступа к сведениям о переходе в режим ядра и выходе из этого режима во время профилирования с трассировкой. FullAccess — предоставляет пользователю права, определяемые параметрами CrossSession и SampleProfiling. |
Admin:Security, List |
Создает список текущих состояний служб профилирования и разрешений пользователей. |
Admin:<Service|Driver><START|STOP|INSTALL|UNINSTALL> |
Запуск, остановка, установка или удаление службы профилирования (service) или работающего в режиме ядра драйвера устройства (driver). |
Admin:<Service|Driver>AutoStart<ON|OFF> |
Включение или выключение автоматического запуска службы профилирования (service) или работающего в режиме ядра драйвера устройства (driver) после перезапуска системы. |
VSPerfCmd /Driver
Параметр VSPerfCmd /Driver устарел.Вместо него следует использовать параметры VsPerfCmdAdmin.