Para gravar mensagens que passam por um
fluxo de mensagens, crie um banco de dados, configure as definições de segurança, crie
serviços configuráveis apropriados e configure o monitoramento do
fluxo de mensagens.
Antes de iniciar: Assegure-se de que
o fluxo de mensagens do qual você deseja gravar dados tenha sido implementado.
Para obter mais informações,
consulte Implementando Recursos.
É possível gravar dados em um banco de dados para
auditoria, ou para ajudar na determinação de problema. Foi
fornecido um script com o WebSphere Message
Broker que
pode ser usado para criar o banco de dados DB2
e as tabelas de banco de dados. É possível executar esse script sem modificação ou
customizá-lo. O script cria um banco de dados chamado MBRECORD com um
esquema padrão.
Para configurar o WebSphere Message
Broker para
gravar dados, conclua as etapas a seguir.
- Use o script fornecido com o WebSphere Message
Broker para criar e configurar um banco de dados
para armazenar as mensagens gravadas.
- Localize o script de seu sistema operacional:
- Windows: install_dir\ddl\db2\DataCaptureSchema.sql
- UNIX: install_dir/ddl/db2/DataCaptureSchema.sql
- z/OS: o script JCL
está localizado no conjunto de dados e membro SBIPPROC(BIPRRDB)
install_dir é o local da instalação do WebSphere Message
Broker.
- Opcional: Para especificar seu próprio banco de dados ou
esquema, customize o script DataCaptureSchema fornecido
e salve as mudanças.
Talvez
você também queira editar o script pelos seguintes motivos:
- Se você tiver executado o script uma vez e desejar executá-lo novamente,
deverá eliminar o banco de dados MBRECORD primeiro. Insira o comando drop
database MBRECORD antes da linha que informa create
database MBRECORD.
- O tamanho máximo do corpo da mensagem que pode ser gravado (depois que a codificação
tiver ocorrido) é de 5 MB. É possível aumentar esse máximo editando
o script para aumentar a coluna WMB_BINARY_DATA.DATA.
- Em uma linha de comandos, navegue até o local do script e
execute-o: Por exemplo, em sistemas Windows ou UNIX, insira o seguinte
comando:
db2 -tvf DataCaptureSchema.sql
- Crie uma definição ODBC para o banco de dados.
Se
você tiver usado o script fornecido para criar seu banco de dados sem
modificações, crie uma definição ODBC para o banco de dados chamada MBRECORD,
com MBRECORD como o nome da origem de dados (DSN). Para obter informações adicionais, consulte
Ativando as Conexões ODBC para os Bancos de Dados.
- Use o comando mqsisetdbparms
para configurar um identificador de usuários e uma senha para o broker usar ao se conectar
ao banco de dados; por exemplo:
mqsisetdbparms brokerName -n dataSourceName -u userID -p password
- brokerName é o nome do broker.
- dataSourceName identifica o banco de dados no qual
você deseja gravar dados.
- userID e password especificam
o identificador de usuários e a senha que o broker usa para se conectar
ao banco de dados.
- Para assegurar-se de que as mudanças no comando mqsisetdbparms
entrem em vigor, reinicie o broker. Para obter mais informações,
consulte Iniciando e Parando um Intermediário.
- Teste a conexão com o banco de dados usando o comando mqsicvp. Para obter mais informações,
consulte Comando mqsicvp.
- Especifique as propriedades de tempo de execução para captura de dados criando
os serviços configuráveis apropriados.
Para especificar informações
de processamento de dados e de conexão para o banco de dados,
crie um serviço configurável DataCaptureStore.
Para identificar
o tópico de monitoramento e o armazenamento de captura de dados a serem usados para o processamento
de dados do evento deste tópico, crie um serviço configurável
DataCaptureSource. Diversas instâncias do serviço configurável
DataCaptureSource podem usar o mesmo serviço configurável DataCaptureStore.
- Configure o serviço configurável DataCaptureStore.
É possível usar o serviço configurável DefaultCaptureStore fornecido
ou criar seu próprio serviço configurável do tipo DataCaptureStore.
É possível usar o WebSphere Message Broker
Explorer para criar
o serviço configurável; para obter mais informações, consulte Usando o WebSphere Message Broker Explorer para Trabalhar com Serviços Configuráveis. Alternativamente, use o comando mqsicreateconfigurableservice;
para obter mais informações, consulte o Comando mqsicreateconfigurableservice. Para obter
descrições de propriedades desse serviço configurável, consulte o Serviço Configurável DataCaptureStore.
Por
exemplo, insira o seguinte comando em uma linha de comandos:
mqsicreateconfigurableservice brokerName -c DataCaptureStore -o dataCaptureStoreName
-n dataSourceName,egForRecord -v dataSource,executionGroup
- brokerName é o nome do broker.
- dataCaptureStoreName é o nome do objeto de
serviço configurável.
- dataSource é o nome da origem de dados.
- executionGroup é o nome do grupo de
execução que processa dados para gravação.
- Configure o serviço configurável DataCaptureSource.
Crie um serviço configurável do tipo DataCaptureSource.
É possível usar o WebSphere Message Broker
Explorer ou o comando mqsicreateconfigurableservice
para criar o serviço configurável. Se você usar o DataCaptureSourceTemplate
no WebSphere Message Broker
Explorer, deverá criar um novo
serviço configurável com base no modelo. Se você editar o modelo
sem criar um novo serviço configurável, será emitido um erro no
tempo de execução. Para obter informações sobre as propriedades desse serviço
configurável, consulte Serviço Configurável DataCaptureSource.
Por exemplo, em sistemas UNIX,
insira o seguinte comando em uma linha de comandos:
mqsicreateconfigurableservice brokerName -c DataCaptureSource -o dataCaptureSourceName -n dataCaptureStore,topic
-v dataCaptureStoreName,'$SYS/Broker/myBroker/Monitoring/executionGroupName/msgFlowName'
- brokerName é o nome do broker.
- dataCaptureSourceName é o nome do objeto de
serviço configurável.
- dataCaptureStoreName é o nome do serviço configurável
DataCaptureStore que você deseja usar para esta assinatura.
- myBroker, executionGroupName
e msgFlowName são os nomes do broker, do grupo de
execução e do fluxo de mensagens do qual você deseja capturar dados. Esses
valores fazem parte de uma sequência de tópicos e são usados para subscrever eventos
configurados usando o monitoramento de negócios. É possível usar curingas de tópicos
nesta sequência de tópicos.
Em sistemas UNIX, coloque
a sequência de tópicos entre aspas ao inseri-los em uma
linha de comandos. Em sistemas Windows,
use aspas duplas. As aspas não serão necessárias se você
criar o serviço configurável usando o WebSphere Message Broker
Explorer.
Teste
se a subscrição do tópico especificado para a propriedade topic foi bem-sucedida
exibindo as assinaturas no gerenciador de filas de brokerName.
Use o WebSphere Message Broker
Explorer ou o comando runmqsc.
Para
verificar as assinaturas usando o
WebSphere Message Broker
Explorer,
conclua as seguintes etapas:
- Expanda o gerenciador de filas na pasta Gerenciadores de Filas
- Para abrir a área de janela Assinaturas, clique em Assinaturas.
- Clique em Atualizar e verifique se existe uma
assinatura com uma sequência de tópicos $SYS/Broker/myBroker/Monitoring/executionGroupName/msgFlowName
Para verificar a assinatura usando
runmqsc,
conclua as seguintes etapas:
- Em um prompt de comandos, digite runmqsc qmName,
em que qmName é o nome do gerenciador de filas.
- Para exibir todas as assinaturas dos gerenciadores de filas, digite dis
sub(*)
- Verifique se a sequência de tópicos $SYS/Broker/myBroker/Monitoring/executionGroupName/msgFlowName é
retornada na lista de tópicos de assinatura
- Para sair do ambiente runmqsc, digite end
- Para configurar o monitoramento em um fluxo de mensagens para emitir eventos
para captura, use um dos métodos a seguir.
- Configure e ative as origens de eventos e ative o monitoramento
do fluxo de mensagens concluindo as etapas de Monitoramento de Nível de Negócios.
Não
é necessário subscrever o tópico de monitoramento; o broker gerencia
a assinatura do tópico especificado no serviço configurável
DataCaptureSource.
- Configure as origens do evento de monitoramento usando o perfil de monitoramento de
amostra fornecido em install_dir/sample/RecordReplay/basicMonitoringProfile.xml.
O
perfil de monitoramento de amostra funciona para um único nó de entrada. Você deve
atualizar o perfil para substituir NODENAME pelo
nome do nó de entrada. Para ativar esse perfil de monitoramento, execute os comandos mqsicreateconfigurableservice, mqsichangeproperties
e mqsichangeflowmonitoring
no broker no qual o fluxo foi implementado. Para obter detalhes sobre
como executar esses comandos, consulte Configurando fontes de eventos de monitoramento utilizando um perfil de monitoramento.
Em seguida: Depois de ter gravado as
mensagens, é possível visualizá-las. Para obter mais informações,
consulte Visualizando Dados Gravados.
Talvez você queira desativar a gravação
de um grupo de execução específico temporariamente (por motivos de desempenho,
por exemplo). Para obter mais informações,
consulte Desativando e Ativando a captura de dados.
Para obter mais informações sobre como ajustar a captura de dados, consulte Ajustando a Captura de Dados.