Como coletar dados do IntelliTrace para ajudar a depurar problemas difíceis

Usando o Microsoft Test Manager ou o Visual Studio, você pode configurar o adaptador de dados de diagnóstico para que o IntelliTrace colete informações de rastreamento de diagnóstico específicas. Os testes podem usar esse adaptador, o teste pode coletar eventos de diagnóstico significativos para o aplicativo que um desenvolvedor poderá usar depois para rastrear o código para encontrar a causa de um bug. O adaptador de dados de diagnóstico para IntelliTrace pode ser usado em testes manuais ou automatizados.

Dica

IntelliTrace só funciona em um aplicativo gravado usando-se código gerenciado.Se estiver testando um aplicativo Web que use um navegador como um cliente, você não deverá habilitar o IntelliTrace para o cliente nas configurações de teste porque nenhum código gerenciado está disponível para rastreamento.Nesse caso, você talvez queira configurar um ambiente e coletar remotamente os dados do IntelliTrace em seu servidor Web.Para obter mais informações sobre os ambientes, consulte Configurando máquinas de teste para executar testes ou coletar dados.

Os dados do IntelliTrace são armazenados em um arquivo com uma extensão .iTrace. Ao executar o teste e uma etapa falhar, você pode criar um bug. O arquivo do IntelliTrace que contém as informações de diagnóstico é anexado automaticamente a esse bug.

Dica

O adaptador de dados de diagnóstico do IntelliTrace não cria um arquivo do IntelliTrace quando um passo de teste é bem-sucedido.Ele salva um arquivo somente em um caso de teste com falha ou quando você envia um bug.

Os dados coletados no arquivo do IntelliTrace aumentam a produtividade de depuração reduzindo o tempo necessário para reproduzir e diagnosticar um erro no código. Além disso, como você pode compartilhar o arquivo do IntelliTrace com outra pessoa que pode replicar a sessão local no computador, ele reduz a probabilidade de um bug não ser reproduzível.

Aviso

Se você habilitar o IntelliTrace em suas configurações de teste, coletar dados de cobertura de código não funcionará.Para saber mais, veja A configuração de cobertura de código usando configurações de teste foi preterida

Aviso

O adaptador de dados de diagnóstico do IntelliTrace funciona com a instrumentação de um processo gerenciado, que deverá ser realizado depois que os testes da execução de teste forem carregados.Se o processo que você deseja monitorar já tiver começado, nenhum arquivo do IntelliTrace será coletado porque o processo já está em execução.Para evitar isso, certifique-se de que o processo esteja parado antes dos testes serem carregados.Inicie o processo depois que os testes forem carregados ou o primeiro teste for iniciado.

O procedimento a seguir descreve como configurar os dados do IntelliTrace que você deseja coletar. Essas etapas se aplicam ao editor de configuração em Microsoft Test Manager e à caixa de diálogo Configurações de Teste no Visual Studio.

Dica

A conta de usuário do agente de teste usada para coletar dados do IntelliTrace deve ser um membro do grupo Administradores.Para obter mais informações, consulte Instalando e configurando agentes e controladores de teste.

Configurar os dados a serem coletados com o adaptador de dados de diagnóstico do IntelliTrace

Antes de executar as etapas nesse procedimento, você deverá abrir as configurações de teste no Microsoft Test Manager ou no Visual Studio e selecionar a página Dados e Diagnósticos.

Para configurar os dados a serem coletados com o adaptador de dados de diagnóstico do IntelliTrace

  1. Selecione a função a ser usada para coletar dados do IntelliTrace.

  2. Selecione IntelliTrace.

  3. Se estiver adicionando o IntelliTrace para uma função de cliente da Web ou para um aplicativo Web do ASP.NET, você também deverá selecionar Proxy de Cliente do ASP.NET para IntelliTrace e Impacto de Teste.

    Esse proxy permite que você colete informações sobre as chamadas http de um cliente para um servidor Web para os adaptadores de dados de diagnóstico do IntelliTrace e de Impacto de Teste.

    Aviso

    Se optar por usar uma conta personalizada para a identidade que está sendo usada no pool de aplicativos do IIS (Servidor de informações da Internet) onde deseja coletar dados do Intellitrace, você deverá criar o perfil de usuário local no computador do IIS para a conta personalizada que está sendo usada.Você pode criar o perfil local para a conta personalizada fazendo logon no computador do IIS localmente uma vez ou executando a seguinte linha de comando com as credenciais da conta personalizada:

    runas /user:domain\name /profile cmd.exe

  4. Escolha Configurar para o IntelliTrace modificar as configurações do IntelliTrace padrão.

    A caixa de diálogo para configurar os dados que serão coletados é exibida.

    Aviso

    Se você habilitar a coleta de dados do IntelliTrace, a coleta de dados de cobertura de código não funcionará.

  5. Escolha a guia Geral. Selecione Apenas eventos do IntelliTrace para registrar eventos de diagnóstico significativos que tenham impacto mínimo sobre o desempenho durante o teste.

    -ou-

    Selecione Eventos do IntelliTrace e informações de chamada para registrar eventos de diagnóstico e rastreamento no nível de método que mostram informações de chamada. Esse nível de rastreamento pode afetar o desempenho quando você executa os testes.

  6. Para coletar dados do aplicativo ASP.NET em execução no IIS, selecione Coletar dados de aplicativos ASP.NET em execução no IIS. Configure o agente de teste na função servidor Web. Consulte Instalando e configurando agentes e controladores de teste.

  7. Escolha a guia Módulos. Selecione Coletar dados de todos os módulos, exceto os seguintes e use Adicionar para adicionar à lista de módulos e Remover para remover um módulo. Essa opção permite incluir todos os módulos em execução no sistema, exceto os módulos que você especifica.

    -ou-

    Selecione Coletar dados apenas dos módulos a seguir e use Adicionar para adicionar à lista de módulos e Remover para remover um módulo. Essa opção permite especificar exatamente quais módulos você deseja.

    Dica

    Se possível, selecione os processos específicos que deseja monitorar.Isso é recomendado para ter o desempenho ideal.

  8. Escolha a guia Processos. Selecione Coletar dados de todos os processos, exceto os seguintes e use Adicionar para adicionar à lista de processos e Remover para remover um processo. Essa opção permite incluir todos os processos em execução no sistema, exceto os processos que você especifica.

    -ou-

    Selecione Coletar dados apenas a partir dos processos especificados e use Adicionar para adicionar à lista de processos e Remover para remover um processo. Essa opção permite especificar exatamente quais processos você deseja.

  9. (Opcional) Escolha guia Eventos do IntelliTrace. Marque ou desmarque cada categoria de evento do IntelliTrace que você deseja incluir ou excluir ao coletar eventos de diagnóstico.

  10. (Opcional) Expanda cada categoria de evento do IntelliTrace e marque ou desmarque cada evento específico que você deseja incluir ou excluir nos eventos do IntelliTrace.

    Dica

    Para obter mais informações, consulte Configurar o IntelliTrace para coletar informações de depuração.

  11. (Opcional) Escolha guia Avançado. Em seguida, escolha a seta ao lado de Quantidade de espaço máximo em disco para registro e selecione o tamanho máximo que você deseja habilitar para o arquivo do IntelliTrace a ser usado.

    Dica

    Se você aumentar o tamanho do registro, um problema de tempo limite poderá ocorrer quando você salvar esse registro com seus resultados de análise.Para obter mais informações sobre como aumentar os valores de tempo limite para adaptadores de dados de diagnóstico, consulte Como evitar tempos limites para adaptadores de dados de diagnóstico.

  12. Se você estiver usando o Microsoft Test Manager, escolha Salvar. Se você estiver usando o Visual Studio, escolha OK. As configurações do IntelliTrace agora estão definidas e salvas em suas configurações de teste.

    Dica

    Para redefinir a configuração desse adaptador de dados de diagnóstico, escolha Restaurar configuração padrão para o Visual Studio ou Redefinir para o padrão para o Microsoft Test Manager.

Orientação

Para obter mais informações, consulte Teste para entrega contínua com Visual Studio 2012 – Capítulo 6: Uma caixa de ferramentas de teste.

Consulte também

Tarefas

Criar configurações de teste para testes de sistema automatizados usando o Microsoft Test Manager

Conceitos

Configurando máquinas e coletando informações de diagnóstico usando configurações de teste

Depurar seu aplicativo gravando execução de código com o IntelliTrace

Outros recursos

Coletar mais dados de diagnóstico em testes manuais

Especificando configurações de teste do Visual Studio

Incluindo dados de rastreamento de diagnóstico que sejam difíceis de reproduzir