Como iniciar um aplicativo do .NET Framework autônomo com o criador de perfil para coletar dados de simultaneidade usando a linha de comando
Este tópico descreve como usar as ferramentas de linha de comando de Visual Studio Ferramentas de Criação de Perfil para iniciar um aplicativo autônomo do .NET Framework (cliente) e para coletar dados de simultaneidade do processo e do thread
.gif "Observação") Observação |
|---|
Ferramentas de linha de comando das Ferramentas de Criação de Perfil estão localizadas no subdiretório \Team Tools\Performance Tools do diretório de instalação Visual Studio.Nos computadores de 64 bits, ambas as versões de 64 bits e de 32 bits das ferramentas está disponível.Para usar as ferramentas de linha de comando do criador de perfis, você deve adicionar o caminho das ferramentas para a variável de ambiente PATH da janela prompt de comando ou adicioná-lo ao próprio comando.Para obter mais informações, consulte Especificando o caminho para ferramentas de linha de comando de ferramentas de criação de perfil. |
Quando o profiler é anexado ao aplicativo, você pode pausar e retomar a coleção de dados.Para finalizar uma sessão, o Criador de Perfis não deve estar anexado ao aplicativo, e deve ser explicitamente fechado.
Iniciando o aplicativo com o criador de perfis
Para iniciar um aplicativo de destino do.NET Framework com o profiler, você usa VSPerfClrEnv.exe para definir o.NET Framework que analisa variáveis.Você usa o VSPerfCmd /start e opções de /launch inicializar o profiler e iniciar o aplicativo.Você pode especificar /start e /launch e suas respectivas opções em uma única linha de comando.Você também pode adicionar a opção de /globaloff à linha de comando à coleta de dados de pausa quando o aplicativo de destino.Você usa /globalon em uma linha de comando separadamente para começar a coletar dados.
Para iniciar um aplicativo com o profiler
Abra uma janela de prompt de comando.
Inicie o criador de perfis.Tipo:
VSPerfCmd/start:concurrency[,{ResourceOnly|ThreadOnly}] **/output:**OutputFile [Options]
A opção de /start inicializa o profiler.
/start:concurrency
Permite coletar a contenção de recursos e os dados de execução de thread.
/start:concurrency,resourceonly
Permite coletar apenas dados de contenção de recursos.
/start:concurrency,threadonly
Permite coletar apenas dados de execução de thread.
A opção /output**:**OutputFileé necessária com /startOutputFile especifica o nome e o local dos dados de perfil (.vsp).
Você pode usar qualquer uma das seguintes opções com a opção /start:concurrency .
Opção
Descrição
/user:[domain\]username
Especifica o domínio e o nome da conta de usuário opcionais para ter acesso concedido ao profiler.
Permite analisar os processos em outras sessões de logon.
/wincounter:WinCounterPath
Especifica o contador de desempenho do Windows que será coletado durante a análise.
/automark:Interval
Uso com /wincounter somente.Especifica o número de milissegundos entre eventos de coleção contador de desempenho do Windows.O padrão é 500 ms.
/events:Config
Especifica um rastreamento de evento para evento do Windows (ETW) para ser coletado durante a análise.Os eventos de ETW são coletados em um arquivo separado (.etl).
Inicie o aplicativo de destino.Tipo:
VSPerfCmd /launch**:**AppNameOptions[] [Sample Event]
Você pode usar qualquer uma das seguintes opções com a opção /launch.
Opção
Descrição
/args:Arguments
Especifica uma cadeia de caracteres que contém argumentos de linha de comando a ser passado para o aplicativo de destino.
Inicia o aplicativo de linha de comando de destino em uma janela separada.
/targetclr:Version
Especifica a versão do Common Language Runtime (CLR) para analisar quando mais de uma versão do tempo de execução é carregada em um aplicativo.
Coleta de dados de controle
Quando o aplicativo destino é executado, você pode controlar a coleção de dados iniciando e parando a escrita de dados para o arquivo usando opções de VSPerfCmd.exe.A coleta de dados de controle permite que você colete dados para uma parte específica de execução do programa, como o inicio ou término do aplicativo.
Para iniciar e parar a coleção de dados
Os seguintes pares de opções VSPerfCmd.exe começam e param a coleção de dados.Especifique cada opção em uma linha separada de comando.É possível desativar e ativar a coleção de dados várias vezes.
Opção
Descrição
Inicia (/globalon) ou para (/globaloff) a coleção de dados para todos os processos.
/processon:PID/processoff:PID
Inicia (/processon) ou interrompe a coleta de dados (/processoff) para o processo especificado pelo ID de processo (PID).
/attach inicia a coleção de dados para o processo especificado pelo ID do processo (PID) ou nome do processo (ProcName)./detach para a coleta de dados para o processo especificado ou para todos os processos se nenhum processo for especificado.
Finalizando a sessão de análise
Para finalizar uma sessão, o profiler não deve estar coletando dados.Você pode interromper a coleta de dados de simultaneidade fechando o aplicativo analisado ou invocando a opção de VSPerfCmd /detach .Então, você chama a opção VSPerfCmd /shutdown para desativar o criador de perfis e fechar o arquivo de dados de criação de perfil.O comando VSPerfClrEnv /off apaga as variáveis de ambiente de criação de perfis.
Para finalizar uma sessão de criação de perfil
Execute uma destas opções para desanexar o criador de perfis do aplicativo de destino.
Feche o aplicativo de destino.
- ou -
Digite VSPerfCmd /detach
Feche o profiler
VSPerfCmd /shutdown