Este tópico contém as seguintes seções:
Utilize o nó Trace para gerar registros de rastreio que podem incorporar texto, conteúdo de mensagem e informações de data e hora, para ajudá-lo 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 log de erros local (que contém mensagens de erro e de informações gravadas para todos os outros componentes do ). Se você gravar os rastreio para um log de erros local, poderá emitir uma mensagem a partir do catálogo de mensagens padrão fornecido com o , ou poderá criar seu próprio catálogo de mensagens.
A operação do nó Trace é independente da definição de rastreio do usuário para o fluxo de mensagens em que reside. Em particular, 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 no momento para o fluxo de mensagens.
O nó Trace é representado no pelo seguinte ícone:
Veja a amostra a seguir para consultar como utilizar este nó:
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ê também pode configurar o nó de rastreio para registrar o conteúdo da 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.
Remova os nós Trace de seu fluxo quando você tiver testado e provado que sua operação está correta.
Você também pode utilizar o nó Trace para fornecer informações no tratamento de erros em seus fluxos de mensagens. Por exemplo, você pode utilizar esse nó para registrar falhas no processamento, devido a erros no conteúdo ou formato da mensagem.
Quando você tiver colocado uma instância do nó Trace em um fluxo de mensagens, será possível configurá-lo. Clique com o botão direito no nó da tela do editor e selecione Propriedades.As propriedades básicas do nó são exibidas.
Todas as propriedades mandatórias, para as quais é necessário inserir um valor (aquelas que não possuem um valor padrão definido) são marcadas com um asterisco no diálogo das propriedades.
Configure o nó Trace da seguinte forma:
As informações incluídas no registro de rastreio são gravadas em:
Se você selecionar essa opção, deverá indicar o número da mensagem de rastreio a ser gravada e o catálogo de mensagens no qual a mensagem está definida.
Você também deve inserir o número do erro do registro em Número da Mensagem. Os números de 3051 a 3099 são reservador no catálogo (padrão) para esse uso. O texto de cada uma dessas mensagens no catálogo de mensagens padrão é idêntico, mas se você utilizar um número diferente nesse intervalo para cada situação que for rastreada, será possível identificar a causa exata do erro. O número da mensagem padrão é 3051.
Você também deve digitar o número apropriado para a mensagem no catálogo que você deseja gravar no log de erros local no Número da Mensagem. Em algumas plataformas, os números de mensagens que terminam com 00 são reservados para uso do sistema; não inclua mensagens com números como 3100 no seu catálogo de mensagens.
Esses registros são gravados, independente da definição da propriedade Rastreio do Usuário, para o fluxo de mensagens implementado.
O rastreio do usuário é gravado no subdiretório \log do diretório raiz (por exemplo, o padrão no Windows é c:\Arquivos de Programas\IBM\). O nome do arquivo é formado pelo nome do intermediário, pelo UUID do intermediário e por um sufixo userTrace.bin (por exemplo, broker.e51906cb-dd00-0000-0080-b10e69a5d551.userTrace.bin.0). Utilize os comandos e depois de visualizar o log de rastreio do usuário.
Se você selecionar essa opção, também deverá definir Caminho do Arquivo para o nome do caminho completo para o rastreio. Se você não definir o caminho, o local do arquivo dependerá do sistema. Por exemplo, no z/OS, o arquivo é criado no diretório pessoal do ID de serviço do intermediário.
Você pode utilizar qualquer nome para o arquivo de rastreio. Por exemplo, c:\$user\trace\trace.log.
Se você especificar um arquivo que ainda não existe, ele será criado. No entanto, os diretórios não são criados por esse processo, portanto, o caminho completo já deve existir.
O padrão abaixo ilustra algumas das opções disponíveis. Ele grava uma linha de texto inicial, registra dois elementos da mensagem atual e adiciona uma 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 contendo o nó Trace, mas o nó não grava nenhum registro de rastreio.
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.
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 é mandatória (marcado com um asterisco no diálogo de propriedades caso seja necessário digitar um valor quando nenhum padrão for definido), a coluna com cabeçalho C indica se a propriedades é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens no arquivo bar para implementá-lo).
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ó. As opções válidas são Rastreio do Usuário, Arquivo, Log de Erros Local e Nenhum. |
Caminho do Arquivo | Não | Sim | O nome de arquivo completo referente ao arquivo no qual os registros são gravados. Válido apenas se Destino estiver definido como Arquivo. | |
Padrão | Não | Não | Os dados que devem ser incluídos no registro 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 (vazio) indica que a mensagem foi obtida do catálogo de mensagens fornecido com o . | |
Número da Mensagem | Não | Não | 3051 | O número do erro da mensagem gravada. |
As propriedades de Descrição do nó Trace são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
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. |
Conceitos relacionados
Fluxos de Mensagem
Depurador de Fluxo
Tarefas relacionadas
Decidindo Quais Nós Utilizar
Tratando Erros em Fluxos de Mensagens
Editando Propriedades Configuráveis
Diagnosticando Erros
Referências relacionadas
Nó Throw
Nó TryCatch
Log de Erros Local
Rastreio do Usuário
Avisos |
Marcas |
Downloads |
Biblioteca |
Suporte |
Feedback
![]() ![]() |
ac04840_ |