Dados de registro que fluem por meio de um fluxo de mensagens.
- Criar e configurar um banco de dados.
- Fazer as configurações de segurança.
- Criar serviços configuráveis apropriados.
- Configurar monitoramento para o 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 informações adicionais, consulte Implementando Recursos.
É possível gravar dados em um banco de dados para
auditoria, ou para ajudar na determinação de problema. Para gravar dados,
você deve identificar a origem dos dados que deseja gravar e o local
no qual deseja gravá-los. As etapas executadas para gravar
dados são mostradas no diagrama a seguir:
Para configurar o WebSphere Message Broker para
gravar dados, conclua as etapas a seguir.
- Crie e configure o banco de dados e defina uma definição de ODBC
para o nome da origem de dados (DSN). Especifique um ID e uma senha
para que o broker use ao se conectar com o banco de dados. Consulte o Criando e Configurando um Banco de Dados para Gravação de Dados.
- Configure o armazenamento de captura de dados.
Para definir como e onde os dados
são armazenados, crie um serviço configurável
DataCaptureStore. Esse serviço configurável especifica as propriedades de tempo de execução do broker
para processamento dos dados e para conexão com o banco de dados.
Sua topologia de gravação e reprodução pode incluir mais de um broker. Se você
implementar os fluxos de mensagens para os quais deseja capturar dados em um
broker e usar um broker diferente para gravar os dados, deverá conectar
os dois brokers. Para obter informações adicionais sobre como é possível configurar
a topologia do broker, consulte Usando Diversos Brokers para Registro e Reprodução.
É 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 informações adicionais, consulte Comando mqsicreateconfigurableservice. Para
obter as descrições das propriedades deste serviço configurável, consulte 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. Você configurou
este broker para conectar-se com o banco de dados quando concluiu
as etapas no tópico Criando e Configurando um Banco de Dados para Gravação de Dados.
- 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.
- Especifique um tópico publicar/assinar que identifica a origem dos dados
que você deseja capturar.
Para identificar a origem dos dados,
crie um serviço configurável DataCaptureSource.
Use esse serviço configurável
para especificar o tópico de monitoramento que identifica os
fluxos de mensagens dos quais os dados vêm e o armazenamento de captura de dados
a ser usado para armazenar esses dados. Diversas instâncias do serviço configurável
DataCaptureSource podem usar o mesmo serviço configurável DataCaptureStore.
É 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 deste
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. É preciso
usar brokerName para criar esse serviço configurável
DataCaptureStore.
- 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.
Para obter informações adicionais sobre como o monitoramento é usado para capturar
dados, consulte Configurando o Monitoramento para Captura de Dados.
Teste se a assinatura do tópico especificado na propriedade topic
foi bem-sucedida recuperando 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 o nome do tópico é retornado na lista de tópicos de assinatura,
por exemplo, SUB(myBroker:myTopic)
- Para sair do ambiente runmqsc, digite end
- Para gerar os dados que você deseja gravar, configure
o monitoramento nos fluxos de mensagens. Consulte o Configurando o Monitoramento para Captura de Dados.