Partilhar via


Como: Iniciar autônoma.NET Framework com o criador de perfil para coletar dados de memória por meio da linha de comando

Este tópico descreve como usar o Visual Studio ferramentas de linha de comando de ferramentas de criação de perfil para iniciar um.Aplicativo de autônomo (cliente) do NET Framework e memória de coleta de dados.

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

  • Iniciando o aplicativo usando o criador de perfil.

  • Coleta de dados de criação de perfil.

  • 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 no subdiretório de ferramentas \Team Tools\Performance 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 a criação de perfil de ferramentas de linha de comando.

Iniciando o aplicativo com o criador de perfil

Para iniciar um aplicativo de destino usando o criador de perfil, use o VSPerfCmd.exe/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 linha de comando.

Você também pode adicionar o /globaloff opções para pausar 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 uma janela de Prompt de comando.

  2. Inicie o profiler.Tipo:

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

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

    • The /output**:**OutputFile option is required with /start.OutputFileEspecifica o nome e localização do arquivo de dados (Vsp) criação de 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 os eventos de coleta do contador de desempenho do Windows.O padrão é 500 ms.

  3. Inicie o aplicativo de destino.Tipo:

    VSPerfCmd /launch:appName/gc:{allocation|lifetime}[Options]

    • O /gc**:**Keyword opção é necessária para coletar.Dados de memória do NET Framework.O parâmetro de palavra-chave especifica se coletar dados de alocação de memória, ou para coletar alocação de memória e de dados de tempo de vida do objeto.

      Keyword

      Descrição

      allocation

      Colete dados de alocação de memória somente.

      lifetime

      Colete alocação de memória e de dados de tempo de vida do objeto.

    Você pode usar qualquer uma 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.

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

    /targetclr:Version

    Especifica a versão do common language runtime (CLR) para criar o perfil quando mais de uma versão do tempo de execução é carregada em um aplicativo.

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 usando o VSPerfCmd.exe opções.Controlar a coleta de dados permite que você colete 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

    /GLOBALON /globaloff

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

    /processon:PIDprocessoff:PID

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

    /attach:PID/detach

    /attachcomeça a coletar dados para o processo especificado por PID (a identificação do processo)./detachpára a coleta de dados para todos os processos.

  • Você também pode usar o VSPerfCmd.exedd255359(v=vs.110).md marca/ opção para inserir uma marca de criação de perfil no 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.

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 com perfil e o criador de perfil deve ser desligado explicitamente.Você pode desconectar o gerador de perfil de um aplicativo que teve seu perfil publicado 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 desativar o profiler e feche o arquivo de dados de criação de perfil.O VSPerfClrEnv /off comando limpa as variáveis de ambiente de criação de perfil.

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

  1. Execute uma das seguintes etapas para desconectar-se o criador 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

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

Outros recursos

Ferramentas de criação de perfil.Modos de exibição de dados de memória de NET