Quando você coleta estatísticas de fluxo de mensagens, você pode
escolher o destino de saída para os dados.
Selecione um dos seguintes destinos:
Se você parar a coleta de estatísticas a partir da interface com o usuário da web ou o WebSphere Message Broker Explorer, todos os formatos de saída serão desligados. Se a coleção de estatísticas for subsequentemente reiniciada usando-se o comando mqsichangeflowstats, o formato de saída será reconfigurado para o valor padrão user trace, a menos que outros formatos estejam especificados no comando. No entanto, se a coleção de estatísticas for reiniciada usando-se o WebSphere Message Broker Explorer, os dados serão coletados em formato XML; se ela for reiniciada por meio da interface com o usuário da web, os dados serão coletados no formato JSON.
Os dados de estatísticas são gravados na localização de saída
especificada nas seguintes circunstâncias:
- Quando expira o intervalo de dados do archive.
- Quando expira o intervalo do instantâneo.
- Quando o intermediário é encerrado. Os dados que foram coletados pelo intermediário, mas
ainda não foram gravados no destino de saída especificado, serão gravados
durante o encerramento. Portanto, eles podem representar dados para um
intervalo incompleto.
- Qualquer parte da configuração do intermediário é reimplementada. Os dados de configuração reimplementados podem conter uma
configuração atualizada que não está consistente com a estrutura do
registro existente (por exemplo, um fluxo de mensagens pode incluir
um nó adicional ou um grupo de execução pode incluir um novo fluxo de
mensagens). Portanto, os dados atuais,
que podem representar um intervalo incompleto, são gravados
no destino de saída.
A coleta de dados continua para a configuração
reimplementada até que os parâmetros da coleta de dados sejam
alterados ou a coleta de dados seja parada.
- Quando os parâmetros da coleta de dados são modificados. Se você atualizar os parâmetros
configurados para a coleta de dados, todos os dados coletados para o fluxo de mensagens
(ou fluxos de mensagens) serão gravados no destino de saída para manter a
integridade de dados. A coleta de estatísticas será iniciada novamente de acordo com os novos parâmetros.
- Quando ocorre um erro que força a finalização da coleta de dados. Neste caso,
você mesmo deve iniciar novamente a coleta de dados.
Rastreio do Usuário
Você pode especificar que os dados coletados
sejam gravados no log de rastreio do usuário. Os dados são gravados mesmo
quando o rastreio está desativado.
Se nenhum destino de saída for especificado para contabilidade e estatísticas, o padrão será o log de rastreio do usuário.
Os dados são gravados em um dos seguintes locais:
Windows
- Se você configurar o caminho de trabalho usando o parâmetro -w do comando mqsicreatebroker, o local será workpath\common\log.
- Se você não tiver especificado o caminho de trabalho do broker, o
local será:
- No Windows:%ALLUSERSPROFILE%\Application
Data\IBM\MQSI\common\log, em que %ALLUSERSPROFILE% é
a variável de ambiente que define o diretório de trabalho do sistema.
O diretório padrão depende
do sistema operacional.
- No Windows XP e
Windows Server 2003: C:\Documents and
Settings\All Users\IBM\MQSI\common\log
- No Windows Vista, Windows 7 e Windows Server 2008: C:\ProgramData\IBM\MQSI\common\log
Seu computador não pode usar o valor padrão; use %ALLUSERSPROFILE% para assegurar que tenha acessado o local correto.

Linux e
UNIX
- /var/mqsi/common/log
z/OS
- /component_filesystem/log
Publicação XML
É possível especificar que os dados coletados sejam publicados no formato XML e estejam disponíveis para assinantes registrados na rede do broker que assinam o tópico correto.
O tópico no qual os dados são
publicados possui a seguinte estrutura:
$SYS/Broker/brokerName/StatisticsAccounting/recordType/executionGroupLabel/messageFlowLabel
As variáveis correspondem aos seguintes valores:
- brokerName
- O nome do intermediário para o qual as estatísticas são coletadas.
- recordType
- Configure como SnapShot ou Archive, dependendo do tipo de dado
que está sendo assinado. Como alternativa, utilize # para registrar dados de captura instantânea e de archive se estiverem sendo produzidos. Este valor faz distinção entre maiúsculas e minúsculas e deve ser inserido como SnapShot.
- executionGroupLabel
- O nome do grupo de execução para o qual estatísticas são coletadas.
- messageFlowLabel
- A etiqueta do fluxo de mensagens para a qual as estatísticas são coletadas.
Os assinantes podem incluir expressões de filtro
para limitar as publicações recebidas. Por exemplo, eles podem optar por ver apenas
dados de captura instantânea ou ver dados coletados para um único intermediário. Os assinantes podem especificar curingas
(+ e #) para receber publicações que referem-se a vários recursos.
Os
exemplos a seguir mostram o tópico com o qual um assinante se registra
para receber diferentes tipos de dados:
- Registre o seguinte tópico para que o assinante receba dados para todos os fluxos de mensagens em execução no BrokerA:
$SYS/Broker/BrokerA/StatisticsAccounting/#
- Registre o tópico a seguir para o assinante receber apenas
estatísticas de archive que se relacionam a um fluxo de mensagens Flow1 em execução
no grupo de execução Execution no broker BrokerA:
$SYS/Broker/BrokerA/StatisticsAccounting/Archive/Execution/Flow1
- Registre o seguinte tópico para que o assinante receba dados de captura instantânea e de archive para o fluxo de mensagens Flow1 em execução no grupo de execução Execution no intermediário BrokerA
$SYS/Broker/BrokerA/StatisticsAccounting/+/Execution/Flow1
Para obter ajuda com o registro de seu assinante, consulte Message display, test and
performance utilities SupportPac (IH03).
SMF
No z/OS, é possível especificar os dados coletados são gravados no SMF. Os dados de contabilidade e estatísticas utilizam os registros de
tipo 117 do SMF. O SMF suporta a coleta de dados de vários subsistemas e, portanto, você pode
sincronizar as informações registradas de diferentes origens.
Para interpretar as informações
que são registradas, use qualquer programa utilitário que processa registros SMF.