VSPerfReport
Обновлен: Ноябрь 2007
Средство командной строки VSPerfReport используется для создания отчетов на основе файлов данных профилирования Сред. профилирования Visual Studio Team System Developer Edition. По умолчанию отчет сохраняется в CSV-файле.
В средстве VSPerfReport используется следующий синтаксис.
VSPerfReport [/U] vspfilename [/options]
Обратите внимание, что параметр filename должен представлять допустимый файл VSP или VSPS.
Средство командной строки VSPerfReport используется также для сравнения файлов VSP или VSPS. Для создания отчета о различиях ("diff"), используется следующий синтаксис.
VSPerfReport [/U] /diff vspfilename1 vspfilename2 [/options]
vspfilename1 and vspfilename2 — допустимый файл VSP или VSPS.
Общие параметры отчетов
В следующей таблице представлены общие параметры форматирования отчетов и параметры для выбора данных, на основе которых формируется отчет.
Параметры |
Описание |
|---|---|
U |
Выходные данные отчета и вывод, перенаправленный на консоль, представляются в кодировке Юникода. Этот параметр необходимо указывать первым. |
SUMMARY:[типы] |
Создает один или несколько типов отчетов. ALL — создаются отчеты всех типов. CallerCallee — в отчете содержатся отношения "родитель-потомок" между функциями. Function — в отчете содержатся вызвавшиеся функции. Module — в отчете содержатся модули, для которых выполнено профилирование. CallTree — в отчете содержится иерархия вызывавшихся функций. Thread — в отчете содержатся потоки, для которых выполнено профилирование. Process — в отчете содержатся процессы, для которых выполнено профилирование. Type — в отчете содержатся типы, для которых выделена память. Header — в отчете содержатся сведения о файле заголовка. Mark — в отчете содержатся все метки. Counter — в отчете содержатся все метки со значениями счетчиков. Ip — в отчете содержатся данные об инструкциях, которые выполнялись во время профилирования. Life — в отчете содержится время существования объектов, для которых выделяется память (отчет доступен в случае сбора данных о выделении памяти). Line — в отчете содержатся данные о строках исходного кода, для которых выполнено профилирование. |
XML |
Отчет выводится в формате XML. |
CALLTRACE |
Создается список входов и выходов функций, событий трассировки событий Windows и меток. |
CLEARPACKEDSYMBOLS |
Удаляет ранее упакованные символы из файла отчета. |
SYMBOLPATH:path |
Расположение символов. |
DEBUGSYMPATH |
Определяет, в каких расположениях выполняется поиск символов. |
PACKSYMBOLS |
Упаковка символов в файл отчета после анализа. |
OUTPUT:путь|имя_файла |
Расположение файла отчета. |
SUMMARYFILEe |
Анализ и сохранение проанализированных данных в сводном VSPS-файле. |
PRINTMARKS |
Отображение имен и отметок времени для всех меток в указанном файле отчета. |
PRINTMARKS |
Отчет содержит имена и отметки времени для всех меток. |
? |
Отображаются сведения об использовании. |
NOLOGO |
Скрываются сведения о версии во время выполнения отчета. |
Параметры фильтрации
В следующей таблице описаны параметры для фильтрации доступных данных.
Параметры |
Описание |
|---|---|
STARTTIME:[значение] |
Отображаются только данные, собранные после значения "value" (в миллисекундах). |
ENDTIME:[значение] |
Отображаются только данные, собранные до значения "value" (в миллисекундах). |
MSFILTER:[время_запуска,длительность] |
Отображаются только данные, собранные в период от STARTTIME до конца интервала, определяемого длительностью "duration" (в миллисекундах). |
PROCESS:[pid] |
Отображаются только данные из указанного процесса. |
THREAD:[ид_потока] |
Отображаются только данные из указанного потока. |
THREAD:[ид_потока,ид_процесса] |
Отображаются только данные из указанного потока, связанного с указанным процессом. |
Параметры отчета о различиях
В следующей таблице описаны параметры для сравнения файлов отчетов.
Параметры |
Описание |
|---|---|
DIFF |
Выполняет сравнение двух файла отчетов (VSP или VSPS). При использовании параметра diff будут игнорироваться параметры сводки. |
DIFFTHRESHOLD:[значение] |
Различия между двумя значениями, не превышающие указанный порог, не учитываются. Кроме того, не отображаются значения ниже данного порога. |
DIFFTABLE:[имя_таблицы] |
Для сравнения файлов используется указанная таблица. По умолчанию используется таблица функций. |
DIFFCOLUMN:[имя_столбца] |
Для сравнения значений используется указанный столбец. По умолчанию используется столбец, содержащий процентное значение исключительного времени. |
QUERYDIFFTABLES |
Список допустимых таблиц и столбцов, предоставленных для двух файлов отчетов. |