Como: Anexar o Profiler para um.NET Framework aplicativo autônomo e coletar estatísticas de aplicativo usando a linha de comando

  • Artigo

Este tópico descreve como usar ferramentas de linha de comando de ferramentas de criação de perfilVisual Studio para anexar o profiler para uma execução.Aplicativo de autônomo (cliente) do NET Framework e estatísticas de coleta de desempenho usando o método de amostragem.

ObservaçãoObservação

Ferramentas de linha de comando das ferramentas de criação de perfil estão localizadas na subpasta \Team Tools\Performance ferramentas da Visual Studio diretório de instalação. Em computadores de 64 bits, as versões de 64 bits e de 32 bits das ferramentas estão disponíveis. Para usar as ferramentas de linha de comando do profiler, você deve adicionar o caminho de ferramentas para a variável de ambiente PATH da janela do Prompt de comando ou adicioná-lo para o próprio comando. Para obter mais informações, consulte Especificando o caminho para as ferramentas de linha de comando de criação de perfil.

Para coletar dados de desempenho de um.NET do aplicativo do Framework, o ambiente adequado de variáveis devem ser inicializadas antes que o aplicativo de destino for iniciado. Quando o profiler é anexado ao aplicativo, você pode pausar e reiniciar a coleta de dados.

Para finalizar uma sessão de criação de perfil, o profiler não deve ser anexado ao aplicativo e o criador de perfil deve ser desligado explicitamente. Na maioria dos casos, é recomendável limpar as variáveis de ambiente de criação de perfil no final de uma sessão de criação de perfil.

Anexar o Profiler

Para anexar o Profiler para uma execução.Aplicativo do NET Framework

  1. Abra a janela Prompt de Comando.

  2. Inicialize as variáveis de ambiente de criação de perfil. Tipo:

    VSPerfClrEnv /sampleon [/samplelineoff]

    • O /samplelineoff opção desativa a coleção de origem código linha número dados.

  3. Inicie o profiler. Tipo:

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

    • O /start:sample opção inicializa o profiler.

    • O /output**:**OutputFile opção é necessária com /start. OutputFileEspecifica o nome e o local do arquivo de dados (. vsp) do perfil.

    Você pode usar qualquer uma das seguintes opções com o /start:sample opção.

    Opção

    Descrição

    /user:Domain\UserName

    Especifica o nome de domínio e de usuário opcional da conta que possui o processo perfilado. Esta opção é necessária somente se o aplicativo perfilado foi iniciado como um usuário diferente, por exemplo, o usuário conectado.

    /crosssession

    Permite criação de perfil de processos em outras sessões de logon. /CSpode ser especificado como uma abreviação de /crosssession. Esta opção é necessária se o aplicativo é executado em uma sessão diferente.

    /wincounter:WinCounterPath

    Especifica um contador de desempenho do Windows a serem coletados durante perfilação.

    /automark:Interval

    Use com /wincounter somente. Especifica o número de milissegundos entre eventos de coleção de contadores de desempenho do Windows. O padrão é 500 ms.

    /Events:Config

    Especifica um evento de rastreamento de eventos para Windows (ETW) a serem coletados durante perfilação. Eventos ETW são coletados em um arquivo separado (. ETL).

  4. Se necessário, inicie o aplicativo de destino da maneira típica.

  5. Anexe o profiler ao aplicativo de destino. Tipo:

    VSPerfCmd /attach:{PID|ProcessName} [Sample Event] [**/targetclr:**Version]

    • PIDEspecifica a identificação de processo do aplicativo de destino. ProcessNameEspecifica o nome do processo. Observe que, se você especificar ProcessName e vários processos que têm o mesmo nome estão em execução, os resultados são imprevisível. Você pode exibir as identificações de todos os processos em execução de processos no Gerenciador de tarefas do Windows.

    • /targetclr**:**Version Especifica a versão do common language runtime (CLR) para o perfil quando mais de uma versão do tempo de execução é carregada em um aplicativo. Opcional.

    • Por padrão, cada relógio do processador não é interrompida de 10.000.000 de amostra de dados de desempenho ciclos. Isso é de aproximadamente uma vez a cada 10 segundos em um processador de 1GH. Você pode especificar uma das seguintes opções para alterar o intervalo de ciclo de relógio ou para especificar um evento de amostra diferentes./targetclr**:**Version Especifica a versão do CLR para perfil quando mais de uma versão do tempo de execução é carregada em um aplicativo. Opcional.

    Evento de amostragem

    Descrição

    /Timer:Interval

    Altera o intervalo de amostragem para o número de ciclos não interrompidos relógio especificados pelo Interval.

    /pf:Interval]

    Altera o evento de amostragem para falhas de página. Se Interval for especificado, define o número de falhas de página entre amostras. O padrão é 10.

    /sys:Interval]

    Altera o evento de amostragem para chamadas de sistema do processo para o kernel do sistema operacional (syscalls). Se Interval for especificado, define o número de chamadas entre amostras. O padrão é 10.

    /Counter:Config

    O evento de amostragem e o intervalo é alterado para o contador de desempenho do processador e o intervalo que são especificadas na Config.

Controlar a coleta de dados

Quando o aplicativo de destino está executando, você pode controlar a coleta de dados por iniciar e parar a gravação de dados para o arquivo de dados do profiler usando VSPerfCmd.exe Opções. Controlar a coleta de dados permite coletar dados para uma parte específica da execução do programa, como iniciar ou desligar o aplicativo.

Para iniciar e interromper a coleta de dados

  • Os seguintes pares de opções de iniciar e interromper a coleta de dados. Especifica cada opção em uma linha de comando separada. Você pode ativar a coleta de dados de logon e logoff várias vezes.

    Opção

    Descrição

    /globaloff de /GLOBALON

    Inicia (/globalon) ou pára (/globaloff) a coleta de dados para todos os processos.

    /PROCESSON:PID /processoff:PID

    Inicia (/processon) ou pára (/processoff) a coleta de dados para o processo que é especificado pelo PID.

    / conexão:{PID|ProcName} /detach[:{PID|ProcName}]

    /attachcomeça a coletar dados para o processo que é especificado pelo PID ou o nome do processo (ProcName). /detachpára a coleta de dados para o processo especificado ou para todos os processos se um processo específico não for especificado.

  • Você também pode usar o VSPerfCmd.exe dd255359(v=vs.100).mdmarca/ a opção para inserir uma marca de criação de perfil para o arquivo de dados. O /mark comando adiciona um identificador, um carimbo de hora e uma seqüência de caracteres de um texto opcional definido pelo usuário. Marcas podem ser usadas para filtrar os dados em relatórios do profiler e exibições de dados.

Encerrando a sessão de criação de perfil

Para finalizar uma sessão de criação de perfil, o criador de perfil deve ser desconectado de todos os processos de perfil e o criador de perfil deve ser desligado explicitamente. Você pode desconectar o gerador de perfil de um aplicativo que foi perfilado usando o método de amostragem, fechando o aplicativo ou chamando o VSPerfCmd /detach opção. Em seguida, chamar o VSPerfCmd /shutdown opção para ativar o profiler logoff e feche o arquivo de dados criação de perfil. O VSPerfClrEnv /off comando limpa a criação de perfil variáveis de ambiente.

Para finalizar uma sessão de criação de perfil

  1. Execute uma das seguintes etapas para desconectar o gerador de perfil do aplicativo de destino:

    • TipoVSPerfCmd /detach

      - ou -

    • Feche o aplicativo de destino.

  2. Desligar o profiler. Tipo:

    VSPerfCmd /Shutdown

  3. (Opcional) Desmarque as variáveis de ambiente de criação de perfil. Tipo:

    VSPerfClrEnv /off

Consulte também

Conceitos

Ferramentas de criação de perfil de linha de comando de aplicativos autônomos

Outros recursos

Exibições de dados de método de amostragem do Profiler