Como: Iniciar um aplicativo autônomo com o Profiler e o aplicativo coletar estatísticas usando a linha de comando

Este tópico descreve como usar Visual Studio Ferramentas de criação de perfil de ferramentas de linha de comando para iniciar um aplicativo autônomo (cliente) e coletar estatísticas de desempenho usando o método de amostragem.

Uma sessão de criação de perfil possui três partes:

  • Iniciando o aplicativo usando o profiler.

  • Controlando a coleta de dados.

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

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

Iniciar o aplicativo com o Profiler

Para iniciar um aplicativo de destino usando o criador de perfil, use o VSPerfCmd /start e /launch Opções para inicializar o profiler e inicie o aplicativo. Você pode especificar /start e /launch e suas respectivas opções em uma única linha de comando.

Você também pode adicionar o /globaloff opção para interromper a coleta de dados no início do aplicativo de destino. Você usar /globalon para começar a coletar dados.

Para iniciar um aplicativo usando o criador de perfil

  1. Abra a janela Prompt de Comando.

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

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

  3. Inicie o aplicativo de destino. Tipo:**VSPerfCmd /launch:**appName [Options] [Sample Event]

    Você pode usar um ou mais das seguintes opções com o /launch opção.

    Opção

    Descrição

    /args:Arguments

    Especifica uma seqüência de caracteres que contém os argumentos de linha de comando a serem passados para o aplicativo de destino.

    /Console

    Inicia o aplicativo de linha de comando de destino em uma janela separada.

    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 1 GHz. 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.

    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 especificado pelo ID do processo (PID).

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

    /attachInicia a coletar dados para o processo 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 profiler não deve ser anexado a qualquer processo perfilado 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:

    • Feche o aplicativo de destino.

      - ou -

    • TipoVSPerfCmd /detach

  2. Desligar o profiler. Tipo:

    VSPerfCmd /Shutdown

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