Rastreio do Usuário

O rastreio do usuário é um dos dois tipos de rastreio opcional disponíveis no WebSphere Message Broker. O rastreio do usuário está inativo por padrão e deve ser ativado explicitamente por um comando ou pelo workbench quando são necessárias informações adicionais que as fornecidas pelas entradas no Registro de Eventos. Para obter informações adicionais sobre registros, consulte Registros.

O rastreio do usuário geralmente é utilizado para depurar os aplicativos, e pode rastrear intermediários porque pode rastrear intermediários, grupos de execução e fluxos de mensagens implementados.

Você pode utilizar o workbench para controlar a maior parte da atividade de rastreio de que necessita. O workbench também permite iniciar e parar o rastreio em sistemas remotos.

Quando ativar o rastreio do usuário, você causa o processamento adicional para cada atividade no componente que está sendo rastreado. Grandes quantidades de dados são geradas pelos componentes. Espera-se que ocorra algum impacto no desempenho enquanto o rastreio do usuário estiver ativo. É possível limitar esse processamento adicional sendo seletivo sobre o que se rastreia e restringindo o tempo durante o qual o rastreio está ativo.

Os Arquivos de Registro do Rastreio do Usuário

Quando o rastreio está ativo para qualquer componente, as informações são registradas em formato binário. O local dos registros de rastreio é o seguinte:
Windows
Se você configurar o workpath utilizando o parâmetro -w do comando mqsicreatebroker, o local será workpath\log . Se você não especificar o workpath do intermediário, o local será C:\Documents and Settings\All Users\Application Data\IBM\MQSI\common\log.
UNIX
/var/mqsi/common/log
z/OS
/component_filesystem/log

Os nomes dos arquivos refletem o componente e subcomponente para os quais o rastreio está ativo. Por exemplo, o nome do intermediário e o identificador exclusivo do grupo de execução formam parte do nome do arquivo quando se estiver rastreando atividades nesse grupo de execução.

Por exemplo, se você tiver criado um intermediário denominado WBRK_BROKER, poderá ver os seguintes arquivos no subdiretório do registro:
WBRK_BROKER.682ec116-dc00-0000-0080-ce28a236e03d.userTrace.bin.1WBRK_BROKER.682ec116-dc00-0000-0080-ce28a236e03d.userTrace.bin.2

Você não pode ver esses arquivos diretamente; deverá utilizar os comandos fornecidos para acessar as informações de rastreio e convertê-las para um formato que possa ser visualizado. Utilize o comando mqsireadlog para recuperar o registro de rastreio para o componente especificado. Emita o comando no computador no qual o registro foi gerado. Você pode especificar a saída a ser direcionada para um arquivo, que é independente de sistema operacional e pode ser transferida para outros sistemas para procura ou formatação utilizando o comando mqsiformatlog .

Utilizando um Nó Trace

Se você incluir um nó Rastreio em seu fluxos de mensagens quando os estiver desenvolvendo e testando, esse opção não fornecerá somente a capacidade de rastrear mensagens e atividade no fluxo, mas também permitirá especificar um arquivo de destino alternativo para o conteúdo de rastreio para isolar o detalhe no qual está interessado. Para obter detalhes sobre como utilizar e configurar um nó de rastreio, consulte o tópico Nó Trace.

Conceitos relacionados
Registros
Trace
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an01310_