Formatos de Saída para Dados de Contabilidade e Estatísticas do Fluxo de Mensagens

Quando você coleta estatísticas de fluxo de mensagens, você pode escolher o destino de saída para os dados.

É possível selecionar um ou mais dos seguintes destinos, usando o comando mqsichangeflowstats: Se nenhum formato for especificado, por padrão, os dados contábeis e estatísticos serão enviados para o log de rastreio do usuário. Para obter mais informações sobre a especificação de um formato de saída, consulte Comando mqsichangeflowstats.

Se você iniciar a coleta de dados estatísticos do fluxo de mensagens usando o IBM® Integration Explorer, as estatísticas serão emitidas em formato XML, além de quaisquer outros formatos que estejam sendo emitidos. Se você iniciar a coleta de dados estatísticos do fluxo de mensagens usando a interface com o usuário da web, as estatísticas serão emitidas no formato JSON, além de quaisquer outros formatos que já estejam sendo emitidos. Como resultado, se a coleta de estatísticas for iniciada através de ambos, o IBM Integration Explorer e a interface com o usuário da web, os dados serão emitidos em ambos os formatos XML e JSON. Se o formato de saída não for anteriormente especificado e, portanto, padronizado recentemente para o rastreio do usuário, o formato especificado recentemente substitui o padrão, e os dados não serão mais emitidos para o rastreio do usuário. No entanto, se o rastreio do usuário for explicitamente especificado, quaisquer formatos adicionais selecionados subsequentemente serão emitidos além do rastreio do usuário.

Se você usar o comando mqsichangeflowstats para especificar explicitamente os formatos de saída necessários, os formatos especificados pelo comando substituirão os formatos emitidos atualmente para o fluxo de mensagens (e não adicionados a eles).

Se você parar a coleta de estatísticas a partir da interface com o usuário da web ou o IBM Integration 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 IBM Integration 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:

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. Se um ou mais formatos de saída forem subsequentemente especificados, os formatos especificados substituirão o padrão e os dados não serão mais emitidos para o rastreio do usuário. No entanto, se o rastreio do usuário for explicitamente especificado, quaisquer formatos adicionais selecionados subsequentemente serão emitidos além do rastreio do usuário.

Os dados são gravados em um dos seguintes locais:

Windows platform 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.Seu computador não pode usar o valor padrão; use %ALLUSERSPROFILE% para assegurar que tenha acessado o local correto.
Linux platformUNIX platform Linux e UNIX
/var/mqsi/common/log
z/OS platform z/OS
/component_filesystem/log

Publicação JSON

É possível especificar que os dados coletados sejam publicados no formato JSON, que está disponível para visualização na interface com o usuário da web. Se a coleção de estatísticas for iniciada por meio da interface com o usuário da web, os dados de estatísticas serão também emitidos no formato JSON, além quaisquer outros formatos que já estejam sendo emitidos.

O tópico no qual os dados são publicados possui a seguinte estrutura:
$SYS/Broker/brokerName/Statistics/JSON/SnapShot/executionGroupName/applications/applicationName
/libraries/libraryName/messageflows/messageFlowName
As variáveis correspondem aos seguintes valores:
brokerName
O nome do broker para o qual as estatísticas são coletadas
executionGroupName
O nome do grupo de execução para o qual as estatísticas são coletadas
applicationName
O nome do aplicativo para o qual as estatísticas são coletadas
libraryName
O nome da biblioteca para a qual estatísticas são coletadas
messageFlowName
O nome do fluxo de mensagens para o qual as estatísticas são coletadas

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. Se a coleta de estatísticas for iniciada por meio do IBM Integration Explorer, os dados estatísticos serão emitidos no formato XML, além de quaisquer outros formatos que já estejam sendo emitidos.

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.

Avisos | Marcas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última atualização:
        
        Última atualização: 2013-07-16 02:03:46


Tópico de ConceitoTópico de Conceito | IBM Integration Bus Versão 9.0.0.0 | ac19106_