Regras de alerta
Automatize notificações no Workspace Floui com regras de alerta personalizáveis para eventos de fluxos.
Last updated
Was this helpful?
Automatize notificações no Workspace Floui com regras de alerta personalizáveis para eventos de fluxos.
Last updated
Was this helpful?
Gerenciar processos é uma tarefa contínua durante a execução de fluxos. A funcionalidade de regras de alerta simplifica e automatiza a comunicação de diversas situações que surgem ao longo desses processos, garantindo que todos os membros da equipe sejam notificados de maneira eficiente.
Neste artigo será abordado como criar e gerenciar regras de alerta, como estas regras podem ser disparadas, além de boas práticas e ações que aumentam o poder de monitoramento de ocorrências.
Para gerenciar as regras de alerta do seu Workspace Floui, acesse o menu lateral e, em Monitoramento, clique em Regras de Alerta. Na tela de gerenciamento, é possível visualizar informações gerais sobre cada regra, além de acessar outras opções, como:
Criar uma nova regra;
Editar regras existentes;
Remover regras.
Editar regras;
Duplicar regras;
Buscar por regras;
Filtrar regras por grupos;
Para criar uma nova regra de alerta, clique no botão Criar Regra de Alerta, localizada no canto direito da tela de gerenciamento/listagem de regras. Em seguida, configure os campos de acordo com as instruções abaixo:
Nome da Regra: Insira um nome para identificação do cenário que será notificado.
Tipo da Regra: Atualmente, apenas a opção "Match de Logs" está disponível. Essa opção permite buscar por termos específicos nos logs de execução do fluxo para disparar o alerta.
Ação de Alerta: Selecione a ação desejada:
E-mail: Envia o alerta por e-mail.
Webhook: Dispara um alerta para uma URL de webhook.
Método para Webhook: Esse campo aparece ao selecionar Webhook como Ação de Alerta. Escolha o método HTTP para o envio do alerta (geralmente recomenda-se utilizar POST).
URL para Webhook: Exibido ao selecionar Webhook como Ação de Alerta. Informe a URL para onde o webhook será enviado.
E-mail de Recebimento: Disponível ao escolher E-mail como Ação de Alerta. Informe o endereço de e-mail que receberá os detalhes do alerta. Para adicionais mais de um e-mail, separe-os utilizando vírgula.
Mensagem Adicional para o E-mail: Adicione uma descrição geral que será incluída no e-mail de alerta.
Buscar em: Selecione entre as opções:
Label do Log (Texto): Procura correspondências no título do log. Configure o conector Logger no fluxo e preencha o campo Título opcional à mensagem de log conforme o termo que deseja que a regra busque.
Mensagem do Log (Texto): Busca correspondências na mensagem do log. Para configurar, use o conector Logger, selecione Linha de texto e preencha o campo Mensagem do log conforme o termo que deseja que a regra busque.
Mensagem do Log (JSON Field): Busca termos específicos dentro do JSON dos registros de execução do fluxo.
Conteúdo para Match: Especifique o conteúdo ou palavra-chave que acionará o alerta.
Campo do JSON na Mensagem: Disponível ao selecionar Mensagem do Log (JSON Field) em configuração Buscar em. Informe o caminho do campo no JSON onde a validação será feita. A configuração Conteúdo para Match, neste caso, irá buscar pelo valor do campo.
Janela de Captura: Define o intervalo de tempo para capturar registros de execução e disparar o alerta. Por exemplo, uma janela de 5 minutos verifica os logs nesse período e dispara o alerta se houver correspondências.
Filtrar por Logs Gerados Por: Escolha se a regra analisará logs de um fluxo específico ou de todos os fluxos executados.
Para que o disparo de e-mail seja realizado com sucesso é necessário que o SMTP do seu ambiente Floui esteja configurado. Caso esteja com dificuldades no recebimento de e-mails de regras de alerta, acesse o suporte do time Floui.
As regras de alerta não apenas notificam o time sobre cenários de atenção, mas também permitem a automação de fluxos de exceção com base nesses cenários. Com a regra de alerta é possível monitorar logs de um fluxo e, dependendo do conteúdo encontrado, disparar um webhook para um endpoint no Workspace Floui que, por sua vez, poderá iniciar um fluxo específico.
Para implementar isso:
Crie um fluxo de exceção que trate o cenário desejado, como a falha de um processo.
Configure o conector HTTP In no fluxo de exceção com uma rota para requisições HTTP do tipo POST.
Crie uma regra de alerta configurando a sua ação como Webhook, e defina a URL do Webhook com a rota configurada no conector HTTP In do fluxo de exceção.
Ajuste as demais configurações da regra de alerta, como o Conteúdo para Match, para que a regra seja acionada corretamente de acordo com o cenário identificado no fluxo principal.
Quando a regra de alerta for acionada, ela enviará uma mensagem via webhook para o endpoint configurado no Workspace Floui, iniciando o fluxo de exceção.
Além de ser usada para automatizar processos internos, a regra de alerta via Webhook também pode ser configurada para enviar mensagens a sistemas externos, ativar subprocessos ou integrar diferentes ferramentas, tornando-se uma solução robusta para comunicação e integração.
O uso eficiente das regras de alerta no Workspace Floui garante que os usuários sejam notificados de maneira rápida e precisa sobre situações adversas nos processos realizados pelos fluxos. Segue algumas boas práticas recomendadas para maximizar o uso da ferramenta:
Selecione Cenários Relevantes: Configure as regras de alerta para monitorar cenários que sejam realmente importantes para o seu contexto.
Use Labels Claras no Logger: Ao configurar o conector Logger no fluxo, utilize legendas descritivas para identificar claramente os cenários que as regras de alerta devem notificar. Isso facilita a identificação e o monitoramento.
Agrupe Regras por Contexto: Organize as regras de alerta em grupos relacionados ao seu contexto. Essa prática ajuda a manter o Workspace Floui bem estruturado e facilita a administração.
Monitore Fluxos Específicos: Para cenários específicos, configure as regras de alerta para escutar apenas os fluxos relevantes, evitando notificações de eventos de fluxos irrelevantes.
Defina Janelas de Captura Menores em Fluxos Críticos: Em fluxos essenciais, utilize uma janela de captura reduzida para receber notificações mais rapidamente, garantindo respostas ágeis a situações críticas.
Grupo: Escolha um grupo disponível no Workspace para organizar as regras de alerta. Caso não exista um grupo apropriado, consulte a documentação sobre .
