Compartilhar via


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

Este tópico descreve como usar Visual Studio ferramentas para traçar perfil de linha de comando de ferramentas para anexar o profiler para um aplicativo autônomo em execução do.NET Framework (cliente) e para reunir estatísticas de desempenho usando o método de amostragem.

ObservaçãoObservação

Os recursos avançados de segurança no Windows 8 e Windows Server 2012 necessitaram de alterações significativas na forma que o profiler do Visual Studio coleta dados dessas plataformas.Os aplicativos da Windows Store também requerem novas técnicas de coleção.Consulte Criando perfis de aplicativos do Windows 8 e Windows Server 2012.

Ferramentas de linha de comando das Ferramentas de Perfil estão localizadas no subdiretório \Team Tools\Performance Tools do sub-diretório 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 profiler, você deve adicionar o caminho de ferramentas para a variável de ambiente PATH da janela do prompt de comando ou adicioná-lo ao comando próprio.Para obter mais informações, consulte Especificando o caminho para a criação de perfil de ferramentas de linha de comando.

Adicionar dados de interação de camada a analisar executado requer procedimentos específicos com a linha de comando ferramentas para traçar perfil.Consulte Adicionando dados de interação entre camadas da linha de comando.

Para coletar dados de desempenho de um aplicativo.NET Framework, variáveis de ambiente apropriados deve ser inicializada antes que o aplicativo é iniciado de destino.Quando o profiler é anexado ao aplicativo, você pode pausar e continuar a coleção de dados.

Para finalizar a uma sessão, o profiler não deve ser anexado ao aplicativo e o profiler deve ser explicitamente fechado.Na maioria dos casos, recomendamos desmarque as variáveis de ambiente a no final de uma sessão para.

Anexando o profiler

Para anexar o profiler a um aplicativo em execução do .NET Framework

  1. Abra uma janela de Prompt de comando.

  2. Inicializar variáveis de ambiente a.Tipo:

    VSPerfClrEnv /sampleon [/samplelineoff]

    • A opção de /samplelineoff desativa a coleção de dados linha de código-fonte de número.
  3. Ligue o profiler.Tipo:

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

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

    • A opção de /output**:**OutputFile é necessária com /start.OutputFile especifica o nome e o local dos dados de perfil (.vsp).

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

    Opção

    Descrição

    /user:[Domain\UserName]

    Especifica o domínio e o nome da conta de usuário opcionais que possui o processo analisado.Essa opção é necessária somente se o aplicativo foi iniciado analisado como um usuário diferente do usuário autorizado.

    /crosssession

    Permite analisar os processos em outras sessões de logon./CS pode ser especificado como uma abreviação para /crosssession.Essa opção é necessária se o aplicativo é executado em uma sessão diferente.

    /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 é ms 500.

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

  4. Se necessário, inicie o aplicativo alvo da forma normal.

  5. Anexar o profiler para o aplicativo de destino.Tipo:

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

    • PID especifica a identificação de processo do aplicativo alvo.ProcessName especifica o nome do processo.Observe que se você especificar ProcessName e os processos de vários que têm o mesmo nome está em execução, os resultados são imprevisíveis.Você pode exibir os IDs de processo de todos os processos em execução no gerenciador de tarefas do windows.

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

    • Por padrão, os dados de desempenho são provados cada 10.000.000 ciclos de relógio não paralisados do processador.Isso é aproximadamente uma vez a cada 10 segundos em um processador 1GH.Você pode especificar uma das seguintes opções alterar o intervalo de ciclo de relógio ou especificar um evento diferente de amostragem./targetclr**:**Version especifica a versão do CLR para analisar quando mais de uma versão do runtime é carregada em um aplicativo.Opcional.

    Evento de exemplo

    Descrição

    /timer:Interval

    Altera o intervalo de amostragem para o número de ciclos de relógio não paralisados que são especificados por Interval.

    /pf [:Interval]

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

    /sys [:Interval]

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

    /counter:Config

    Altera o evento e o intervalo para o contador de desempenho do processador e o intervalo de amostragem que são especificados em Config.

Coleta de dados de controle

Quando o aplicativo de destino está executando o, você pode controlar a coleção de dados inicial e parar a escrita de dados no arquivo de dados profiler usando opções de VSPerfCmd.exe .A coleção de dados de controle permite que você reunir dados para uma parte específica de execução do programa, como iniciar ou feche o aplicativo.

Para iniciar e parar a coleção de dados

  • Os seguintes pares opções de início e param a coleção de dados.Especifique cada opção em uma linha separada de comando.Você pode 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:PID/processoff:PID

    Inicia/processon() ou para a coleção de dados (de/processoff) para o processo que é especificado por PID.

    Anexar:PID|ProcName} /detach[:{PID|ProcName}]

    inicia de/attach para coletar dados para o processo que é especificado por PID ou pelo nome do processo ProcName ()./detach para coleta de dados para o processo especificado ou para todos os processos se um determinado processo não é especificado.

  • 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 nos relatórios do profiler e em modos de exibição de dados.

Terminando à sessão

Para finalizar a uma sessão, o profiler deve ser desanexado de todos os processos analisados e o profiler deve ser explicitamente fechado.Você pode desanexar o profiler de um aplicativo que é analisado usando o método de amostragem do aplicativo ou chamando a opção de VSPerfCmd /detach .Você chama a opção de VSPerfCmd /shutdown desativar o profiler e feche o arquivo de dados para.O comando de VSPerfClrEnv /off limpa todas as variáveis de ambiente a.

Para finalizar uma sessão

  1. Execute uma das seguintes etapas para desanexar o profiler do aplicativo alvo:

    • Digite VSPerfCmd /detach

      -  ou  -

    • Feche o aplicativo alvo.

  2. Feche o profiler.Tipo:

    VSPerfCmd/shutdown

  3. (Opcional) desmarque a variáveis de ambiente.Tipo:

    VSPerfClrEnv /off

Consulte também

Conceitos

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

Outros recursos

Modos de exibição de dados do método de amostragem de Profiler