Compartilhar via

Como iniciar um aplicativo do .NET Framework autônomo com o criador de perfil para coletar dados de memória usando a linha de comando

  • Artigo

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 memória.

Analisando uma sessão tem três partes:

  • Iniciando o aplicativo usando o profiler.

  • Coletando dados de perfil.

  • Encerrar a sessão analisando.

ObservaçãoObservaçã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.

Iniciando o aplicativo com o criador de perfis

Para iniciar um aplicativo de destino usando o profiler, você usa VSPerfCmd.exe/start e opções de /launch inicializar o profiler e iniciar o aplicativo.Você pode especificar /start e /launch opções e suas respectivas em uma linha de comando.

Você também pode adicionar as opções de /globaloff pausar a coleta de dados no início do aplicativo de destino.Em seguida, você usa o /globalon para iniciar a coleta de dados.

Para iniciar um aplicativo usando o profiler

  1. Abra uma janela de prompt de comando.

  2. Inicie o criador de perfis.Tipo:

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

    • A opção /start:sample inicializa o criador de perfis.

    • 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:sample.

    Opção

    Descrição

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

  3. Inicie o aplicativo de destino.Tipo:

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

    • A opção de /gc**:**Keyword é 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 coletar a alocação de memória dos objetos e dados de tempo de vida.

      Palavra-Chave

      Descrição

      allocation

      Coletar dados de alocação de memória apenas.

      lifetime

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

    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.

    /console

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

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

    /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

Durante a execução do aplicativo de destino, é possível controlar a coleção de dados iniciando e interrompendo a gravação de dados no arquivo usando as 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 iniciam e interrompem 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

    /globalon /globaloff

    Inicia (/globalon) ou para (/globaloff) a coleção de dados para todos os processos.

    /processon:PIDprocessoff:PID

    Inicia/processon() ou para coleta de dados (de/processoff) para o processo que é especificado pela ID de processo (PID).

    /attach:PID/detach

    início de/attach para coletar dados para o processo que é especificado por PID (ID do processo)./detach para a coleção de dados para todos os processos.

  • Você também pode usar a opção VSPerfCmd.exe/mark para inserir uma marca no arquivo de dados.o comando /mark adiciona um identificador, um carimbo de data/hora, e, opcionalmente, uma cadeia de caracteres de texto definido pelo usuário.As marcas podem ser usadas para filtrar os dados.

Finalizando a sessão de análise

Para finalizar uma sessão de criação de perfil, o criador de perfis deve ser desanexado de todos os processos com perfil e o criador de perfis deverá ser explicitamente encerrado.Você pode desanexar o criador de perfil de um aplicativo que teve o perfil criado com o método de amostragem fechando o aplicativo ou chamando a opção VSPerfCmd /detach.Depois, chame a opção VSPerfCmd /shutdown para desativar o criador de perfis e feche 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

  1. Execute uma destas etapas para desanexar o criador de perfis do aplicativo de destino:

    • Feche o aplicativo de destino.

      - ou -

    • Digite VSPerfCmd /detach

  2. Encerrar o criador de perfis.Tipo:

    VSPerfCmd /shutdown

Consulte também

Conceitos

Criação de perfil de linha de comando dos aplicativos autônomos

Outros recursos

Exibições de dados da memória do .NET das ferramentas de criação de perfil