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 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 ambiente de trabalho pelo seguinte ícone:
Veja as amostras a seguir para consultar sobre como utilizar este nó:
Você pode visualizar amostras apenas quando utilizar o centro de informações integrado ao Message Brokers 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.
Você também pode utilizar o nó Trace para fornecer informações na manipulação de erros em seus fluxos de mensagens. Por exemplo, é possível utilizar esse nó para registrar falhas devido a erros no conteúdo ou formato de uma mensagem.
Remova os nós Trace de seu fluxo de mensagens quando tiver testado o fluxo de mensagens e tiver provado que sua operação está correta.
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. Para exibir as propriedades do nó no diálogo Propriedades, dê um clique duplo no nó ou clique com o botão direito no nó e clique em 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 |
---|---|---|---|---|
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 de arquivo completo referente ao arquivo no qual os registros são gravados. Essa propriedade só será válida se Destino (Destination) estiver definido como Arquivo (File). | |
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 a seguir ilustra algumas opções que estão
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.![]() ![]() |
|
Número da Mensagem | Não | Não | 3051 | O número do erro da mensagem gravada. |