Fluxos do Odoo

1Ative

Atualize o módulo do Blipit para a 1.15.0 ou posterior: Aplicativos, Blipit Error Monitoring, Atualizar. Não há mais nada a configurar. A contagem começa com o próximo botão que um usuário pressionar, e Fluxos aparece na barra lateral do app.blipit.io para os projetos conectados ao Odoo. Até a primeira etapa chegar, a página diz que está aguardando o primeiro fluxo do seu banco de dados.

2O que a página Fluxos mostra

Os blocos no topo contam os fluxos com falha, as pessoas afetadas, os documentos em espera e as empresas afetadas. Abaixo deles, os fluxos são agrupados por aplicativo (Vendas, Contabilidade, Estoque, Ponto de Venda, Ações agendadas e assim por diante), cada um com sua taxa de sucesso e um status Falhando, Degradado ou Saudável. Filtre por aplicativo, por empresa e pelas últimas 24 horas, 7 dias ou 30 dias. Abra um fluxo para ver:

• Tentativas, falhas, pessoas afetadas e empresas, com a tendência da taxa de sucesso no período.
• Por que falha: os problemas por trás das falhas, cada um marcado como Crash ou Bloqueado, com link para a página do problema.
• Documentos em espera: cada pedido, fatura ou entrega que uma etapa com falha tocou, cada um com link direto para o registro no seu Odoo.
• A página do problema mostra a mesma ligação pelo outro lado: os fluxos que um erro quebrou e os registros que ele tocou. A Visão geral mostra seus três piores fluxos.

3Quais etapas contam

O Blipit conta os botões que fazem um documento avançar: os do próprio Odoo, como Confirmar cotação, Criar fatura, Lançar fatura, Registrar pagamento, Nota de crédito, Validar entrega, Confirmar pedido de compra e Fechar sessão do PDV, e os métodos action_ e button_ dos seus módulos personalizados, que aparecem sob o aplicativo deles com um nome derivado do método (action_approve_order vira Approve order). Cada execução de uma ação agendada também conta, incluindo Executar manualmente, assim como as ações de servidor iniciadas pelo menu Ação. Abrir visões, imprimir e outras chamadas de leitura não contam, então a lista fica curta.

4Bloqueado, com crash e tempo esgotado

Cada tentativa termina de uma de quatro formas. Sucesso: a etapa terminou. Bloqueado: o Odoo parou o usuário com uma mensagem sobre a qual ele pode agir (um UserError, ValidationError ou AccessError, como uma conta ou uma rota faltando). Crash: um erro inesperado. Tempo esgotado: o Odoo parou uma ação agendada por demorar demais. As etapas bloqueadas são contadas integralmente para a taxa de sucesso, e 1 em cada 20 também é guardada como evento de aviso para você ler a causa; etapas bloqueadas nunca acionam ninguém. Crashes e tempos esgotados chegam como eventos de erro, como qualquer outro.

5Contado a cada minuto

Cada worker do Odoo soma suas tentativas na memória e as envia ao Blipit uma vez por minuto em uma pequena requisição, e não envia nada quando está ocioso. Decidir se uma chamada é um fluxo é uma simples consulta em memória, sem acesso ao banco de dados, então as páginas não ficam mais lentas. As contagens não são cobradas como eventos; só os erros e as amostras de bloqueios contam para os eventos do seu plano.

6O aviso no registro

Quando uma etapa falha em um registro, quem abrir esse pedido, fatura ou entrega no Odoo vê um aviso vermelho dizendo qual etapa falhou, quando e por quê. Ele some quando a etapa volta a dar certo nesse registro. Só usuários internos o veem. O aviso exige o plano Solo ou superior e vem ativado por padrão; desative-o no Odoo em Configurações, Blipit, Fluxos. No mesmo lugar você pode ativar uma nota de uma linha no chatter do registro quando uma etapa falha. A nota vem desativada por padrão porque escreve nos seus registros.

7Alertas

A página de Alertas tem uma seção Alertas de fluxos com duas regras, ambas ativadas desde o início. Falhando para muitas pessoas dispara quando 3 ou mais pessoas têm um crash no mesmo fluxo em 10 minutos. Ação agendada falhando dispara quando uma ação agendada falha 2 execuções seguidas ou esgota o tempo. Você pode mudar o limite e o período, ou desativar uma regra. Os alertas de fluxos vão para as mesmas pessoas e canais dos seus outros alertas (regras de e-mail, Slack, Microsoft Teams e webhooks, ou os proprietários quando não há nenhum), respeitam as sonecas e o limite de alertas por hora, enviam um aviso por fluxo e enviam uma mensagem de normalização quando o problema está resolvido há 15 minutos. Etapas bloqueadas nunca geram alerta.

8Planos

• Todos os planos: falhas por fluxo, as pessoas afetadas, os documentos em espera com seus links para o Odoo, as causas e o alerta Falhando para muitas pessoas.
• Solo e superiores: taxas de sucesso, tentativas e a tendência, o alerta Ação agendada falhando e o aviso no registro no Odoo.
• Histórico: 7 dias no Free, 30 dias nos planos pagos.
• As tentativas são contadas em todos os planos, então as taxas de sucesso do seu histórico recente aparecem assim que você faz o upgrade.

9Privacidade

Etapas bem-sucedidas são enviadas só como contagens: o fluxo, a empresa e quantas. Uma etapa com falha envia também os ids de registro dos documentos que tocou (até 20), o id de usuário do Odoo e o id da empresa, tudo como números simples. Os dados de fluxos nunca trazem valores, nomes ou mensagens. A mensagem que o Odoo mostrou a um usuário bloqueado fica dentro do seu próprio banco de dados do Odoo, onde o aviso a lê. As amostras de 1 em cada 20 bloqueios são eventos de erro, e a mensagem delas tem números e valores entre aspas removidos antes de sair do Odoo.

Bom saber

• Funciona com o Odoo nos seus próprios servidores e no Odoo.sh. O Odoo Online não permite módulos de terceiros.
• Quando o Odoo reinicia um worker, por exemplo ao atingir o limit_request, até um minuto de contagens desse worker pode ser perdido. As taxas de sucesso toleram isso.
• Quando o Odoo repete uma etapa após um conflito no banco de dados, só o resultado final conta.
• Erros de versões antigas do módulo ainda mostram o fluxo na página do problema quando a requisição nomeia o botão, mas as taxas de sucesso e os documentos em espera exigem a 1.15.0.
• Os links de registros abrem seu Odoo no endereço que o módulo informou ao se conectar, como /odoo/<model>/<id>.
• Os registros de etapas com falha seguem o histórico de fluxos do seu plano; um registro cuja etapa deu certo depois é apagado após 7 dias.