WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Trace

Utilize o nó Trace para gerar registros de rastreio que você pode utilizar para monitorar o comportamento de um fluxo de mensagens.

Este tópico contém as seguintes seções:

Finalidade

Os registros de rastreio podem incorporar texto, conteúdo da mensagem e informações de data e hora para ajudar a monitorar o comportamento do fluxo de mensagens.

Você pode gravar registros no arquivo de rastreio do usuário, ou em outro arquivo ou no registro de erros local (que contém mensagens de erro e de informações gravadas para todos os outros componentes do WebSphere Message Broker). Se você gravar os rastreio em um log de erros local, poderá emitir uma mensagem do catálogo de mensagens padrão fornecido com o WebSphere Message Broker, ou poderá criar seu próprio catálogo de mensagens.

A operação do nó Trace é independente da configuração de rastreio do usuário para o fluxo de mensagens que o contém. Em específico, os registros gravados pelo nó Trace no log de rastreio do usuário são gravados mesmo que o rastreio do usuário não esteja ativo para o fluxo de mensagens.

O nó Trace está contido no repositório Construção da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Ícone do nó Trace

Utilizando este nó em um fluxo de mensagens

Veja as amostras a seguir para consultar sobre como utilizar este nó:

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Inclua um nó Trace para ajudar a diagnosticar erros em seu fluxo de mensagens. Ao rastrear o conteúdo da mensagem em vários pontos no fluxo, você pode determinar a seqüência de processamento. Você pode configurar o nó Trace para registrar o conteúdo de uma mensagem e verificar a ação de um nó específico na mensagem. Por exemplo, você pode incluir um nó Trace imediatamente após um nó Compute para verificar se a mensagem de saída possui o formato esperado.

Também é possível usar o nó Trace para fornecer informações na manipulação de erros em seus fluxos de mensagens. Por exemplo, é possível usar este nó para gravar falhas no processamento por causa de erros no conteúdo ou formato de uma mensagem.

Quando você testar o fluxo de mensagens e provar que sua operação está correta, remova os nós Trace do fluxo de mensagens ou desative-os.

Terminais e Propriedades

Quando tiver colocado uma instância do nó Trace em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.

Os terminais do nó Trace são descritos na tabela a seguir.

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Saída O terminal de saída através do qual a mensagem será propagada.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).

As propriedades Descrição do nó Trace são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do Nó Não Não O tipo de nó: Trace O nome do nó.
Descrição Breve Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.

As propriedades Básicas do nó Trace são descritas na tabela a seguir.

Propriedade M C Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Destino Sim Não Rastreio do Usuário O destino do registro de rastreio gravado pelo nó. O Destino refere-se ao computador que hospeda o intermediário no qual o nó Trace é implementado:
  • Para gravar o registro de rastreio no registro de erros do sistema local, selecione Registro de Erros Local.

    As informações incluída no registro de rastreio são gravadas em um dos seguintes locais:

    • Windows platformNos sistemas Windows, os dados são gravados a um Log do Evento (visualização Aplicativos)
    • Linux platformUNIX platformNos sistemas Linux e UNIX, dados são gravados no syslog
    • z/OS platformNos sistemas z/OS, dados são gravados no console do operador

    UNIX platformEm sistemas UNIX, as entradas syslog são restritas em comprimento e as mensagens são truncadas pelo caractere de nova linha. Para registrar uma grande quantidade de dados em um log no File ou Rastreio do Usuário.

    Se você selecionar Log de Erros Local, indique o número da mensagem de rastreio que deve ser gravada e o catálogo de mensagens no qual a mensagem está definida.

    • Se você deixar o Catálogo de Mensagens em branco, o catálogo de mensagens padrão será utilizado como a origem da mensagem que deve ser gravada.

      Você também deve inserir o número do erro do registro em Número da Mensagem. Os números 3051 a 3099 são reservados no catálogo padrão para esta utilização. O texto de cada uma dessas mensagens no catálogo de mensagens padrão é idêntico, mas se você usar um número diferente nesse intervalo para cada situação que você rastreia, é possível identificar a causa exata do erro. O número da mensagem padrão é 3051.

    • Se você criar seu próprio catálogo de mensagens, insira o nome completo do arquivo para seu catálogo em Catálogo de Mensagens.

      Você também deve digitar o número apropriado para a mensagem no catálogo que você deseja gravar no registro de erros local no Número da Mensagem. Em alguns sistemas, os números de mensagens que terminam em 00 são reservados para uso do sistema; não inclua mensagens com números como 3100 em seu catálogo de mensagens.

 
       
  • Para gravar o registro de rastreio no log de rastreio do usuário gerado pelo sistema, selecione Rastreio do Usuário (User Trace).

    Esses registros são gravados, independente da definição da propriedade Rastreio do Usuário, para o fluxo de mensagens implementado.

    O local dos logs de rastreio depende do seu ambiente:
    Windows platformWindows
    Se você configurar o caminho de trabalho usando o parâmetro -w do comando mqsicreatebroker, o local será workpath\log.
    Se você não tiver especificado o caminho de trabalho do broker, o local será: %ALLUSERSPROFILE%\IBM\MQSI\common\log em que %ALLUSERSPROFILE% é a variável de ambiente que define o diretório ativo do sistema. O diretório padrão depende do sistema operacional.
    • No Windows XP e Windows Server 2003: C:\Documents and Settings\All Users\IBM\MQSI\common\log
    • No Windows Vista e no Windows Server 2008: C:\ProgramData\IBM\MQSI\common\log
    Seu computador não pode usar o valor padrão; use %ALLUSERSPROFILE% para assegurar que tenha acessado o local correto.
    Linux platformUNIX platformLinux e UNIX
    /var/mqsi/common/log
    z/OS platformz/OS
    /component_filesystem/log

    O nome do arquivo é formado pelo nome do broker, pelo UUID do broker e por um sufixo userTrace.bin (por exemplo, broker.e51906cb-dd00-0000-0080-b10e69a5d551.userTrace.bin.0). Utilize os comandos mqsireadlog e mqsiformatlog depois de visualizar o registro de rastreio do usuário.

 
       
  • Para gravar o registro de rastreio em um arquivo de sua escolha, selecione Arquivo (File).

    Se você selecionar esta opção, também deverá configurar Caminho de Arquivo como o nome do caminho completo para o rastreio. Se você não configurar o caminho, o local do arquivo dependerá do sistema; por exemplo, no z/OS, o arquivo será criado no diretório inicial do ID de serviço do broker.

    Você pode utilizar qualquer nome para o arquivo de rastreio; por exemplo, c:\user\trace\trace.log

    Se você especificar um arquivo que não existe ainda, o arquivo será criado. No entanto, os diretórios não são criados por este processo, portanto, o caminho completo deve existir.

    O arquivo é gravado como texto, no formato especificado pela propriedade Padrão. Você não precisa executar o comando mqsireadlog ou mqsiformatlog no arquivo.

    Se um erro de gravação de arquivo ocorrer durante o processamento (devido a uma condição de falta de espaço, por exemplo), uma única mensagem de aviso, BIP4065, será gravada no log de erros do sistema local e o fluxo de mensagens continuará processando mensagens sem registrar erros adicionais. Verifique o log de erros cuidadosamente para obter uma mensagem desse tipo.

  • Se não desejar gravar registros de rastreio, selecione Nenhum. Também é possível desativar nós Trace.
 
Caminho do Arquivo Não Sim   O nome completo do arquivo no qual gravar registros. Essa propriedade só será válida se Destino (Destination) estiver definido como Arquivo (File). filePath
Padrão Não Não   Os dados que devem ser incluídos no registro de rastreio. Crie um padrão de ESQL para especificar quais informações gravar. Se você gravar o registro de rastreio no log de erros local, o padrão controlará as informações gravadas no texto do número da mensagem selecionada. Se você utilizar o catálogo de mensagens padrão e um número entre 3051 e 3099, as informações padrão serão inseridas como &1 no texto da mensagem.
  • Você pode gravar o texto corrido que é copiado para o registro de rastreio exatamente conforme foi inserido.
  • É possível identificar partes da mensagem para gravar no registro de rastreio, especificando os identificadores de campo completos entre os caracteres ${ e }. Para registrar a mensagem inteira, especifique ${Root}. Outros padrões comuns são ${LocalEnvironment} ${Environment} e ${ExceptionList}. Para obter informações adicionais, consulte Visualizando a Árvore Mensagem Lógica na Saída do Rastreio.
  • Utilize as funções ESQL para fornecer informações adicionais; por exemplo, utilize a função ESQL CURRENT_DATE para registrar a data, a hora, ou ambas, em que o registro de rastreio é gravado.
O padrão mostrado aqui inclui algumas das opções disponíveis. O padrão grava uma linha de texto inicial, registra dois elementos da mensagem atual e inclui um registro de data e hora simples:
Mensagem passada pelos seguintes campos:
O nome da loja é ${Body.storedetailselement.storename}
O total de vendas é ${Body.totalselement.totalsales}
Hora: ${EXTRACT(HOUR FROM CURRENT_TIMESTAMP)}
		:${EXTRACT(MINUTE FROM CURRENT_TIMESTAMP)}
O registro de rastreio resultante é:
Mensagem passada pelos seguintes campos:
O nome da loja é 'SRUCorporation'
O total de vendas é '34.98'   
Hora: 11:19

Um padrão que contém erros de sintaxe não impede a implementação de um fluxo de mensagens que contém o nó Trace, mas o nó não grava registros de rastreio.

 
Catálogo de Mensagens Não Não   O nome do catálogo de mensagens a partir do qual o texto do erro para o número do erro da exceção é extraído. O valor padrão (em branco) indica que a mensagem é obtida no catálogo de mensagens fornecido com o WebSphere Message Broker. Consulte Criando Catálogos de Mensagens para obter informações adicionais.  
Número da Mensagem Não Não 3051 O número do erro da mensagem gravada.  
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:19


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac04840_