Rastreio do Usuário

O rastreio do usuário é um dos dois tipos de rastreio opcional disponíveis em WebSphere Message Broker. O rastreio do usuário está inativo por padrão; é necessário ativá-lo explicitamente utilizando um comando ou selecionando opções no ambiente de trabalho, quando precisar de informações adicionais àquelas fornecidas pelas entradas gravadas no Log de Eventos.

Para obter informações adicionais sobre registros, consulte Registros.

Geralmente, o rastreio do usuário é utilizado para depurar seus aplicativos, pois pode rastrear intermediários, grupos de execução e fluxos de mensagens implementados.

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

Quando ativar o rastreio do usuário, você causará 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 logs de rastreio depende do seu ambiente:
Windows platform Windows
Se o caminho de trabalho for configurado utilizando o parâmetro -w do comando mqsicreatebroker, o local será workpath\log.
Se o caminho de trabalho do intermediário não tiver sido especificado, o local padrão será %ALLUSERSPROFILE%\Application Data\IBM\MQSI\common\log em que a configuração padrão para a variável de ambiente%ALLUSERSPROFILE% seja C:\Documents and Settings\All Users. O valor real deve ser diferente em seu computador.
Linux platformUNIX platform Linux e UNIX
/var/mqsi/common/log
z/OS platform 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. É possível especificar a saída que será direcionada a 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ó Trace em seus fluxos de mensagens quando os estiver desenvolvendo e testando, esta opção dá a você não apenas a capacidade de rastrear mensagens e atividades no fluxo, mas também permite que você especifique um arquivo de destino alternativo para o conteúdo do rastreio, para isolar o detalhe no qual estiver interessado. Para obter detalhes sobre como utilizar e configurar um nó Trace, consulte o tópico Nó Trace.

Conceitos relacionados
Registros
Trace
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:12:49

an01310_