Ativando o monitoramento

Use o comando mqsichangeflowmonitoring para ativar o monitoramento depois de configurar fontes do evento de monitoramento.

Antes de Começar

Configure as origens de eventos de monitoramento usando as propriedades de monitoramento ou um perfil de monitoramento:

Configurando origens de eventos de monitoramento usando propriedades de monitoramento
Configurando as Origens de Evento de Monitoramento Usando um Perfil de Monitoramento

Sobre esta tarefa

Se o monitoramento estiver ativado para um fluxo de mensagens e as propriedades ou um perfil de monitoramento não estiverem configurados para o fluxo, os eventos de transação serão emitidos. Você deve garantir que a publicação de eventos para monitoramento de mensagens esteja ativada e esteja corretamente configurada, incluindo especificar se os eventos são emitidos em XML, JSON ou ambos. Para obter mais informações, consulte Configurando a Publicação de Mensagens de Evento

É possível iniciar ou parar o monitoramento e especificar o formato de evento apropriado, configurando propriedades no arquivo de configuração para o seu servidor de integração server.conf.yaml.


Monitoring:
  MessageFlow:
    #publicationOn: inactive           # Choose 1 of : active|inactive, default inactive
                                       # Ensure Events.BusinessEvents.MQ|MQTT is set
    #eventFormat: MonitoringEventV2    # When BusinessEvents output format is 'xml', set 'MonitoringEventV2' or 'WMB'. Default 'MonitoringEventV2'.

As mudanças feitas nas propriedades do arquivo .conf.yaml entram em vigor quando o servidor de integração é reiniciado e são aplicadas a todos os fluxos no servidor de integração.

Ao configurar o monitoramento para seus fluxos, é possível usar o comando mqsichangeflowmonitoring para ativar ou desativar o monitoramento sem reiniciar o servidor de integração.. As opções configuradas com esse comando permanecerão em vigor até que você o execute novamente ou reinicie o servidor de integração. Ao reiniciar o servidor de integração, as configurações especificadas no arquivo server.conf.yaml entram em vigor.

Para ativar o monitoramento, especifique o parâmetro -c active no comando mqsichangeflowmonitoring . Para desativar o monitoramento, especifique -c inactive. É possível ativar ou desativar o monitoramento para todos os fluxos de mensagens em todos os servidores de integração. Como alternativa, é possível especificar os servidores de integração, aplicativos, bibliotecas ou fluxos de mensagens para os quais o monitoramento deve ser ativado ou desativado.

Para obter mais informações, consulte o comando mqsichangeflowmonitoring.

Também é possível usar um perfil de monitoramento para configurar seus fluxos de mensagens para emitir eventos de monitoramento. Ao criar um perfil de monitoramento, você o implementa em um projeto de política e depois o ativa em um fluxo de mensagens, aplicativo ou servidor de integração específico. Ative o perfil de monitoramento usando o comando mqsichangeflowmonitoring ou a API REST de administração. Como alternativa, é possível especificar um perfil de monitoramento como uma substituição de arquivo BAR, conforme descrito em Propriedades configuráveis em um arquivo BAR. Você pode substituir um perfil de monitoramento implementado, colocando um arquivo .monprofile.xml atualizado no diretório de substituições do servidor de integração, conforme descrito em Ordem de precedência para substituições.

Você pode verificar as opções de monitoramento que estão definidas para um fluxo de mensagens, aplicativo ou biblioteca, usando o comando mqsireportflowmonitoring . Para obter mais informações, consulte o comando mqsireportflowmonitoring

Procedimento

Configure opções de monitoramento para um fluxo de mensagens definindo propriedades na seção Monitoramento do arquivo de configuração para seu nó ou servidor de integração (node.conf.yaml ou server.conf.yaml):

Abra o arquivo de configuração apropriado node.conf.yaml ou server.conf.yaml usando um editor YAML.

Você pode editar o arquivo usando o editor YAML integrado fornecido no Kit de Ferramentas do IBM® App Connect Enterprise, seja clicando duas vezes no arquivo na visualização Desenvolvimento de Aplicativos, seja clicando com o botão direito do mouse no arquivo e selecionando Abrir com > Editor YAML. Se você optar por editar o arquivo usando um editor de texto simples, certise-se de não incluir quaisquer caracteres de guia (que não são válidos no YAML) e use uma ferramenta de validação YAML para validar o conteúdo do seu arquivo.
Para configurar as opções de monitoramento de fluxo de mensagens, defina as propriedades a seguir no arquivo de configuração:
1. Habilita o monitoramento do fluxo de mensagens, configurando a propriedade publicationOn para ativa. Por padrão, o monitoramento de fluxo de mensagens está desativado.
2. Especifique o formato correto de eventos de monitoramento, configurando a propriedade eventFormat .
  As opções válidas são MonitoringEventV2 e WMB.
MonitoringEventV2 é o formato padrão utilizado por padrão em IBM App Connect Enterprise 13.0. Ele fornece alguns dados adicionais relacionados às Bibliotecas Compartilhadas e ao CCSID dos corpos de mensagem codificados.

Especifique WMB se desejar que os eventos de monitoramento sejam emitidos no mesmo formato usado no IBM Integration Bus 10.0.

Para obter mais informações, consulte O evento de monitoramento..
Salve o arquivo e reinicie o servidor de integração para que as mudanças entrem em vigor.
As mudanças feitas nas propriedades dos arquivos .conf.yaml entram em vigor quando o servidor de integração é reiniciado. Para obter mais informações sobre como iniciar um servidor de integração, consulte Iniciando um servidor de integração..

Quando o monitoramento é configurado, é possível usar o comando mqsichangeflowmonitoring para iniciar ou parar dinamicamente o monitoramento do fluxo de mensagens, sem reiniciar o servidor de integração:

Opcional: Para ativar o monitoramento, use o parâmetro -c active . É possível ativar o monitoramento para todos os fluxos de mensagens em todos os servidores de integração ou especificar os servidores de integração, aplicativos, bibliotecas e fluxos de mensagens para os quais o monitoramento deve ser ativado.
Por exemplo,
Para ativar o monitoramento para todos os fluxos de mensagens na biblioteca lib1 do aplicativo app1 no servidor de integração especificado, use o comando a seguir:
```
mqsichangeflowmonitoring -c active -i localhost -p 7600 -k app1 -y lib1 -f "*"
```
Por padrão, as configurações especificadas com esse comando persistem quando o nó ou servidor de integração é reiniciado e quando o fluxo de mensagens é reimplementado. Se não quiser que as configurações persistam, é possível especificar o parâmetro --non-persist. O parâmetro --non-persist faz com que as configurações permaneçam em vigor até uma reinicialização ou reimplementação, em cujo ponto as configurações que estão especificadas no arquivo de configuração server.conf.yaml ou node.conf.yaml entram em vigor.
Opcional: Para desativar o monitoramento, use o parâmetro -c inactive . É possível desativar o monitoramento para todos os fluxos de mensagens em todos os servidores de integração ou especificar os servidores de integração, aplicativos, bibliotecas ou fluxos de mensagens para os quais o monitoramento deve ser desativado.
Por exemplo,
Para desativar o monitoramento do fluxo de mensagens flow3 no aplicativo app0 do servidor de integração server0 no nó de integração broker1, use o comando a seguir:
```
mqsichangeflowmonitoring -c inactive broker1 -e server0 -k app0 -f flow3
```