Instalar e usar o utilitário de rastreamento do adaptador BizTalk no BizTalk Server

  • Artigo

Este artigo passo a passo descreve como instalar o Utilitário de Rastreamento do Adaptador do Microsoft BizTalk. Ele também discute como executar o Utilitário de Rastreamento do Adaptador BizTalk e como ter o arquivo de rastreamento gerado analisado.

Versão original do produto: BizTalk Server 2009
Número de KB original: 835451

Instalar o utilitário de rastreamento do adaptador BizTalk

Para instalar o Utilitário de Rastreamento do Adaptador BizTalk no Windows Server 2008, siga estas etapas:

  1. Baixe o arquivo Tracelog.exe e instale a Atualização do Microsoft Software Development Kit do Windows (SDK do Windows) (SDK) para Windows Vista.

    Observação

    O arquivo Tracelog.exe não está incluído no SDK do Windows do Windows Server 2008 e do Microsoft .NET Framework 3.5. Portanto, instale o SDK do Windows Vista no Windows Server 2008.

    Para obter mais informações, consulte Software Development Kit do Windows (SDK do Windows) (SDK) para Windows Server 2008 e .NET Framework notas de versão 3.5.

  2. Quando a janela Opções de Instalação for exibida, expanda Ferramentas de Desenvolvedor e expanda Ferramentas de Desenvolvimento do Windows. Em seguida, selecione a caixa marcar Ferramentas de Desenvolvimento do Win32.

  3. Desmarque as outras caixas marcar e continue a instalação.

  4. Localize a pasta a seguir e copie o arquivo Tracelog.exe para a pasta de instalação BizTalk Server:
    Drive:\MicrosoftSDKInstallationFolder\Bin.

Por padrão, o arquivo Tracelog.exe está na pasta C:\Arquivos do Programa\Microsoft SDKs\Windows\v6.0\Bin. A pasta de instalação BizTalk Server também contém o arquivo Trace.cmd.

Para instalar o Utilitário de Rastreamento do Adaptador BizTalk no Windows Server 2003, siga estas etapas:

  1. Baixe o arquivo Tracelog.exe e instale o SDK da Plataforma do Windows Server 2003 R2.

  2. Quando a janela Selecionar Um Tipo de Instalação for exibida, selecione Personalizado.

  3. Na caixa de diálogo Instalação Personalizada , expanda o SDK do Microsoft Windows Core e expanda Ferramentas.

  4. Selecione Ferramentas (Intel de 64 bits) e selecione Será instalado no disco rígido local.

  5. Selecione Não estará disponível em todo o resto e, em seguida, continuará a instalação.

  6. Localize a pasta Drive:\MicrosoftPlatformSDKInstallationFolder\Bin e copie o arquivo Tracelog.exe para a pasta de instalação BizTalk Server.

    Por padrão, o arquivo Tracelog.exe está na pasta C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\bin. A pasta de instalação BizTalk Server também contém o arquivo Trace.cmd.

Habilitar o utilitário de rastreamento do adaptador BizTalk

Para habilitar o Utilitário de Rastreamento do Adaptador BizTalk, siga estas etapas:

  1. Em um prompt de comando, altere o diretório atual para o diretório em que BizTalk Server está instalado. Por padrão, BizTalk Server é instalado no diretório Program Files\Microsoft BizTalk Server 200x.

  2. Insira o seguinte comando:

    trace -tools "Path of the BizTalk Adapter Trace Utility"

Por padrão no Windows Server 2003, o Utilitário de Rastreamento do Adaptador BizTalk está no seguinte diretório:
C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Bin.

Por padrão no Windows Server 2008, o Utilitário de Rastreamento do Adaptador BizTalk está no seguinte diretório:
C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin.

Você deve incluir o caminho do Utilitário de Rastreamento do Adaptador BizTalk entre aspas.

Por exemplo, insira o seguinte comando no Windows Server 2003:

trace -tools "C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Bin"

No Windows Server 2008, insira o seguinte comando:

trace -tools "C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin"

A -tools opção indica o local do arquivo Tracelog.exe para o arquivo Trace.cmd .

Executar o utilitário de rastreamento do adaptador BizTalk

Para executar o Utilitário de Rastreamento do Adaptador BizTalk em um cenário, siga estas etapas:

  1. Em um prompt de comando, insira o seguinte comando:

    trace -start -all

  2. Reproduza o cenário que você deseja rastrear.

  3. Em um prompt de comando, insira o seguinte comando:

    trace -stop

Depois de interromper o rastreamento, um arquivo binário para versões BizTalk Server 2006 e posteriores que tem o nome BtsTrace.bin é gerado na pasta em que BizTalk Server está instalado. No BizTalk Server 2004, um arquivo binário chamado Bts2004.bin é gerado na pasta em que BizTalk Server está instalado.

Você pode enviar o arquivo .bin de rastreamento BizTalk Server para os Serviços de Suporte ao Cliente da Microsoft para análise.