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:
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 IBM® Integration Bus). 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 IBM Integration Bus, 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 IBM Integration Toolkit pelo seguinte ícone:

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 IBM Integration 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 IBM Integration 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.
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 |
|---|---|
| In | O terminal de entrada que aceita a mensagem para processamento pelo nó. |
| Out | 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 | A | Padrão | Descrição |
|---|---|---|---|---|
| Nome do Nó | Não | Não | O tipo de nó: Trace | O nome do nó. |
| Descrição Curta | 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 | A | 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:
|
|
|
|||||
|
|||||
| 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.
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:
O registro de rastreio
resultante é:
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 IBM Integration Bus. 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. |
| Propriedade | M | A | Padrão | Descrição |
|---|---|---|---|---|
| Eventos | Não | Não | Nenhuma | 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. |