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

Практическое руководство. Присоединение профилировщика к службе .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, нужно воспользоваться программой VSPerfCLREnv.cmd, чтобы инициализировать соответствующие переменные среды на том компьютере, где запущена служба.Чтобы настроить компьютер для профилирования, его нужно перезагрузить.

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

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

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

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

  1. Если необходимо, установите службу.

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

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

    VSPerfClrEnv {/globalsamplegc /globalsamplegclife}[/samplelineoff]

    • Параметры /globalsamplegclife и /globalsamplegclife задают тип памяти для сбора данных.Задайте один и только один из следующих объектов.

    • /globalsamplegc
      Включает сбор данных о выделении памяти.

    • /globalsamplegclife
      Включает сбор данных о выделении памяти и времени существования объекта.

    • Параметр /samplelineoff отключает сбор данных о номерах строк исходного кода.

  4. Перезагрузите компьютер, чтобы задать новую конфигурацию среды.

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

  6. Откройте окно командной строки.Если необходимо, добавьте путь к профилировщику в переменную среды PATH.

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

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

    • Параметр /start:sample обеспечивает инициализацию профилировщика.

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

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

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

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

    Параметр

    Описание

    /user:[Domain\]UserName

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

    /crosssession

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

    /user:[Domain\]UserName

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

    /crosssession|cs

    Включает профилирование процессов в других сеансах входа в систему.

    /wincounter:WinCounterPath

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

    /automark:Interval

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

    /events:Config

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

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

    VSPerfCmd /attach:{PID|ProcName} [/targetclr**:**Version]

    • Задайте идентификатор процесса или имя процесса службы.Диспетчер задач 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 /detach.Затем, чтобы завершить работу профилировщика и закрыть файл данных профилирования, вызовите команду VSPerfCmd /shutdown.Команда VSPerfClrEnv /globaloff удаляет переменные среды, используемые для профилирования, но конфигурация системы не изменяется до перезагрузки компьютера.

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

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

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

      -или-

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

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

    VSPerfCmd /shutdown

  3. (Необязательно.) Удалите переменные среды, используемые для профилирования.Type:

    VSPerfClrEnv /globaloff

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

См. также

Основные понятия

Профилирование служб из командной строки

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

Представления данных в памяти в средствах профилирования .NET