Compartilhar via


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.

CrossSession|CS

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.

QueryCounters

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.

Com AutoMarcação:n

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.

Status

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.

GlobalOn

Reinicia a coleta de dados após uma chamada para VSPerfCmd GlobalOff.

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.

ThreadOn e ThreadOff:TID

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.

ThreadOn e ThreadOff:TID

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.

Console

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).

Sys (VSPerfCmd):n

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.

Consulte também

Referência

VSInstr

VSPerfMon

VSPerfReport