Partilhar via


Como: instrumentar autônoma.NET Framework componente e coletar dados de tempo com o criador de perfil da linha de comando

Este tópico descreve como usar Visual Studio ferramentas para traçar perfil de linha de comando de ferramentas para instrumentar um componente.NET Framework como um .exe ou .dll, e para coletar dados de temporização 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 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 temporização detalhado de um componente.NET Framework utilizando o método de instrumentação, você usa a ferramenta de VSInstr.exe provida para produzir uma versão do componente e da ferramenta de VSPerfCLREnv.cmd para analisar inicializar variáveis de ambiente.Você inicia o profiler.

Quando o componente instrumentado é executado, os dados de tempo são coletados automaticamente em um arquivo de dados.Você pode pausar e continuar a coleção de dados durante a sessão para analisar.

Para finalizar a uma sessão, você fechar o aplicativo alvo explicitamente fecha e o profiler.Na maioria dos casos, recomendamos desmarque as variáveis de ambiente a no final de uma sessão.

Inicial para a sessão

Para iniciar analisar usando o método de instrumentação

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

  2. Use a ferramenta de VSInstr para produzir uma versão provida do aplicativo alvo.

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

    VSPerfClrEnv /traceon

  4. Ligue o profiler.Tipo:

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

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

    Opção

    Descrição

    /user:[Domain\UserName]

    Especifica o domínio e o nome de usuário da conta que possui o processo analisado.Essa opção é necessária somente se o processo está sendo executado como um usuário diferente do usuário autorizado.O proprietário do processo é listado na coluna do nome de usuário na guia dos 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 está executando em uma sessão diferente.A sessão mais idenitifier é listada na coluna de identificação de sessão na guia dos processos do gerenciador de tarefas do Windows./CS pode ser especificado como uma abreviação para /crosssession.

    /globaloff

    Inicia o profiler com a coleção de dados pausada.Use /globalon para continuar a análise.

    /counter:Config

    Coleta informações de contador de desempenho do processador que é especificado em Config.Informações sobre o contador é adicionada aos dados que são coletados em cada evento para.

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

  5. Inicie o aplicativo alvo da janela do prompt de comando.

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 coleção de dados paradas de/processoff() para o processo especificado pela identificação de processo (PID).

    /threadon:TID/threadoff:TID

    Inicia (/threadon) ou coleta de dados das paradas (/threadoff) para o segmento especificado por ID de segmentos (TID).

  • 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 uma sessão para terminar, feche o aplicativo que está executando o componente instrumentado.Chame 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. 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

Exibições de dados de método de instrumentação de Profiler