Compartilhar via

Como instrumentar um aplicativo Web do ASP.NET compilado dinamicamente e coletar dados de tempo detalhados com o criador de perfil 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 coletar dados de controle de tempo detalhado para um aplicativo compilado dinamicamente de ASP.NET usando a instrumentação que analisa o método.

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.

Para coletar dados de desempenho de um aplicativo Web de ASP.NET , modifique o arquivo web.config do aplicativo de destino habilitar a ferramenta de VSInstr.exe para prover os arquivos de aplicativo criados dinamicamente.Você usa a ferramenta de  VSPerfCLREnv.cmd para definir as variáveis de ambiente apropriadas no servidor Web para habilitar perfil, e reinicie o computador.

Inicie o profiler e execute o aplicativo de destino.Quando o profiler é anexado ao aplicativo, você pode pausar e retomar a coleção de dados.Quando você terminar de analisar, feche o aplicativo, feche o processo de trabalho do Internet information services (IIS), e fecha no profiler.Quando você concluiu seu trabalho analisando, restaure o arquivo web.config e o servidor Web para seus estados originais.

Configurando o aplicativo Web ASP.NET e o servidor Web

Para configurar o aplicativo Web ASP.NET e o servidor Web

  1. Modifique o arquivo web.config do aplicativo de destino.Consulte Como modificar arquivos Web.Config para instrumentar e criar perfil dinamicamente de aplicativos Web do ASP.NET.

  2. Abra uma janela de prompt de comando.

  3. Inicialize as variáveis do ambiente do perfil.Tipo:

    VSPerfClrEnv /globaltraceon

    • /globaltraceon permite analisar usando o método de gerenciamento.

  4. Reinicie o computador.

Executando a sessão analisando

Para analisar o aplicativo Web

  1. Abra uma janela de prompt de comando.

  2. 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 /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 /start:trace.

    ObservaçãoObservação

    Geralmente, as opções /user e /crosssession são necessárias para aplicativos do ASP.NET.

    Opção

    Descrição

    /user:[Domain\]UserName

    Especifica o domínio e o nome do usuário da conta que possui o processo de trabalho do ASP.NET.Essa opção será necessária 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 de logon.Essa opção é necessária se o aplicativo ASP.NET estiver sendo executado em uma sessão diferente.O identificador de sessão é listado na coluna de ID da sessão na guia os 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).

  3. Inicie o aplicativo Web de ASP.NET no modo comum.

Coleta de dados de controle

Quando o aplicativo de destino executar, você pode controlar a coleta de dados iniciando e interrompendo a gravação de dados no arquivo de dados do profiler usando 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).

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

Finalizando a sessão de análise

Para terminar uma sessão, analisando feche o aplicativo Web de ASP.NET de destino, reinicie o IIS interromper o processo análise, e feche o profiler.

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

  1. Feche o aplicativo da Web ASP.NET.

  2. Feche o processo de trabalho de ASP.NET redefinindo o Internet information services (IIS).Tipo:

    IISReset/stop

  3. Encerrar o criador de perfis.Tipo:

    VSPerfCmd /shutdown

  4. Reinicie o IIS.Tipo:

    IISReset/start

A restauração do aplicativo e a configuração do computador

Quando concluir todas analisar, substituir o arquivo web.config, desmarque as variáveis de ambiente, analisando e reiniciar o computador para restaurar o aplicativo e o servidor para estados que estavam em antes de analisar.

Para restaurar o aplicativo e a configuração do computador

  1. Substituir o arquivo web.config com uma cópia do arquivo original.

  2. Limpe as variáveis do ambiente de análise.Tipo:

    VSPerfCmd/globaloff

  3. Reinicie o computador.

Consulte também

Conceitos

Criação de perfil de linha de comando dos aplicativos Web do ASP.NET

Outros recursos

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