VSPerfCmd
O VSPerfCmd.exe ferramenta é usada para iniciar e interromper a coleta de dados de desempenho. Ela usa a sintaxe a seguir:
VSPerfCmd [/U] [/options]
As tabelas a seguintes descrevem VSPerfCmd.exe Opções de ferramenta.
Opção |
Descrição |
|---|---|
U |
A saída redirecionada do console está escrito como Unicode. Devem ser a primeira opção especificada. |
Iniciar:mode |
Inicia o serviço de criação de perfil no modo especificado. |
Saída:filename |
Especifica o nome do arquivo de saída. Use somente com Start. |
Permite a criação de perfil nas sessões do Windows. Use only with Start, Attach, or Launch. |
|
User:domain\username |
Permite o acesso da conta especificada para o serviço do profiler. Use somente com Start. |
WaitStart[:n] |
Aguarda a coleção dados do agente de log se inicializar. Se n for especificado, VSPerfCmd aguardará no máximo n segundos. Se n não for especificado, VSPerfCmd aguardará indefinidamente. Isso facilitará o uso de VSPerfCmd como parte de um processo em lotes. |
Counter:cfg |
Quando o método de criação de perfil de exemplo é usado, especifica um contador de CPU e o número de eventos para usar como o intervalo de amostragem. Você pode obter amostra apenas um valor de contador. Quando a método de criação de perfil de instrumentação é usada, especifica um contador de CPU a serem coletados em cada ponto de instrumentação. Use only with Start:Trace, Attach,or Launch. |
Exibe uma lista de contadores de CPU válido na máquina atual. |
|
WinCounter:caminho |
Especifica um evento de contador de desempenho do Windows para incluir dados de marca de perfil. Use somente com Start. |
Especifica o intervalo de tempo (em milissegundos) entre eventos de coleta de dados do contador de desempenho Windows. Use com WinCounter. |
|
Eventos:option |
Coleção de controles de eventos de rastreamento de eventos para Windows (ETW) especificados. Dados ETW são coletados para um arquivo de .itl não é o arquivo de dados (. vsp) de criação de perfil. |
Exibe o estado do profiler, informações sobre processos que estão atualmente sendo perfilados e contas que têm autoridade para controlar o profiler. |
|
Shutdown[:n] |
Fecha o arquivo de dados de criação de perfil e desativa o profiler. |
Reinicia a coleta de dados após uma chamada para VSPerfCmd GlobalOff. |
|
Pára a coleção de todos os dados, mas não termina a sessão de criação de perfil. |
|
ProcessOn:pid |
Retoma a coleta de dados para o processo especificado após a criação de perfil foi interrompida por uma chamada para VSPerfCmd ProcessOff. |
ProcessOff:pid |
Pára a coleta de dados para o processo especificado. |
Reinicia o profiling para o processo especificado, após a criação de perfil foi interrompida por uma chamada para VSPerfCmd ThreadOff. Use ThreadOn somente quando a criação de perfil com o método de instrumentação. |
|
Pausa a criação de perfil para o segmento especificado. Use ThreadOff somente quando a criação de perfil com o método de instrumentação. |
|
Marca:MarkNum[,MarkText] |
Insere uma marca o arquivo de dados de criação de perfil, com texto opcional. |
Opções de método de amostragem
As seguintes opções só estão disponíveis quando você estiver usando a método de criação de perfil de amostragem.
Opção |
Descrição |
|---|---|
Iniciar:Executável |
Inicia o aplicativo especificado e começa a criação de perfil. |
Args:Argumentos |
Especifica os argumentos de linha de comando para passar para o aplicativo iniciado. |
Inicia o comando especificado em uma nova janela do prompt de comando. |
|
Anexar:PID[,PID] |
Inicia os processos especificados de criação de perfil. Processos podem ser identificados pelo id do processo ou pelo nome do processo. |
Desanexar[:PID[,PID]] |
Pára o profiling os processos especificados. Processos podem ser identificados pelo id do processo ou pelo nome do processo. Se nenhum processo for especificado, a criação de perfil é interrompida para todos os processos. |
GC[:{Allocation|Lifetime}] |
Coleta.NET alocação e object lifetime dados da memória. Use somente com o VSPerfCmd Launch opção. |
Opções de intervalo de amostragem
As opções a seguir especificam o tipo e a duração de intervalos de amostragem. O padrão é Timer. Você também pode especificar um contador de CPU como intervalo usando o Counter opção. Essas opções só podem ser especificadas com Launch ou com o primeiro Attach de uma sessão de criação de perfil.
Opção |
Descrição |
|---|---|
PF:n |
Exemplos em cada enésima falha de página (padrão = 10). |
Exemplos em cada enésima chamada do sistema (Padrão = 10). |
|
Timer:n |
Amostras em cada processador enésima ciclo (padrão = 10000000). |
O componente de serviço e opções do dispositivo de modo de Kernel
As seguintes opções de Admin suportam a componentes do serviço de criação de perfil ou drivers de dispositivo de modo de kernel. As opções do administrador definir permissões de criação de perfil e controlam com perfil de serviço ou driver de dispositivo.
Opções de administração devem ser executadas em um prompt de comando que está executando com credenciais administrativas.
Opção |
Descrição |
|---|---|
Admin:Security <ALLOW|DENY> RightRight<User|Grupo> |
Permite ou nega o acesso do grupo de serviços de perfil ou usuário especificado. Rightpode ser: CrossSession - dá ao usuário acesso ao serviço para cruzar a sessão de criação de perfil. SampleProfiling - dá ao usuário acesso ao driver para habilitar a criação de perfil de amostragem. Também é usado para acessar as informações de transição do kernel durante a criação de perfil de rastreamento. FullAccess - dá ao usuário acesso de CrossSession e o SampleProfiling. |
Admin:Security, List |
Lista o estado atual dos serviços de criação de perfil e as permissões de usuário. |
Admin:<Service|Driver><START|STOP|INSTALL|UNINSTALL> |
Inicia, pára, instala ou desinstala o componente de serviço de criação de perfil (serviço) ou um driver de dispositivo de modo kernel (driver). |
Admin:<Service|Driver>AutoStart<ON|OFF> |
Habilita ou desabilita o inicie automaticamente a criação de perfil (serviço) ou um driver de dispositivo de modo kernel (driver) após uma reinicialização. |
VSPerfCmd /Driver
O VSPerfCmd /Driver opção é agora obsoleta. Use o VsPerfCmd Admin Opções para esta funcionalidade.