Executando a Amostra WebSphere Business Monitor
Antes de poder executar a amostra, você deve ter importado e implementado a amostra WebSphere Business Monitor, e ter concluído as instruções em Configurando a Amostra WebSphere Business Monitor.
As etapas a seguir mostram como você pode criar um aplicativo de modelo de monitor a partir do modelo e um painel baseado no modelo.
Se você encontrar algum problema ao executar a amostra, consulte
Resolvendo problemas ao executar amostras na
documentação do WebSphere Message Broker.
Gerar o Aplicativo de Modelo de Monitoramento
Essas instruções são gravadas para o WebSphere Business Monitor V7.0 e utilizam o modelo
WBMonitorEventsModel, que foi criado utilizando a opção de exportação de informações de
monitoramento no ambiente de trabalho. Este modelo não é suportado em versões do
WebSphere Business Monitor 6.2.
Se você estiver utilizando o WebSphere Business Monitor 6.2, é necessário utilizar o
modelo de monitor ComplexContent que está no arquivo MonitorModels.zip.
- No WebSphere Message Broker Toolkit, abra o projeto WBMonitorEventsProject e exporte
o arquivo de troca de projetos MonitorModels_V7.zip ao clicar
em Exportar > Geral > Sistema de Arquivos.
- Inicie o Monitoring Model Editor (MME) no WebSphere Business Monitor Development Toolkit.
- Importe o arquivo de troca de projetos MonitorModels_V7.zip
no MME ao clicar em Importar > Outros > Troca de Projeto.
- Abra WBMonitorEvents_V7Project e selecione WBMonitorEventsModel.mm.
Se você estiver utilizando o WebSphere Business Monitor 6.2,
importe o arquivo MonitorModels.zip e selecione
ComplexContent.mm no projeto WBMonitorEvents.
- Clique com o botão direito do mouse no modelo de monitor e, a partir do menu, selecione
Gerar Projetos do Monitor J2EE.
- No assistente Gerar Projetos do Monitor J2EE
você pode manter o nome de projeto padrão gerado automaticamente ou pode fornecer
seu próprio nome de projeto.
- Anote o nome para Nome do Projeto do Aplicativo J2EE e clique em Concluir.
- Quando a geração de código for concluída, alterne para a perspectiva Java.
- Clique com o botão direito do mouse no projeto do aplicativo EAR (Enterprise Archive) que é gerado.
Se você usou o Nome de Projeto do Aplicativo J2EE, o nome será
WBMonitorEventsModelApplication.
- Clique com o botão direito do mouse no projeto do aplicativo EAR gerado e
selecione Exportar > Java EE > Arquivo EAR.
No assistente Exportar, clique em Procurar para selecionar o diretório do
arquivo e o nome do arquivo EAR para o qual o aplicativo EAR deve ser exportado.
Instalando e Configurando o Aplicativo do Modelo de Monitoramento
- Inicie seu Servidor de Monitor.
- Abra o console administrativo Servidor de Monitor e, a partir do painel
de navegação, clique em Aplicativos > Novo Aplicativo
e selecione Novo Aplicativo Corporativo.
- Configure Caminho para novo aplicativo para o local
do aplicativo EAR exportado, e clique em Avançar nos
painéis restantes.
- Revise as informações de resumo e clique em Concluir.
Verifique a mensagem que informa que o aplicativo foi instalado com êxito.
- Clique em Salvar para salvar as alterações na configuração principal.
- Clique em Aplicativos > Tipos de Aplicativos >
WebSphere Enterprise Applications, selecione
WBMonitorEventsModelApplication e clique em
Iniciar.
O Status do Aplicativo agora contém uma seta verde.
Criar um painel do WebSphere Business Monitor
Essas instruções descrevem a criação de um painel para o
WebSphere Business Monitor 7.0.
Nota: Se a segurança estiver ativada em seu Servidor de Monitor,
pode ser necessário utilizar o painel Segurança de Dados do Monitor no
console administrativo Servidor de Monitor para designar permissão
apropriada para que os seus modelos de monitor estejam visíveis no
painel.
Para obter mais informações, consulte o
Centro de Informações do IBM WebSphere Business Process Management.
- Abra um navegador da Web e acesse
https://localhost:<WC_default_secure>/BusinessDashboard/login.jsp para
abrir o Business Space Manager.
- No Business Space Manager, clique em Ações
no banner e selecione Criar Espaço.
- Digite um nome para o novo espaço no campo Nome de Espaço.
Clique em Salvar.
- Crie uma página selecionando o ícone Criar uma Página (+)
no banner.
- Insira o nome da página no campo Título.
Clique em Salvar.
- Clique na página criada. Clique em Editar Página.
- No painel Widget, selecione Instâncias
e clique no ícone Incluir na Página (+).
- No painel Instâncias, selecione Editar Configurações no menu.
- Selecione a página Mostrar/Ocultar.
-
Se aparecer a seguinte mensagem
Se nenhum modelo de monitor for exibido,
então nenhum modelo está instalado
ou você não está autorizado a visualizar os modelos instalados,
acesse o console administrativo do Servidor de Monitor e conclua as etapas a seguir:
- Selecione
Segurança > Segurança dos Dados do Monitor e clique em
Raiz.
- Destaque os modelos no painel Modelos.
Selecione Administrador de
KPI e clique em Usuários.
- Clique em Procurar. Na coluna
Disponível, selecione o usuário que
deseja utilizar.
Para mover o usuário para a coluna Selecionado,
clique na seta (>) e clique em OK.
- Na página Administração de Segurança de Dados do Monitor, clique em
OK.
- Volte ao Business Space Manager e atualize a página, os modelos de monitor instalados são exibidos.
- Selecione WBMonitorEventsModel na área de janela "Selecionar Contextos de Monitoramento para Personalizar".
Faça uma pesquisa detalhada e selecione TotalPurchaseOrderFlow.
Selecione todas as colunas sob Disponível, clique na seta dupla
(>>) para movê-las para coluna
Selecionado.
- Clique em Configurar como padrão.
- Clique em OK.
- Agora inclua alguns KPIs:
- No painel Widget, selecione KPIs
e clique no ícone Incluir na Página (+).
- No painel KPIs, selecione Editar Configurações no menu.
- Clique no sinal de mais (+)
ao lado de WBMonitorEventsModel para expandir a lista de KPIs.
- Selecione alguns dos
KPIs da lista. Por exemplo, Total de Pedidos de Clientes Ouro,
Total de Pedidos de Clientes Regulares e Duração
Média de Transação TotalPurchaseOrderFlow.
- Clique em OK.
Instalar e configurar o bean acionado por mensagens (MDB)
Nesta amostra, o WebSphere MQ está configurado com o Provedor JMS.
Você deve configurar as seguintes definições no gerenciador de filas do WebSphere Message Broker antes de poder configurar o WebSphere MQ como o Provedor JMS:
- Crie um listener TCP e inicie-o.
- Crie um canal de Conexão do Servidor.
- Execute o arquivo MQJMS_PSQ.mqsc fornecido pelo WebSphere MQ para criar as fila JMS necessárias no gerenciador de filas WebSphere Message Broker.
Este arquivo .mqsc está contido no diretório de instalação do produto WebSphere MQ no subdiretório
java/bin.
Execute o comando runmqsc, por exemplo:
runmqsc MB8QMGR < MQJMS_PSQ.mqsc
Quando tiver concluído as três etapas anteriores para configurar as definições, você
pode configurar o WebSphere MQ como o provedor JMS:
- Crie uma connection factory de tópico:
- No console administrativo do Servidor de Monitor, expanda
Recursos > JMS > Provedores JMS
e selecione um escopo apropriado na lista para sua configuração.
- Em Recursos > JMS selecione
Connection Factories de Tópico, clique em Novo.
- Clique em Provedor de sistema de mensagens do WebSphere MQ e clique em
OK.
- Insira o nome e o nome da JNDI nos campos Nome
e Nome JNDI; por exemplo, topicConn
e jms/topicConn e clique em
Avançar > Avançar.
- Insira o nome do gerenciador de filas para o seu gerenciador de filas WebSphere Message Broker e clique em Avançar.
- Configure Transportar para o Cliente.
- Insira o nome do host onde seu gerenciador de filas WebSphere Message Broker está
em execução.
- No campo Porta, insira o número da porta do listener
TCP definido no gerenciador de filas WebSphere Message Broker.
- No campo Canal, insira o nome do canal Conexão do Servidor.
- Clique em Avançar > Avançar > Concluir.
- Clique em Salvar.
- Crie um tópico:
- Clique em Recursos > JMS e
selecione Tópicos clique em Novo.
- Clique em Provedor de sistema de mensagens do WebSphere MQ e clique em
OK.
- Insira o nome e o nome da JNDI nos campos Nome e
Nome da JNDI; por exemplo, topicName
e jms/topicName.
- No campo Nome do Tópico de Base, insira o nome
do nome do tópico de monitoramento.
Se a configuração padrão for usadam, o nome do tópico será
$SYS/Broker/MB8BROKER/Monitoring/WBMonitorEventsExecGroup/TotalPurchaseOrderFlow.
- Clique em OK e clique em Salvar.
- Instale o aplicativo MDB:
- No WebSphere Message Broker Toolkit, exporte o arquivo .zip
do MDB WBEventEmitterEAR e extraia o arquivo.
- Alterne para o console administrativo Servidor de Monitor clicando em
Aplicativos > Novo Aplicativo e selecione
Novo Aplicativo Corporativo.
- Clique em Navegar e selecione o
arquivo WMBEventEmitter.ear que foi extraído
do arquivo .zip e clique em
Avançar.
- Selecione Detalhado - Mostrar todas as opções e parâmetros de instalação e clique em Avançar.
- Clique em Continuar.
- Clique em Avançar até chegar a
Vincular Listeners para o Bean Orientado a Mensagens.
Escreva o nome da porta do listener.
- Clique em Avançar nas telas restantes;
na tela de resumo final, clique em Concluir.
- Salve a definição.
- Opcional: Se a segurança estiver ativada no servidor de monitor:
- Alterne para o console administrativo Servidor de Monitor clicando em
Aplicativos > Tipos de Aplicativos > WebSphere Enterprise Applications.
- Clique em WMBEventEmitter. Sob Detalhar Propriedades, selecione
Função de segurança para mapeamento de usuário/grupo.
- Selecione a caixa de opção Função eventEmitter e clique em Mapear Usuários.
- Clique em Procurar, na coluna Disponível,
selecione o usuário Administrativo que deseja mapear para a função eventEmitter.
Clique na seta dupla (>>) para mover o usuário
Administrativo para a coluna Selecionado e clique em
OK.
- Selecione a caixa de opção Função eventEmitter.
- Clique em OK e clique em Salvar.
- O usuário selecionado agora está mapeado para a função eventEmitter e
é necessário designar o nome de usuário e a senha para a função eventEmitter.
- Alterne para o console administrativo Servidor de Monitor clicando em
Aplicativos > Tipos de Aplicativos > WebSphere Enterprise Applications.
- Clique em WMBEventEmitter.
Sob Detalhar Propriedades, selecione Funções RunAs do usuário.
- Selecione a caixa de opção Função eventEmitter.
- Insira o nome e a senha do usuário nos campos Nome de Usuário e
Senha.
- Clique em Aplicar.
O usuário é exibido no campo
Nome de Usuário ao lado de funções eventEmitter.
- Clique em OK e clique em Salvar.
- Crie um listener para o MDB:
- Clique em Servidores > Tipos de Servidores
> WebSphere Application Servers e clique em seu servidor.
- Sob a seção Comunicações, acesse Sistema de Mensagens
> Serviço de Listener de Mensagens > Portas Listener.
Clique em Novo e digite o nome do listener que você gravou
quando instalou o aplicativo MDB.
- No campo Nome da JNDI de factory de conexão, insira o nome da JNDI usado
ao criar o factory de conexão de tópico; por exemplo, jms/topicConn.
- No campo Nome da JNDI de destino, insira o nome da JNDI usado ao criar o
tópico; por exemplo, jms/topicName.
- Clique em OK e clique em Salvar.
- Reinicie o servidor.
- Clique em Servidores > Servidores de Aplicativos e clique em seu
servidor.
Sob a seção Comunicações, acesse Sistema de Mensagens
> Serviço do Listener de Mensagem > Portas Listener e verifique se a porta listener está em
execução.
- Em Aplicativos > Aplicativos
Corporativos, verifique se
WMBEventEmitter está em execução.
Verifique se o tópico de evento possui uma assinatura registrada junto a ele para o fluxo de mensagens:
- Abra o WebSphere MQ Explorer e expanda o gerenciador de filas MB8QMGR na pasta Gerenciadores de Filas.
- Para abrir a área de janela Assinatura, clique duas vezes em Assinaturas.
- Clique em Atualizar e verifique se existe uma
assinatura com a sequência de tópicos
$SYS/Broker/MB8BROKER/Monitoring/WBMonitorEventsExecGroup/TotalPurchaseOrderFlow.
A origem para o MDB é incluída no arquivo WMBEventEmitter.ear.
Isso fornece um exemplo de um MDB que pode ser usado para:
- Receber mensagens de eventos do Message Broker
- Submetê-las em um formato apropriado para o servidor CEI para processamento pelo Websphere Business Monitor
As etapas a seguir descrevem como importar o WMBEventEmitter.ear para
o Websphere Integration Developer 7.0,
permitindo que você visualize, edite e recompile o código de origem para o MDB.
- Inicie o Websphere Integration Developer e selecione uma área de
trabalho
- No menu, selecione Arquivo>Importar...>Java EE>Arquivo EAR
e clique em Avançar
- Use o botão Navegar no campo arquivo EAR para selecionar
o local do WMBEventEmitter.ear.
Quando selecionado, o campo Projeto EAR será preenchido
como WMBEventEmitter. Verifique se o campo Tempo de Execução de Destino está preenchido
com um valor apropriado para sua instalação. Clique em Concluir.
Se ainda não estiver na perspectiva do Java EE, você será solicitado a alternar para essa perspectiva.
Clique em Sim para fazer isso.
- Dois projetos aparecem na área de trabalho, WMBEventEmitter e WMBEventEmitterEJB.
- Expanda WMBEventEmitterEJB>ejbModule>com.ibm.wmb.event.cbe>WMBMDBEmitterBean.java
para visualizar a origem do MDB.
- Se aparecer um erro relatando que A importação com.ibm.events não pode ser resolvida,
você deverá incluir com.ibm.events.client.jar em seu Caminho de Construção. Para isso:
- Clique com o botão direito do mouse em WMBEventEmitterEJB
e selecione Caminho de Construção>Configurar Caminho de
Construção.
- Selecione a página Bibliotecas
e clique em Incluir JARs Externos....
- Navegue para o com.ibm.events.client.jar
no diretório ${WAS_INSTALL_PATH}/plugins e clique em OK
Para exportar o MDB para a instalação do aplicativo:
- Clique com o botão direito do mouse no projeto WMBEventEmitter e selecione
Exportar>Exportar...Java EE>Arquivo EAR.
- Clique em Avançar.
- Use o botão Navegar para configurar o campo Destino e
clique em Concluir.
- Continue com a etapa Instale o aplicativo MDB para instalar o aplicativo MDB em seu servidor.
Configurar Fontes de Eventos no Fluxo de Mensagens
As fontes de eventos já foram configuradas no fluxo de mensagens.
Clique duas vezes no fluxo de mensagens TotalPurchaseOrderFlow para abrir o editor Fluxo de Mensagens.
Clique na paleta do fluxo de mensagens.
A guia Monitoramento exibe as cinco fontes de eventos ativadas:
Cada definição de evento contém uma guia Básico,
Correlação e Sequência.
A guia Básico define a
Origem do Evento e o
Nome do Evento.
A guia também contém as opções para configuração no
Filtro de Eventos para incluir dados
da carga útil da mensagem e o fluxo de bits da mensagem.
A guia Correlação define
informações sobre Correlação de Eventos.
A guia Sequência define informações sobre
a Sequência de Eventos.
Nesse exemplo as configurações padrões são usadas para cada definição de evento.
Um filtro de eventos é configurado em cada um dos eventos definidos no nó InputOrder.
Esses
filtros suprimem eventos de clientes do tipo GUEST.
Dados são capturados a partir da carga útil da mensagem em três das definições de evento.
Alguns desses dados extraídos são então usados no Modelo do WebSphere Business Monitor.
InputOrderTransactionStart
O evento contém os seguintes elementos simples (mostrados com dados de exemplo) a
partir da carga útil da mensagem de entrada.
<PO:purchaseOrderID>11112222</PO:purchaseOrderID>
<PO:customerID>111111</PO:customerID>
Esse evento também contém os seguintes elementos complexos (mostrados com dados de
exemplo) a partir da carga útil da mensagem de entrada:
<PO:items>
<PO:item>
<PO:partNum>0239232</PO:partNum>
<PO:productName>compost</PO:productName>
<PO:quantity>14</PO:quantity>
<PO:price>4.99</PO:price>
</PO:item>
<PO:item>
<PO:partNum>0451481</PO:partNum>
<PO:productName>lawnmower</PO:productName>
<PO:quantity>10</PO:quantity>
<PO:price>79.99</PO:price>
</PO:item>
<PO:item>
<PO:partNum>0481257</PO:partNum>
<PO:productName>spade</PO:productName>
<PO:quantity>10</PO:quantity>
<PO:price>19.99</PO:price>
</PO:item>
</PO:items>
Dê um clique duplo no nó MQInput InputOrder.
A guia Básico mostra as definições de XPath usadas para extrair esses dados da
carga útil da mensagem na seção Carga Útil do Evento:
$Body/PO:purchaseOrder/PO:purchaseOrderID
$Body/PO:purchaseOrder/PO:customerID
$Body/PO:purchaseOrder/PO:items
GoldOrderTotalInTerminal e RegularOrderTotalInTerminal
Ambas as definições de eventos contêm os mesmos dados da mensagem definidos em
InputOrder.TransactionStart.
Ambas as definições de eventos também capturam os dados do elemento
priceSummary incluído no nó Compute ComputeTotalOrder (mostrando com dados de exemplo):
<PO:priceSummary>
<PO:itemTotal>1069.66</PO:itemTotal>
<PO:deliveryCharges>19.99</PO:deliveryCharges>
<PO:discount>163.44</PO:discount>
<PO:invoice>926.21</PO:invoice>
</PO:priceSummary>
Clique duas vezes no nó MQOutput GoldOrderTotal ou RegularOrderTotal.
A guia Básico mostra as definições de XPath usadas para extrair esses dados da
carga útil da mensagem na seção Carga Útil do Evento:
$Body/PO:purchaseOrderPriced/PO:purchaseOrderID
$Body/PO:purchaseOrderPriced/PO:customerType
$Body/PO:purchaseOrderPriced/PO:priceSummary
Ativar monitoramento no fluxo de mensagens implementado
- Se você ainda não implementou o fluxo de mensagens, implemente-o
utilizando o arquivo broker archive (BAR)
TotalPurchaseOrderArchive.bar.
- Emita o seguinte comando para ativar o monitoramento para o fluxo de
mensagens TotalPurchaseOrderFlow implementado:
mqsichangeflowmonitoring MB8BROKER -e WBMonitorEventsExecGroup -f TotalPurchaseOrderFlow
-c active
Enviar mensagens através do fluxo de mensagens TotalPurchaseOrderFlow
- Em WBMonitorEventsProject, abra a pasta Testes de Fluxo e dê um clique duplo em
TotalPurchaseOrderFlow_1.mbtest.
- Clique em Chamar Fluxo de
Mensagens.
- Clique em Enviar Mensagem para enviar a primeira mensagem de pedido do cliente para a fila de entrada do fluxo de mensagens.
- Na janela Local da Implementação, selecione o grupo de execução
WBMonitorEventsExecGroup e clique em Concluir.
- Repita estas etapas ao abrir os Testes de Fluxo restantes e enviar o restante dos pedidos dos clientes.
Visualizar os Eventos no Painel do WebSphere Business Monitor
Abra o painel do WebSphere Business Monitor e alterne para o painel criado anteriormente.
Você pode visualizar os eventos para as mensagens que enviou através do fluxo de mensagens TotalPurchaseOrderFlow.
Voltar para o Início da Amostra