WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento

No Editor de Fluxo de Mensagens, use a guia Monitoramento nas propriedades de um nó para incluir um ou mais eventos de monitoramento.

Antes de começar:
Leia os seguintes tópicos: É necessário ter um fluxo de mensagens que contenha um nó ao qual você deseja incluir um evento de monitoramento.

É possível usar expressões XPath 1.0 para configurar um evento de monitoramento. Algumas expressões XPath, listadas em Expressões XPath que não São Apropriadas para a Opção Exportar Informações de Monitoramento, não são apropriadas para uso com a opção de informações de monitoramento de exportação (Criando um Modelo de Monitor para o WebSphere Business Monitor V7 ou Posterior).

Criando eventos

Uma fonte de eventos é um ponto no fluxo de mensagens do qual eventos de monitoramento podem ser emitidos. Cada fonte de eventos possui um conjunto de propriedades que controlam o conteúdo dos eventos de monitoramento que esta emite.
  1. Exibe as propriedades do nó.
  2. Selecione a guia Monitoramento.
  3. Clique em Incluir.

    A janela Incluir entrada é exibida.

  4. Conclua o campo Fonte de Eventos.

    O campo possui uma lista dropdown de todos os eventos que podem ser definidos neste nó. As informações de fonte de eventos são utilizadas para preencher os atributos do elemento wmb:eventPointData/wmb:messageFlowData/wmb:node do evento.

    Quando você tiver selecionado a origem de eventos, o valor correspondente para o Endereço da Origem de Eventos será exibido como uma propriedade somente leitura.
    Dica: Se você decidir, posteriormente, ativar ou desativar eventos usando o comando mqsichangeflowmonitoring, você deverá especificar um valor para o Endereço de Origem de Eventos, não o Nome do Evento.
  5. Conclua os detalhes do Nome do Evento; selecione Literal ou Local dos Dados.

    Cada evento de monitoramento possui um nome que é colocado no atributo wmb:eventPointData/wmb:eventIdentity/@wmb:eventName do evento. Os nomes padrão são mostrados na seguinte tabela:

    Fonte de Eventos Nome de Evento Padrão Exemplo:
    Início da Transação nodeLabel.TransactionStart MQInput.TransactionStart
    Fim da Transação nodeLabel.TransactionEnd MQInput.TransactionEnd
    Recuperação da Transação nodeLabel.TransactionRollback MQInput.TransactionRollback
    Terminal nodeLabel.terminal_label.Terminal MQInput.OutTerminal
    É possível anular o padrão das seguintes formas:
    • Especificando uma cadeia literal alternativa.
    • Especificando uma consulta XPath; a consulta extrai o nome do evento de um campo na mensagem de entrada. Clique em Editar para utilizar o XPath Expression Builder.
    Não é possível usar as propriedades de monitoramento para configurar eventos de transação nos seguintes nós: Use um perfil de monitoramento no lugar; consulte Configurando fontes de eventos de monitoramento utilizando um perfil de monitoramento.
  6. Opcional: Complete a seção Filtro de Eventos fornecendo uma expressão XPath para controlar se o evento é emitido. Execute uma das seguintes etapas:
    • Digite a expressão (por exemplo, $Body/StockTrade/Details/Value > 10000); ou
    • Clique em Editar para ativar XPath Expression Builder.
    A expressão deve ser avaliada como true ou false e pode referenciar campos na árvore de mensagens ou em qualquer outro lugar na montagem da mensagem. O valor-padrão é true(), que significa que o evento é sempre produzido.

    Usando essa facilidade, é possível padronizar emissões de eventos em seus requisitos de negócios, filtrando eventos que não correspondam a um conjunto de regras. Isto pode reduzir o número de eventos emitidos e reduzir a carga de trabalho em seu aplicativo de monitoramento.

  7. Opcional: Complete a seção Carga Útil do Evento se o evento tiver de conter os campos de dados selecionados extraídos da mensagem. Clique em Incluirpara ativar a caixa de diálogo Incluir Local de Dados . Execute uma das seguintes etapas:
    • Insira o local (por exemplo, $LocalEnvironment/File/Name); ou
    • Clique em Editar para ativar XPath Expression Builder.

    É possível extrair um ou mais campos dos dados de mensagens e incluí-los com o evento. Os campos podem ser simples ou complexos. Conteúdo simples é alocado no campo wmb:applicationData/wmb:simpleContent do evento; dados complexos são alocados no campo wmb:applicationData/wmb:complexContent.

    Este instrumento geralmente é utilizado para comunicar dados de negócios importantes em um evento de negócio. Se o evento contiver o fluxo de bits de entrada, o instrumento também poderá ser utilizado para extrair campos-chave, permitindo que outro aplicativo forneça uma trilha de auditoria ou reenvie as mensagens que falharam.

  8. Opcional: Selecione o campo Incluir dados do fluxo de bits na carga útil se o evento tiver de capturar os dados do fluxo de bits do da mensagem.
    Content
    Selecione em Cabeçalhos, Corpo, Tudo.
    Codificação
    Selecione de base64, HexBinary e CData (o texto original, sem codificação).
  9. Opcional: Selecione a guia Correlação para completar os detalhes para a correlação de eventos.
  10. Conclua os detalhes Correlação de Eventos; para obter informações sobre correlação, consulte Eventos de Correlação e Monitoramento.

    Cada evento de monitoramento deve conter ao menos um atributo de de correlação, e pode conter até três. Se você não especificar nenhuma informação de correlação, a primeira fonte de evento no fluxo de mensagens aloca um identificador único que todas as fontes de eventos posteriores na mesma transação utilizarão.

    1. Opcional: Complete os detalhes do Correlator de transação local.
      Automático
      O correlacionador utilizado pelo evento mais recente para esta chamada da mensagem será utilizado. Se não existir nenhum correlacionador local, um novo valor único será gerado.
      Especifique o local do correlacionador
      Digite um valor ou clique em Editar para ativar o XPath Expression Builder. O correlacionador local será lido do local especificado na árvore de mensagens. Certifique-se de que o local especificado contenha um valor exclusivo de correlacionador para chamar o fluxo de mensagens.
    2. Opcional: Complete os detalhes do Correlator de transação pai para extrair um campo de correlação da transação pai.
      Automático
      O correlacionador pai utilizado pelo último evento para esta chamada do fluxo de mensagem será utilizado. Se ainda não existir nenhum correlacionador pai, não será utilizado nenhum correlacionador pai.
      Especifique o local do correlacionador
      Digite um valor ou clique em Editar para ativar o XPath Expression Builder. O correlacionador pai será lido do local especificado na árvore de mensagens. Certifiqe-se de que o local especificado contenha um valor que sirva para o correlacionador pai.
    3. Opcional: Complete os detalhes do Correlator de transação global para extrair um campo de correlação de uma transação global.
      Automático
      O correlacionador global utilizado pelo último evento na chamada deste fluxo de mensagens será utilizado. Se ainda não existir nenhum correlacionador global, não será utilizado nenhum correlacionador global.
      Especifique o local do correlacionador
      Digite um valor ou clique em Editar para ativar o XPath Expression Builder. O correlacionador global será lido do local especial na árvore de mensagens. Certifiqe-se de que o local especificado contenha um valor compatível com o correlacionador global.
  11. Opcional: Escolha se a emissão dos eventos de monitoramento por um fluxo de mensagens é coordenado com a transação de fluxo de mensagens ou está em uma unidade independente de trabalho ou não está em uma unidade de trabalho.
    Clique na guia Transação e selecione a opção adequada para a Unidade de Eventos de Trabalho.
    Fluxo de Mensagens
    O evento, e todos os outros eventos com esta configuração, são emitidos somente se o fluxo de mensagens confirmar sua unidade de trabalho com êxito.

    Se o evento de início da transação for especificado para ser incluído na unidade de trabalho do fluxo de mensagens, mas o processamento de mensagens falhar e esta unidade de trabalho não for publicada, o evento de início da transação será incluído em uma unidade de trabalho independente. Isto assegura que seu aplicativo de monitoramento receba um par de eventos (início e retrocesso), em vez de receber um evento de retrocesso em isolamento.

    Independente
    O evento é emitido em uma segunda unidade de trabalho, independente da unidade de trabalho principal. O evento, e todos os outros eventos com esta configuração, serão emitidos independentemente de a unidade de trabalho principal ser confirmada com êxito.

    Uma transação independente pode ser iniciada somente se a transação principal tiver sido confirmada ou retrocedida. Se a propriedade Contagem de Confirmações do fluxo for maior que um, (Propriedades Configuráveis do Fluxo de Mensagens), ou a propriedade Confirmar por grupo de mensagens estiver configurada (Recebendo Mensagens em um Grupo de Mensagens do WebSphere MQ), os eventos direcionados para a transação independente serão então emitidos fora do ponto de sincronização e será exibida uma mensagem indicando que isto foi feito.

    Nenhum(a)
    O evento é emitido fora do ponto de sincronização (não em qualquer unidade de trabalho.) O evento é emitido quando a mensagem passa pela fonte de eventos e está disponível para leitura imediatamente.
    Nem todas estas opções estão disponíveis em todos os tipos de eventos. Os valores padrão e permitidos são mostrados na tabela a seguir:
    Fonte de Eventos Valores Permitidos Padrão
    Início da Transação
    • Fluxo de Mensagens
    • Independente
    • Nenhum(a)
    Fluxo de Mensagens
    Fim da Transação
    • Fluxo de Mensagens
    • Nenhum(a)
    Fluxo de Mensagens
    Recuperação da Transação
    • Independente
    • Nenhum(a)
    Independente
    Terminal
    • Fluxo de Mensagens
    • Independente
    • Nenhum(a)
    Fluxo de Mensagens
  12. Clique em Concluir.

    A tabela Eventos na guia Monitoramento da visualização Propriedades do nó é atualizada com os detalhes do evento que foi incluído, o evento está ativado.

  13. Opcional: Desative o evento.
  14. Salve o fluxo de mensagens.

Implementando propriedades de monitoramento

  1. Quando tiver incluído todos os eventos ao fluxo, inclua o fluxo de mensagens ao arquivo broker archive (BAR) e implemente o arquivo BAR.

    O Monitoramento está desativado no fluxo; implementar o arquivo BAR não o ativa.

  2. Ative o monitoramento para o fluxo usando o comando mqsichangeflowmonitoring -c.

Atualizando propriedades de monitoramento

As propriedades de monitoramento de um nó demonstram todos os eventos de monitoramento definidos para aquele nó. Edite as propriedades de monitoramento de um nó para efetuar estas tarefas:
  • Ativar ou desativar um evento de monitoramento.
  • Incluir, excluir ou alterar os eventos de monitoramento do nó.
  1. Clique com o botão direito e selecione Propriedades.
  2. Selecione a guia Monitoramento.

    Os eventos de monitoramento configurados anteriormente serão exibidos.

  3. Selecione ou limpe a caixa de opção Ativado para cada evento, conforme for apropriado.
    • Para desativar um evento, limpe a caixa de opção.
    • Para ativar um evento selecione a caixa de opção.
  4. Para incluir um evento, clique em Incluir.
  5. Para excluir um evento, selecione o evento, em seguida, clique em Excluir.
  6. Para editar um evento, selecione o evento, em seguida, clique em Editar.

    O Incluir Evento é exibido. Para uma descrição das opções desta janela, consulte Criando eventos.

  7. Salve o fluxo de mensagens.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:50


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.5 | ac60381_