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

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

  • Статья

В этом разделе описан порядок использования программ командной строки средств профилирования Visual Studio для присоединения профилировщика к службе .NET Framework и сбора данных о параллелизме потоков и процессов с помощью метода выборки.

ПримечаниеПримечание

Функции усиленной безопасности в Windows 8 и Windows server 2012 требуют значительных изменений в том, как профилировщик Visual Studio выполняет сбор данных на этих платформах.Приложения хранилища Windows также требуют новых методов коллекции.Дополнительные сведения см. в разделе Профилирование приложений для Windows 8 и Windows Server 2012.
ПримечаниеПримечание

Программы командной строки средств профилирования расположены в подкаталоге \Team Tools\Performance Tools каталога установки Visual Studio.На 64-разрядных компьютерах доступны 64-разрядные и 32-разрядные версии программ.Для использования программ командной строки профилировщика необходимо добавить путь к этим программам в переменную среды PATH окна командной строки или указать этот путь при вызове команды.Дополнительные сведения см. в разделе Указание пути к программам командной строки средств профилирования.

Для сбора данных о параллелизме, профилировщик вложение в процесс службы.Пока профилировщик присоединен к службе, можно приостанавливать и возобновлять сбор данных.Чтобы завершить сеанс профилирования, необходимо отсоединить профилировщик от службы и явным образом завершить его работу.В большинстве случаев рекомендуется удалять в конце сеанса значения переменных среды, используемые для профилирования.

Присоединение профилировщика

Присоединение профилировщика к службе .NET Framework

  1. Установите службу.

  2. Откройте окно командной строки.

  3. Инициализируйте переменные среды, используемые для профилирования.Type:

    VSPerfClrEnv/globalsampleon [/samplelineoff]

    • Параметр /globalsampleon включает выборку.

    • /samplelineoff отключает связывание собранных данных с определенными строками исходного кода.При выборе этого параметра данные назначаются только функциям.

  4. Перезагрузите компьютер.

  5. Запустите профилировщик.Type:

    VSPerfCmd/start:concurrency **/output:**OutputFile [Options]

    Параметр /output**:**OutputFile является обязательным при использовании параметра /start.Параметр OutputFile задает имя и расположение файла с данными профилирования (VSP-файла).

    С параметром /start можно использовать любые из следующих параметров.

    ПримечаниеПримечание

    Обычно параметры /user и /crosssession являются обязательными для служб.

    Параметр

    Описание

    /user:[Domain\]UserName

    Задает домен и имя пользователя учетной записи, которая является владельцем профилируемого процесса.Этот параметр является обязательным только в том случае, если процесс выполняется от имени пользователя, отличного от пользователя, который выполнил вход в систему.Имя владельца процесса отображается в столбце "Имя пользователя" на вкладке "Процессы" диспетчера задач Windows.

    /crosssession

    Включает профилирование процессов в других сеансах.Этот параметр является обязательным, если служба выполняется в рамках другого сеанса.Идентификатор сеанса отображается в столбце "Код сеанса" на вкладке "Процессы" диспетчера задач Windows.Для /crosssession может быть задано сокращение /CS.

    /wincounter:WinCounterPath

    Задает счетчик производительности Windows, данные которого следует собирать в процессе профилирования.

    /automark:Interval

    Используйте только с /wincounter.Задает интервал времени (в миллисекундах) между событиями сбора данных счетчика производительности Windows.Значение по умолчанию — 500 мс.

    /events:Config

    Задает событие трассировки событий Windows, данные которого следует собирать в процессе профилирования.События трассировки событий Windows собираются в отдельный ETL-файл.

  6. Если необходимо, запустите службу.

  7. Присоедините профилировщик к службе.Type:

    **VSPerfCmd /attach:PID [/targetclr:**Version]

    • Параметр PID задает идентификатор или имя процесса службы.Диспетчер задач Windows позволяет просмотреть идентификаторы всех запущенных процессов.

    • **targetclr:**Version задает версию среды CLR для профилирования, если в приложении загружено несколько версий среды выполнения.Необязательный параметр.

Управление сбором данных

Пока выполняется служба, можно управлять сбором данных путем запуска и остановки записи данных в файл с помощью параметров VSPerfCmd.exe.Управление сбором данных позволяет собирать данные на различных этапах выполнения программы, например при запуске или завершении работы приложения.

Запуск и остановка сбора данных

  • Следующие пары параметров VSPerfCmd используются для запуска и остановки сбора данных.Задайте каждый параметр в отдельной строке командной строки.Запуск и приостановка сбора данных могут выполняться неоднократно.

    Параметр

    Описание

    /globalon /globaloff

    Запускает (/globalon) или останавливает (/globaloff) сбор данных для всех процессов.

    /processon:PID/processoff:PID

    Запускает (/processon) или останавливает (/processoff) сбор данных для процесса с указанным идентификатором процесса (PID).

    /attach:{PID|ProcName} /detach[:{PID|ProcName}]

    /attach запускает сбор данных для процесса, определяемого идентификатором или именем процесса./detach останавливает сбор данных для указанного процесса или, если он не задан, для всех процессов.

  • Для добавления метки профилирования в файл данных можно также использовать параметр VSPerfCmd.exe/mark.Команда /mark добавляет идентификатор, отметку времени и необязательную определенную пользователем текстовую строку.Метки могут использоваться для фильтрации данных в отчетах профилировщика и представлениях данных.Следующие пары параметров VSPerfCmd используются для запуска и остановки сбора данных.Задайте каждый параметр в отдельной строке командной строки.Запуск и приостановка сбора данных могут выполняться неоднократно.

Завершение сеанса профилирования

При завершении сеанса профилирования профилировщик не должен собирать данные.Чтобы остановить процесс сбора данных от приложения, для которого выполняется профилирование методом параллелизма, можно остановить службу или воспользоваться параметром VSPerfCmd /detach.Затем для завершения работы профилировщика и закрытия файла с данными профилирования используется параметр VSPerfCmd /shutdown.Команда VSPerfClrEnv /globaloff удаляет переменные среды, используемые для профилирования, но конфигурация системы не изменяется до перезагрузки компьютера.

Завершение сеанса профилирования

  1. Для отсоединения профилировщика от целевого приложения выполните одно из следующих действий.

    • Остановите службу.

      -или-

    • Введите VSPerfCmd /detach..

  2. Завершите работу профилировщика.Type:

    VSPerfCmd Shutdown

Журнал изменений

Дата

Журнал

Причина

Декабрь 2011.

Удаленный шаг VSPerfClrEnv /sampleon.

Исправление ошибки содержимого.