VSPerfCmd
A ferramenta VSPerfCmd é usada para iniciar e interromper a coleta de dados.Ela usa a sintaxe a seguir:
VSPerfCmd [/U] [/options]
As tabelas a seguir descrevem as opções da ferramenta VSPerfCmd:
Opção |
Descrição |
U |
A saída redirecionada do console está escrito como Unicode.Deve ser a primeira opção especificada. |
Start:mode |
Inicia a VSPerfMon e espera até que ela seja inicializada.Requer comutador de saída. mode pode ser uma das seguintes opções: COVERAGE - coleta dados de cobertura do código SAMPLE - coleta dados de amostra TRACE - coleta dados de instrumentação |
Output:filename |
Especifica o nome do arquivo de saída. |
CrossSession|CS |
Permite entre processos de criação de perfil.Os nomes de opção CROSSSESSION e CS são suportados. |
User:[domain\]username |
Usada com a opção Start.Permite o acesso do cliente ao monitor a partir da conta especificada. |
WaitStart[:n] |
Aguarda a coleção dados do agente de log se inicializar.If n for especificado, VSPerfCmd aguardará no máximo n segundos. If n não é especificado, VSPerfCmd aguardará indefinidamente. Isso facilitará 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 sistema autônomo o intervalo de amostragem.Você pode exemplo apenas um valor de contador. Quando a instrumentação de método de criação de perfil é usada, especifica um contador de CPU a serem coletados em cada ponto de instrumentação.Você pode coletar dados do contador de vários especificando várias opções de contador (instrumentação). Use a seguinte sintaxe para especificar os dados do contador (cfg): CounterName[,Reload[,FriendlyName]]
|
QueryCounters |
Exibe uma lista de contadores válido para a plataforma. |
WinCounter:caminho |
Especifica um contador de desempenho do Windows para incluir com a marca de dados.path é uma seqüência de caracteres de contador de desempenho do Windows no formato de caminho de contador PDH. Por exemplo: \Processor (0) \ ' % time de processador \sistema\contexto switches/s |
AutoMark:n |
Especifica o intervalo de time (em milissegundos) entre marcas automáticas quando você estiver usando /WINCOUNTER.Arredondados até 500ms mais próximo. Use 0 para desabilitar marcas automáticas.(padrão = 500ms se não for especificado) |
Events:option |
A opção EVENTS controla a coleção de eventos Event Trace Window (ETW).Os dados coletados são fornecidos pelo provedor ETW.The option formato é: <em | logoff >, <guid>[, sinalizadores [nível de]] <em | logoff >, < nome do provedor > [, sinalizadores [nível de]] guid -o controle provedor GUID. Como alternativa, um nome de provedor pode ser especificado em vez do GUID se ele estiver registrado com WMI. flags -hexadecimal '0 x' prefixo sinalizadores valor. É definido pelo provedor de eventos.Para obter mais informações, consulte a documentação do provedor ETW. level -Determina a quantidade de informações coletada. É definido pelo provedor de eventos.Para obter mais informações, consulte a documentação do provedor ETW. .gif "Observação importante") Observação importante:
Quando eventos ETW CLR estiverem ativados, dados de inicialização adicional também são coletados no relatório do Trace View.Para excluir eventos de inicialização apareça no relatório, use o seguinte comando: C:\<caminho>VSPerfCmd - eventos em \".NET Common linguagem tempo de execução\", 0x7fffffff, 5 Se você não excluir os eventos de inicialização, porque esses eventos não são listados no arquivo Managed Object Format (MOF), eles aparecerão como GUIDS no relatório.Para obter mais informações, consulte Arquivo do exemplo gerenciado objeto Format (MOF) .
Além disso, a opção EVENTS compreende as seguintes opções de núcleo comum: on, option[,option] Onde option é uma das seguintes: Process -Eventos processos Thread -thread eventos Image -Imagens carregar e descarregar eventos Disk -Eventos E/S de disco File -Eventos de E/s de arquivo Hardfault -Falhas de página disco rígido Pagefault -Falhas de página soft Network -Eventos rede Registry -Registro eventos de acesso Observe que o Kernel Provider só pode ser ativado.Ele não está desativado, nem seus sinalizadores podem ser modificados, até que o monitor seja desligado. |
Status |
O Status aplicado a esses processos que são descritos.Ela lista processos e segmentos e seu estado de perfil atual (On /Off).Por exemplo, se um processo foi interrompido, o status não indicará isso no relatório.Ele exibirá se o processo também está descrito ou não. |
ShutDown[:n] |
Aguarda os aplicativos monitorados desligarem a VSPerfMon.exe ou desconectarem e depois desligarem a VSPerfMon.exe e espera a conclusão do desligamento.If n for especificado, VSPerfCmd aguardará no máximo n segundos. If n não é especificado, VSPerfCmd aguardará indefinidamente. Isso facilitará Uso de VSPerfCmd como parte de um processo em lotes. |
GlobalOn |
A opção GLOBALON permite profiling após um GLOBALOFF.Internamente, opção GLOBALON define a contagem global Start / Stop igual a um.Para obter mais informações, consulte GLOBALOFF. |
GlobalOff |
A opção GLOBALOFF desativa todos os profiling e nenhum dado é coletado.Essa opção não é encerrado a sessão de desempenho.Você pode usar esta opção para evitar coletar dados durante a inicialização da aplicação ou fase de inicialização Para evitar coletar dados irrelevantes: |
ProcessOn:pid |
O PROCESSON reinicia o profiling para um processo específico usando sua ID de processo (pid) após uma telefonar para PROCESSOFF. Internamente, opção PROCESSON define a contagem Start/Stop igual a um para o processo especificado. |
ProcessOff:pid |
A opção PROCESSOFF pára o profiling e coleta de dados de um processo específico usando sua ID de processo (pid). Outros processos ou segmentos continuam a coletar dados.Isso é útil se você desejar evitar a coleta de dados antes do processo atingir um determinado estado.Você pode usar a opção PROCESSON, após o processo atingir um determinado estado, para iniciar a coleta de dados.Internamente, PROCESSOFF define a contagem Start / Stop como zero para o processo especificado. |
ThreadOn:TID |
ON thread reinicia o profiling para um determinado thread usando seu thread id (tid) após uma telefonar para thread desativado. Internamente, opção THREADON define a contagem Start / Stop igual a um para o segmento especificado. Esta opção é válida somente no modo TRACE. |
ThreadOff:TID |
A opção THREADOFF pára o profiling e coleta de dados para um segmento específico usando sua ID de segmento (tid). Outros processos ou segmentos continuam a coletar dados.Isso é útil se você desejar evitar coleta dados antes de o segmento alcançar um determinado estado.Você pode usar a opção THREADON, após o segmento atingir um determinado estado, para iniciar a coleta de dados.Internamente, THREADOFF define a contagem Start / Stop como zero para o segmento especificado. Esta opção é válida somente no modo TRACE. |
MARK:MarkNum[,MarkText] |
Insere uma marca dentro do fluxo de evento global, com texto opcional.Isso é útil se você desejar examinar os dados entre duas marcas. marknum -qualquer valor de tipo de dados ULONG Como alternativa, você pode chamar a API MarkProfile em seu código para marcar áreas específicas do aplicativo.Essas informações são somente disponível no Call Trace report. |
Opções de método de amostragem
As seguintes opções estão disponíveis somente no modo Sample:
Opção |
Descrição |
|---|---|
Launch:Executável |
Inicia o comando especificado e anexa o profiler baseado em amostra. |
Args:Argumentos |
Argumentos para o aplicativo iniciada. |
Console |
Inicia o comando especificado em um novo console. |
Attach:PID[,PID] |
Anexa o criador de perfil baseado em amostra ao processo especificado ids-pid or process nome. |
Detach:PID,PID |
Desconecta o criador de perfil baseado em amostra do processo especificado ids-pid or process nome. |
Detach |
Desconecta o profiler baseado em amostra de todos os processos. |
GC[:Allocation|:Lifetime] |
Esta opção estará disponível somente no modo de amostragem.Ativa o profiling gerenciado de memória.É possível ativar o rastreamento somente de alocações GC: alocação ou alocações e vida útil de objetos GC: vida útil.O valor padrão é somente alocações.Válido somente com a opção /LAUNCH. |
PF[:n] |
Exemplos em cada enésima falha de página (padrão = 10). |
Sys[:n] |
Exemplos em cada enésima chamada do sistema (Padrão = 10). |
Timer[:n] |
Exemplos em cada enésimo ciclo (padrão = 10000000). |
Componente de serviço e opções de dispositivo do modo kernel
As seguintes opções de suportam componentes de criação de perfil de serviços ou drivers de dispositivo de modo kernel.Essas opções definidas as permissões de criação de perfil.Isso devem ser executados a partir de um console de linha de comando executando sistema autônomo um administrador.Para obter mais informações, consulte Usando Executar sistema autônomo comando.
Opção |
Descrição |
|---|---|
Admin:Security <ALLOW|DENY> Right[ Right] <User|agrupar> |
Permitir ou negar ao usuário especificado ou o agrupar acesso a serviços de criação de perfil. Right pode ser: CrossSession - fornece o acesso de usuário para o serviço para cruzar a sessão de criação de perfil; SampleProfiling - fornece o acesso de usuário para o driver para ativar a criação de perfil de amostragem.Também é usado para acessar as informações de transição de kernel durante a criação de perfil; de rastreamento FullAccess - dá ao usuário acesso CrossSession e SampleProfiling. |
Admin:Security, List |
Liste o estado corrente de serviços e listas de permissões de usuário de perfil. |
Admin:<Serviço|Driver><START|STOP|INSTALL|UNINSTALL> |
Inicia, pára, instala ou desinstala o componente de serviço de criação de perfil (serviço) ou o driver de dispositivo do modo kernel (driver). |
Admin:<Serviço|Driver>AutoStart<ON|OFF> |
Ativa ou desativa automaticamente iniciar a criação de perfil (serviço) ou driver de dispositivo do modo kernel (driver) após uma reinicialização. |
VsPerfDrv.sys
Em versões anteriores do criador de perfil com suporte coleção de aplicativos em modo kernel CPU usando o VSPerfDrv.Sys.VsPerfDrv.sys está obsoleto.Use as opções VsPerfCmd ADMIN para essa funcionalidade.
Consulte também
Referência
Definições de coluna do relatório de ferramentas de criação de perfil