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.
- Exibe as propriedades do nó.
- Selecione a guia Monitoramento.
- Clique em Incluir.
A janela Incluir entrada é exibida.
- 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.
- 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.
- 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.
- 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.
- 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).
- Opcional: Selecione a guia Correlação para completar os detalhes para a correlação de eventos.
- 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.
- 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.
- 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.
- 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.
- 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 |
Terminal |
- Fluxo de Mensagens
- Independente
- Nenhum(a)
|
Fluxo de Mensagens |
- 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.
- Opcional: Desative o evento.
- Salve o fluxo de mensagens.