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

VSPerfReport

  • Статья

Программа командной строки VSPerfReport используется для создания отчетов с помощью Средств профилирования Visual Studio, осуществляющих профилирование файлов данных.По умолчанию отчет сохраняется в CSV-файле.

В средстве VSPerfReport используется следующий синтаксис.

VSPerfReport [/U] vspfilename [/options]

Обратите внимание, что параметр filename должен представлять допустимый файл VSP или VSPS.

Средство командной строки VSPerfReport используется также для сравнения файлов VSP или VSPS.Для создания отчета о различиях ("diff"), используется следующий синтаксис.

VSPerfReport [/U] /diff vspfilename1 vspfilename2 [/options]

vspfilename1 and vspfilename2 — допустимый файл VSP или VSPS.

Файлы символов

Для отображения символьных данных, например имен функций и номеров строк, средству VSPerfReport требуется доступ к файлам символов (PDB) профилируемых компонентов и к файлам символов Windows.Дополнительные сведения см. в разделе Практическое руководство. Определение расположения файлов символов с помощью командной строки.

Общие параметры отчетов

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

Параметры

Описание

U

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

Summary:[типы]

Создает один или несколько типов отчетов.

  • All — создаются отчеты всех типов.

  • CallerCallee — отношения "родитель-потомок" между функциями.

  • Function— вызываемые функции.

  • CallTree — иерархия вызываемых функций.

  • Counter — все метки и значения счетчиков производительности Windows.

  • Ip — профилируемые инструкции.

  • Life — время существования объектов, для которых выделяется память (отчет доступен в случае сбора данных о выделении памяти).

  • Line — данные о строках исходного кода, для которых выполнено профилирование.

  • Header — в отчете содержатся сведения о файле заголовка.

  • Mark— все метки.

  • Module — профилируемые модули.

  • Process — профилируемые процессы.

  • Thread — профилируемые потоки.

  • Type — типы, для которых выделялась память.

  • Contention — конфликты обращения к ресурсам.

  • RuleWarnings — проблемы правил производительности.

  • ETW — все события трассировки событий Windows, собранные в ходе сеанса профилирования.Файлы данных ETL должны находиться в исходном расположении или в каталоге с файлом VSP или VSPS.

Xml

Отчет выводится в формате XML.

CallTrace

Создается список входов и выходов функций, событий трассировки событий Windows и меток.

ClearPackedSymbols

Удаляет ранее внедренные символы из файла данных профилировщика.Эту команду необходимо выполнить перед повторным выполнением PackSymbols.

SymbolPath:path

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

DebugSymPath

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

PackSymbols

Сохраняет символы в файл данных профилирования (VSP), чтобы файлы символов (PDB) не требовались для анализа.

Output:путь|filename

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

SummaryFile

Анализ и сохранение проанализированных данных в сводном VSPS-файле.

PrintMarks

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

?

Вывод сведений об использовании.

NoLogo

Скрываются сведения о версии во время выполнения отчета.

UserRulesDirectory

Задает каталог, содержащий пользовательские правила производительности [еще не реализован].

Параметры фильтрации

В следующей таблице описаны параметры для фильтрации доступных данных.

Параметры

Описание

JustMyCode[:[caller][,callee]]

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

  • Без параметров — скрывать все системные функции.

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

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

StartTime:[значение]

Отображаются только данные, собранные после значения "value" (в миллисекундах).

EndTime:[значение]

Отображаются только данные, собранные до значения "value" (в миллисекундах).

FilterFile:VSPFFile

Задает расположение файла фильтра, созданного в окне Отчет производительности Visual Studio.

MsFilter:[время_запуска,длительность]

Отображаются только данные, собранные в период c starttime до конца интервала duration (в миллисекундах).

Process:[pid]

Отображаются только данные из указанного процесса.

Thread:[ид_потока]

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

Thread:[ид_потока,ид_процесса]

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

Параметры отчета о различиях

В следующей таблице описаны параметры для сравнения файлов отчетов.

Параметры

Описание

Diff vspfile1 vspfile2

Выполняет сравнение двух файла отчетов (VSP или VSPS).При использовании параметра diff будут игнорироваться параметры сводки.

Diff:[значение]

Различия между двумя значениями, не превышающие указанный порог, не учитываются.Кроме того, не отображаются значения ниже данного порога.

DiffTable:[имя_таблицы]

Для сравнения файлов используется указанная таблица.По умолчанию используется таблица функций.

DiffColumn:[имя_столбца]

Для сравнения значений используется указанный столбец.Значение по умолчанию - столбец процента исключающих измерений.

QueryDiffTables

Список допустимых таблиц и столбцов, предоставленных для двух файлов отчетов.

См. также

Другие ресурсы

Представления отчетов средств профилирования