Este artigo discute os recursos de monitoramento e alerta fornecidos pelo IBM WebSphere Cast Iron Cloud Integration (doravante denominado Cast Iron) e as melhores práticas recomendadas para fazer uso desses recursos.
Visão geral dos recursos de monitoramento
O Web Managed Console (WMC) fornece uma visão geral dos projetos publicados e implementados, além de detalhes das orquestrações com tais projetos. Ele também fornece informações sobre o funcionamento de um determinado dispositivo, exibindo o uso de memória, disco e CPU. O ambiente Cast Iron Live não exibe todas as métricas mostradas em ambientes físicos e virtuais, pois é um ambiente de multilocação.
Visão geral dos recursos de alerta
O sistema operacional Cast Iron fornece um subsistema de alerta configurável que um administrador configura para um ambiente de cliente específico. O módulo de alerta envia alertas de diferentes subsistemas Cast Iron para um grupo configurável de pessoas em uma organização, por email, SNMP ou ambos.
Além disso, as orquestrações podem gerar alertas por meio de atividades de criação de logs ou pela geração de emails ou chamadas de serviços da web para serviços de alerta em um ambiente de cliente. Esses serviços de alerta podem ser outras orquestrações Cast Iron ou APIs de terceiros disponíveis na rede.
O Cast Iron é uma solução de integração rápida, que requer monitoramento mínimo do cliente. Um cliente pode efetuar log in no dispositivo, físico, virtual ou em nuvem, periodicamente, para garantir que os recursos sejam nominais ou que as tarefas sejam executadas como o esperado, mas isso não é obrigatório. Ao invés disso, os clientes devem usar alertas para serem direcionados a um problema que necessita de atenção.
Durante o desenvolvimento, é normal usar um alto nível de criação de logs para examinar o fluxo e a transformação dos dados em uma orquestração. Quando um projeto passa para o status de produção, é importante diminuir os níveis de criação de logs para manter o alto desempenho do dispositivo. A criação de logs gera grande quantidade de E/S no dispositivo e isso causa um impacto negativo no desempenho de cada tarefa.
Diminuir os níveis de criação de logs significa que não é possível visualizar as etapas individuais de uma orquestração. Isso significa que a garantia de qualidade (QA) suficiente deve ocorrer antes de mover uma orquestração para o ambiente de produção, e que uma orquestração contém lógica de manipulação de erros de acordo com as melhores práticas do Cast Iron.
A Tabela 1 descreve os níveis de criação de logs para uma orquestração.
Tabela 1. Níveis de criação de logs de orquestração
| Nível de criação de log | Descrição |
|
Nenhum
| Nenhuma atividade de tarefa é registrada ao WMC para orquestrações configuradas como "Nenhum". Será exibido que não há tarefas sendo executadas para estas orquestrações. |
| Valores Iniciais | Apenas os valores iniciais das variáveis de orquestração são registrados. Isso é útil apenas para depuração, se você deseja estudar os valores de acionamento para uma tarefa, como os cabeçalhos HTTP ou o corpo de serviço da web, e espera que a orquestração falhe devido à manipulação de erros insuficiente. Dependendo do tamanho dos dados de valor inicial e de outras variáveis inicializadas, isso pode ter um impacto no desempenho da orquestração. |
| Valores Iniciais e de Erro | Os valores iniciais das variáveis de orquestração e os erros de orquestração são registrados. Isso é útil apenas para depuração, se você deseja estudar os valores de acionamento para uma tarefa, como os cabeçalhos HTTP ou o corpo de serviço da web, e espera que a orquestração falhe devido à manipulação de erros insuficiente. Dependendo do tamanho dos dados de valor inicial e de outras variáveis inicializadas, isso pode ter um impacto no desempenho da orquestração. |
| Valores de Erro | Apenas tarefas de orquestração com falhas irão registrar suas variáveis. Este é o nível de criação de logs recomendado para ambientes de produção. No entanto, é importante notar que orquestrações usando blocos catch de teste nunca irão atingir um estado de erro. |
| Sequencial | Detalhes de tarefas de orquestração registrados para suborquestrações sequenciais com os detalhes da tarefa da orquestração de chamada. Isso é útil para depurar projetos de orquestração pai-filho, se houver problemas com os dados transmitidos entre orquestrações. |
| Todos | Este é o mais alto nível de criação de logs e registra todas as variáveis e etapas de uma tarefa de orquestração. Use este nível de criação de logs apenas para desenvolvimento e testes ou para depuração emergencial de uma orquestração de produção. Este nível de criação de logs pode afetar o desempenho de tarefas de orquestração em até 300%, dependendo do número de atividades, variáveis e do volume de dados por tarefa. |
Existem seis status da tarefa. A Tabela 2 descreve cada status.
Tabela 2. Status da tarefa
| Status | Descrição |
| Executando | A tarefa está em execução. |
| Concluída | A tarefa foi concluída sem erros (isso se aplica mesmo se blocos Catch forem ou não executados durante a execução da tarefa.) |
| Com erro | A tarefa encontrou um erro fatal que não foi manipulado por um bloco catch. Se o nível de criação de logs tiver qualquer configuração, exceto "Nenhum", os detalhes da tarefa exibem o estado da tarefa no momento da falha. |
| Finalizada | A tarefa foi finalizada devido a uma atividade de Finalização na orquestração. |
| Suspensa | Um administrador interrompeu o projeto durante a execução das tarefas. As tarefas são retomadas se o administrador reiniciar o projeto ou inserir um Estado cancelado, caso a implementação do projeto seja removida. |
| Cancelada | Um administrador cancelou a execução da tarefa. |
Uma chave de tarefa é uma maneira de expor os detalhes de uma tarefa de orquestração por meio do WMC. Em geral, a chave de tarefa fornece informações que identificam exclusivamente a transmissão de dados de um terminal para outro, como o número de lote ou a chave primária. No entanto, como isso é configurável durante a orquestração, a chave pode ser simplesmente uma mensagem de status como "Processed 100 rows".
A Figura 1 mostra o painel de resultados da tarefa visível no WMC usando o item de menu Home > Dashboard . Ela mostra as tarefas concluídas e o valor da chave de tarefa designado pela orquestração.
Figura 1. Chaves de tarefa exibidas no WMC
O desenvolvedor configura as chaves de tarefa por orquestração com o Studio e usa a atividade Create Jog Keys para atribuir valores. Uma das chaves pode ser marcada como "Primary". A chave primária se torna pesquisável no WMC. O desenvolvedor controla a nomenclatura das chaves de tarefa e elas se tornam os parâmetros de entrada para a atividade Create Job Keys. A Figura 2 mostra a tela de configuração da chave de tarefa, que pode ser exibida ao clicar no ícone de seta verde no início da orquestração no Studio.
Figura 2. Configurar chaves de tarefa
Por padrão, o WMC registra apenas o ID da tarefa, o ID exclusivo designado a cada tarefa. Quando uma orquestração registra uma chave de tarefa primária, o WMC exibe aquele valor no lugar do ID da tarefa. A chave de tarefa não substitui o valor do ID da tarefa. A visualização dos detalhes da tarefa no WMC exibe o ID da tarefa.
A Figura 3 mostra as entradas do mapa para a atividade Create Job Keys, na qual os valores são designados para três chaves definidas.
Figura 3. Mapeando valores para as chaves de tarefa
Cada orquestração fornece suporte a diversas chaves, mas apenas uma é a chave primária pesquisável. Os valores registrados a chaves não primárias são exibidos na tela de detalhes da tarefa no WMC, como mostrado na Figura 4. É possível exibir a tela, ao clicar em Home > Dashboard, clicar na tarefa e, em seguida, clicar no link Job Keys .
Figura 4. Chaves de tarefa exibidas no painel de detalhes da tarefa no WMC
Observação: As orquestrações configuradas nos níveis de criação de logs definidas como "Nenhum" não irão exibir informações e chaves de tarefa no WMC.
Chaves de tarefa e manipulação de erros
Um enigma com o Cast Iron envolve manipulação de erros e status da tarefa, aos quais as chaves de tarefa podem endereçar. As melhores práticas do Cast Iron estipulam que as orquestrações utilizem blocos catch de teste para controlar o fluxo da orquestração durante condições de erro. Como isso captura os erros ocorridos, as tarefas serão finalizadas com "Concluído" como status da tarefa. Isso dificulta a identificação de tarefas com erros no WMC.
Ao usar um valor de status na chave de tarefa primária, em conjunto com alerta, é possível usar a funcionalidade de busca para encontrar estas tarefas no WMC. Por exemplo, é possível usar a função concatenar em uma atividade de mapeamento para criar uma seqência de caracteres que contenha um status e o número de registros processados, “Success – 100 of 100 records processed” ou “Error – 50 of 100 records processed”. Ao usar o valor de status na chave, é possível buscar "Error" no WMC, e todas as tarefas que não processaram um lote bem-sucedido serão exibidas.
Chaves de tarefa para monitoramento
Usando o mesmo princípio do uso de chaves de tarefa, em conjunto com uma estratégia de manipulação de erros, as chaves de tarefa devem ser o componente principal do monitoramento da tarefa. Por exemplo, considere um cenário no qual é possível integrar um aplicativo como Salesforce.com com seu sistema ERP para sincronizar pedidos de compra. Se forem usadas chaves de tarefa para registrar seus IDs de registro, é possível usar o recurso de busca para responder a perguntas como "O pedido de compra 1234 já foi transferido para o sistema ERP?" É possível encontrar o registro ao pesquisar a chave "1234".
Como procurar chaves de tarefa
As chaves de tarefa são pesquisáveis da esquerda para a direita, e não por um curinga. Por exemplo, é possível localizar a chave de tarefa "1234" ao pesquisar por "1", "12", "123" ou "1234", mas não "234" ou "2345". Esse é um fator importante ao definir o layout das chaves de tarefa para um cenário específico.
A Figura 5 mostra a maior dificuldade de pesquisa quando o valor da chave está no final da chave de tarefa. O usuário deve digitar toda a sequência de caracteres para encontrar as tarefas correspondentes. A caixa de procura está visível no WMC, no painel de resultados, quando você clica no item de menu Home > Dashboard .
Figura 5. Procurando chaves de tarefa
Por exemplo, uma orquestração usa a chave de tarefa "Processed 100 of 100 records – Success". Não é possível procurar pela palavra "Success" e obter um resultado. A única maneira de procurar por "Success" será se o formato da chave de tarefa for "Success – Processed 100 of 100 records".
A Figura 6 mostra como é mais fácil encontrar tarefas quando o valor da chave está bem-definido.
Figura 6. Procurando por uma chave de tarefa bem-definida
Não é possível usar curingas como "%", "?" ou "*" nas pesquisas. As pesquisas automaticamente indicam um curinga após os caracteres terem sido inseridos na caixa de pesquisa:
search value*.
Existem dois níveis de alerta: no nível do sistema e no nível de orquestração. O dispositivo gera alertas no nível do sistema com base nos critérios estabelecidos no WMC. Os alertas no nível de orquestração são derivados das atividades em uma orquestração. Também é possível acionar alertas no nível do sistema utilizando atividades no nível de orquestração.
O dispositivo mantém um log do sistema que exibe erros ou avisos dos diversos subsistemas do sistema operacional. A Tabela 3 descreve a lista de subsistemas.
Tabela 3. Subsistemas que geram notificações
| Subsistema | Descrição | Observações |
| Hardware | Contém os erros relacionados a dispositivos físicos, como ventiladores, CPUs, disco, entre outros. | Não aplicável ao Cast Iron Live |
| Recursos | Relata os problemas com espaço disponível em disco e memória. | Não aplicável ao Cast Iron Live |
| Rede | Mostra os erros relacionados ao acesso de terminais ou a outros problemas relacionados à rede. | Não aplicável ao Cast Iron Live |
| Segurança | Relata logins inválidos para detecção de invasões. | |
| Orquestração | Exibe os erros de tarefas de orquestração, incluindo mensagens de atividades de mensagem de log, erros em que houve falha em atividades devido a problemas de mapeamento, falhas em SOAP, erros em bancos de dados, entre outros. | |
| Implementação | Exibe erros causados quando uma orquestração não pode implementar adequadamente, devido a senhas incorretas em terminais e HTTP ou URLs de serviços da web duplicadas. |
Notificações no nível do sistema
O subsistema de alerta fornece um link ao log do sistema para permitir que um administrador defina políticas (regras) para ativar notificações sobre os eventos no nível do sistema. Em dispositivos físicos e virtuais, o administrador pode escolher entregar notificações usando um email, SNMP ou ambos. O Cast Iron Live permite apenas entregas de notificações por email.
A Figura 7 mostra o painel de notificação no WMC, acessível a partir de Logs > Notifications e exibe uma lista de políticas existentes.
Figura 7. Tela de notificação no WMC exibindo políticas existentes
O administrador deve fornecer as credenciais para um servidor de retransmissão de SMTP que entrega as notificações.
O administrador deve fornecer o host SNMP e a comunidade trap, para que o dispositivo (virtual ou físico) possa entregar os traps à ferramenta de monitoramento.
As políticas são regras simples com base em uma severidade e no subsistema. Os níveis de severidade são exibidos na Tabela 4.
Tabela 4. Tipos de severidade para notificações
| Severidade | Descrição |
| INFO | Mensagens informativas |
| AVISO | Mensagens de aviso |
| ERRO | Erros graves que podem precisar da atenção do usuário |
| CRÍTICO | Erros críticos que requerem a atenção do usuário ou administrador |
Exemplos das regras de notificação são:
-
Se o erro estiver acima de "AVISO" no subsistema de Orquestração, envie a notificação por email para
businessusers@mycompany.com. -
Se o erro estiver acima de "ERRO" no subsistema da Rede, envie a notificação por email para
sysadmins@mycompany.come por SNMP, para criar um trap.
A Figura 8 mostra a tela de definição de política, na qual o usuário configura uma nova política de notificação. Acesse essa tela selecionando Logs > Notifications > New Policy no WMC.
Figura 8. Configurando uma política
Relembrando, o Cast Iron Live não suporta notificações SNMP.
Recomendações de política de email
Ao invés de enviar emails para uma lista de indivíduos, crie uma lista de distribuição no servidor de email. Gerenciar listas de indivíduos por todo o WMC é ineficiente e propenso a problemas, se os indivíduos saírem de um grupo ou organização. É melhor enviar os emails para um grupo definido no servidor de email.
Nos exemplos acima, as notificações das orquestrações são enviadas para um grupo de usuários, e os erros de rede, para outro. Isso demonstra um delineamento claro sobre a distribuição de notificações.
Notificações de nível de orquestração
Por padrão, uma tarefa de orquestração com falha irá gerar uma mensagem de nível de ERRO no log do sistema. É possível usar políticas de notificação para capturar esses erros e gerar emails ou traps SNMP. No entanto, não é necessário controlar o conteúdo da mensagem gerada.
As melhores práticas do Cast Iron estipulam que as orquestrações usam blocos catch de teste e condições possíveis para capturar os erros. O desenvolvedor deve escolher como informar os usuários finais sobre o problema.
O mecanismo de notificação mais comum é a atividade de email, pois é uma interface simples. No entanto, ela suporta diversas opções no formato de entrega. O Cast Iron fornece suporte a mensagens MIME complexas, portanto, é possível criar anexos e emails HTML formatados com links para a tarefa no WMC.
Algumas organizações possuem sistemas de notificações internos complexos, talvez por meio de outros middlewares ou ferramentas de monitoramento. Se esses sistemas possuem APIs públicas, como uma interface de serviços da web, o Cast Iron pode consumir o WSDL e usar a infraestrutura de criação de logs existente por meio da atividade de serviços da web.
A atividade de mensagem de log permite que uma orquestração escreva para o subsistema de orquestração do log do sistema em um nível de severidade escolhido. Juntamente com um conjunto de políticas de notificação, a atividade de mensagem de log é um mecanismo útil para a geração de notificações simples. A vantagem é que o desenvolvedor pode controlar a mensagem contida na notificação, diferentemente de outras notificações padrão no nível do sistema.
A Figura 9 mostra o mapeamento para a atividade de mensagem de log, que está definindo o nível de severidade e a mensagem de saída.
Figura 9. Mapeamento para a atividade da Mensagem de Log
A mensagem registrada é exibida no WMC, no painel System Log do menu de logs, como um evento de orquestração. A Figura 10 mostra um exemplo da saída de uma atividade de mensagem de log no WMC, em que o usuário definiu o nível de severidade como "Aviso".
Figura 10. Saída da mensagem de log no WMC
É possível usar a atividade de Mensagem de Log para fornecer notificações personalizadas ou criar logs por meio do WMC, vincule-a ao subsistema de notificação para enviar emails ou criar traps SNMP automaticamente.
Este artigo mostrou como o WebSphere Cast Iron fornece uma solução abrangente para o rastreamento, identificação e pesquisa de tarefas. Mostrou também como estes recursos complementam os recursos de monitoramento e alerta do Cast Iron.
Aprender
-
Integrando aplicativos em nuvem com o WebSphere Cast Iron Cloud Integration
-
Página do produto WebSphere Cast Iron Cloud Integration
-
Centro de informações do WebSphere Cast Iron
-
Suporte ao WebSphere Cast Iron Cloud Integration
-
Introdução ao IBM WebSphere Cast Iron Cloud Integration
Discutir

Alan Moore é Senior Technical Staff Member no Laboratório de North San Jose, na Califórnia. Ele trabalha há nove anos com Cast Iron e contribuiu com os negócios em áreas que variam do suporte de vendas às soluções de engenharia. Ele conduziu implementações para os primeiros usuários da tecnologia Cast Iron, estabeleceu diretrizes de melhores práticas para todos os usuários do Cast Iron e conduziu a implementação do website para a comunidade de usuários do Cast Iron. Na equipe de engenharia do Cast Iron, Alan desenvolveu os primeiros conectores para salesforce.com®, NetSuite® e RightNow® e, além disso, é a principal autoridade em terminais SaaS. Liderando a equipe de soluções em engenharia no Cast Iron, Alan direciona a arquitetura e desenvolvimento de soluções de integração complexa para parceiros e clientes estratégicos. Ele desenvolveu mais de 100 modelos de integração pré-empacotados, denominados TIPs, dos quais os usuários podem fazer download a partir do ambiente em nuvem do Cast Iron.