Partilhar via

Como instrumentar um componente do .NET Framework autônomo e coletar dados de tempo com o criador de perfil a partir da 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 prover um componente do.NET Framework como um arquivo ou o arquivo .dll, e para coletar dados de controle de tempo detalhado.

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 perfil de aplicativos do Windows 8 e do Windows Server 2012.

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.

A adição de dados de interação da camada à execução de criação de perfil requer procedimentos específicos com ferramentas de criação de perfil de linha de comando.Consulte Adicionando dados de interação entre camadas da linha de comando.

Para coletar dados de controle de tempo detalhado de um componente do.NET Framework usando o método de gerenciamento, use a ferramenta de VSInstr.exe para gerar uma versão instrumentada do componente e da ferramenta de VSPerfCLREnv.cmd para inicializar analisar as variáveis de ambiente.Inicie o criador de perfis.

Durante a execução do componente instrumentado, os dados do tempo são coletados automaticamente em um arquivo de dados.Você pode pausar e retomar a coleção de dados durante a sessão de criação de perfis.

Para terminar uma sessão, analisando você fecha o aplicativo de destino e feche explicitamente o profiler.Na maioria dos casos, recomendamos limpar as variáveis de ambiente ao final de uma sessão.

Iniciando a sessão de análise

Para iniciar a análise usando o método de gerenciamento

  1. Abra uma janela de prompt de comando.Se necessário, adicione o diretório de ferramentas do profiler a sua variável de ambiente PATH.O caminho não é adicionado à instalação.

  2. Use a ferramenta VSInstr para gerar uma versão instrumentada do aplicativo de destino.

  3. Inicializar o.NET Framework que analisa as variáveis de ambiente.Tipo:

    VSPerfClrEnv /traceon

  4. Inicie o criador de perfis.Tipo:

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

    • A opção /start:trace 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).

    É possível usar uma das seguintes opções com a opção /start:trace.

    Opção

    Descrição

    /user:[Domain\]UserName

    Especifica o domínio e o nome do usuário da conta que possui o processo com perfil.Essa opção é necessária somente se o processo estiver sendo executado como um usuário diferente do usuário conectado.O proprietário do processo é listado na coluna de nome de usuário na guia de processos do gerenciador de tarefas do Windows.

    /crosssession

    Permite analisar os processos em outras sessões.Essa opção é necessária se o aplicativo ASP.NET estiver sendo executado em uma sessão diferente.A identificação da sessão é listada na coluna ID da sessão na guia de processos do gerenciador de tarefas do Windows./CS pode ser especificado como uma abreviação para /crosssession.

    /globaloff

    Inicia o profiler com a coleta de dados pausada.Use /globalon para continuar analisar.

    /counter:Config

    Coleta informações do contador de desempenho de processador que é especificado em Config.As informações do contador é adicionado aos dados coletados em cada evento analisando.

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

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

  5. Inicie o aplicativo de destino na janela prompt de comando.

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 de dados do criador de perfis 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:PID/processoff:PID

    Inicia (/processon) ou interrompe a coleta de dados (/processoff) para o processo especificado pelo ID de processo (PID).

    /threadon:TID/threadoff:TID

    Inicia (/threadon) ou interrompe a coleta de dados do thread (/threadoff) para o thread especificado por ID de threads (TID).

Finalizando a sessão de análise

Para terminar uma sessão, analisando feche o aplicativo que está executando o componente provido.Chame a opção VSPerfCmd /shutdown para desativar o criador de perfis e fechar o arquivo de dados de análise.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. Feche o aplicativo de destino.

  2. Encerrar o criador de perfis.Tipo:

    VSPerfCmd /shutdown

  3. (Opcional) Limpe as variáveis do ambiente do perfil.Tipo:

    VSPerfClrEnv /off

Consulte também

Conceitos

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

Outros recursos

Exibições de dados do método de instrumentação do criador de perfil