Como: Anexar o Profiler para um serviço nativo para coletar estatísticas de aplicativo usando a linha de comando

Este tópico descreve como usar o Visual Studio Ferramentas de linha de comando de ferramentas de criação de perfil para anexar o profiler para um serviço nativo e coletar estatísticas de desempenho usando o método de amostragem.

Observação

Ferramentas de linha de comando das ferramentas de criação de perfil estão localizadas na subpasta \Team Tools\Performance ferramentas da Visual Studio diretório de instalação. Em computadores de 64 bits, as versões de 64 bits e de 32 bits das ferramentas estão disponíveis. Para usar as ferramentas de linha de comando do profiler, você deve adicionar o caminho de ferramentas para a variável de ambiente PATH da janela do prompt de comando ou adicioná-lo para o próprio comando. Para obter mais informações, consulte Especificando o caminho para as ferramentas de linha de comando de criação de perfil.

Enquanto o profiler é anexado ao serviço, você pode pausar e reiniciar a coleta de dados.

Para finalizar uma sessão de criação de perfil, o criador de perfil deve ser desanexado do serviço e o criador de perfil deve ser desligado explicitamente.

Iniciar o aplicativo com o Profiler

Para anexar o profiler para um serviço nativo, você usar o VSPerfCmd.exe /start e / conexão opções para inicializar o profiler e anexá-lo para o aplicativo de destino. Você pode especificar /start e /attach e suas respectivas opções em uma única linha de comando. Você também pode adicionar o /globaloff opção para interromper a coleta de dados no início do aplicativo de destino. Você pode usar /globalon para iniciar a coleta de dados.

Para anexar o Profiler para um serviço nativo

1. Se necessário, inicie o serviço.

2. Abra uma janela de prompt de comando.

3. Inicie o profiler. Tipo:

   VSPerfCmd /start:sample /output**:**OutputFileOptions]

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

   • O **/output:**OutputFile opção é necessária com /start. OutputFileEspecifica o nome e o local do arquivo de dados (. vsp) do perfil.

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

   Observação
   O /user e /crosssession opções são geralmente necessárias para serviços.

   Opção	Descrição
   /user:Domain\UserName	Especifica o nome de usuário e domínio da conta que possui o processo perfilado. Esta opção é necessária somente se o processo está sendo executado como um usuário diferente, por exemplo, o usuário conectado. O proprietário do processo está listado na coluna Nome do usuário na guia processos do Gerenciador de tarefas do Windows.
   /crosssession	Permite criação de perfil de processos em outras sessões. Esta opção é necessária se o aplicativo é executado em uma sessão diferente. A identificação da sessão é listada na coluna de ID de sessão na guia processos do Gerenciador de tarefas do Windows. /CSpode ser especificado como uma abreviação de /crosssession.
   /wincounter:WinCounterPath	Especifica um contador de desempenho do Windows a serem coletados durante perfilação.
   /automark:Interval	Use com /wincounter somente. Especifica o número de milissegundos entre eventos de coleção de contadores de desempenho do Windows. O padrão é 500 ms.
   /Events:Config	Especifica um evento de rastreamento de eventos para Windows (ETW) a serem coletados durante perfilação. Eventos ETW são coletados em um arquivo separado (. ETL).

4. Anexe o profiler ao serviço. Tipo:

   **VSPerfCmd /attach:**PID [Sample Event]

   PIDEspecifica a identificação de processo do aplicativo de destino. Você pode exibir as identificações de todos os processos em execução de processos no Gerenciador de tarefas do Windows.

   Por padrão, cada relógio do processador não é interrompida de 10.000.000 de amostra de dados de desempenho ciclos. Isso é de aproximadamente uma vez a cada 10 segundos em um processador de 1GH. Você pode especificar uma das seguintes opções para alterar o intervalo de ciclo de relógio ou para especificar um evento de amostra diferentes.

   Evento de amostragem	Descrição
   /Timer:Interval	Altera o intervalo de amostragem para o número de ciclos de relógio não interrompidos especificado por Interval.
   /pf:Interval]	Altera o evento de amostragem para falhas de página. Se Interval for especificado, define o número de falhas de página entre amostras. O padrão é 10.
   /sys:Interval]	Altera o evento de amostragem para chamadas de sistema do processo para o kernel do sistema operacional (syscalls). Se Interval for especificado, define o número de chamadas entre amostras. O padrão é 10.
   /Counter:Config	O evento de amostragem e o intervalo é alterado para o contador de desempenho do processador e o intervalo especificado em Config.

Controlar a coleta de dados

Durante a execução do aplicativo de destino, você pode usar VSPerfCmd.exe Opções para iniciar e parar a gravação de dados no arquivo de dados do profiler. Controlar a coleta de dados permite coletar dados para uma parte específica da execução do programa, como iniciar ou desligar o aplicativo.

Para iniciar e interromper a coleta de dados

• Os seguintes pares de VSPerfCmd Opções de iniciar e interromper a coleta de dados. Especifica cada opção em uma linha de comando separada. Você pode ativar a coleta de dados de logon e logoff várias vezes.

  Opção	Descrição
  /globaloff de /GLOBALON	Inicia (/globalon) ou pára (/globaloff) a coleta de dados para todos os processos.
  /PROCESSON:PID /processoff:PID	Inicia (/processon) ou pára (/processoff) a coleta de dados para o processo especificado pelo ID do processo (PID).
  /attach: {PID|ProcName} /detach[:{PID|ProcName}]	/attachcomeça a coletar dados para o processo especificado pelo ID do processo ou o nome do processo. /detachpára a coleta de dados para o processo especificado, ou para todos os processos se um processo não for especificado.

• Você também pode usar o VSPerfCmd.exe dd255359(v=vs.100).mdmarca/ a opção para inserir uma marca de criação de perfil para o arquivo de dados. O /mark comando adiciona um identificador, um carimbo de hora e uma seqüência de caracteres de um texto opcional definido pelo usuário. Marcas podem ser usadas para filtrar os dados em relatórios do profiler e exibições de dados.

Encerrando a sessão de criação de perfil

Para finalizar uma sessão de criação de perfil, o criador de perfil deve ser desconectado do serviço e explicitamente desligar. Você pode desconectar o serviço nativo que está sendo criado com o método de amostragem, interrompendo o serviço ou chamando o VSPerfCmd /detach opção. Em seguida, chamar o VSPerfCmd /shutdown opção para desativar o profiler e feche o arquivo de dados de criação de perfil.

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

1. Faça o seguinte para desanexar o criador de perfil do aplicativo de destino:

   • Pare o serviço.

     - ou -

   • TipoVSPerfCmd /detach

2. Desligar o profiler. Tipo:

   VSPerfCmd /shutdown

Consulte também

Conceitos

Criação de perfil de linha de comando dos serviços

Outros recursos

Exibições de dados de método de amostragem do Profiler