O erro mais caro numa operação digital nem sempre aparece como erro.
Quando um sistema avaria e mostra uma mensagem clara, alguém repara. Uma página fica indisponível, uma aplicação deixa de abrir ou um pagamento é recusado: há um sinal visível e, normalmente, alguém acaba por agir.
O problema sério é quando o sistema parece estar bem, mas deixou de fazer aquilo que devia.
Um formulário continua disponível, mas já não envia pedidos para o CRM. Uma integração deixa de transferir dados. Uma tarefa automática, que devia correr todos os dias às seis da manhã, simplesmente não corre. Um backup continua a aparecer como concluído, mas nunca foi testado e pode não servir para restaurar nada.
Não há alarme. Não há mensagem de erro. Não há ninguém a correr.
Passam-se dias.
É precisamente para vigiar este tipo de ausência que existe um sistema watchdog.
O que é um sistema watchdog?
Um watchdog é um mecanismo independente que verifica continuamente se um processo, serviço ou resultado está a acontecer dentro dos parâmetros esperados. Quando isso deixa de acontecer, envia um alerta ou desencadeia uma ação.
A ideia é simples:
Não vigia apenas se o sistema está ligado. Vigia se o sistema está a cumprir a função que lhe foi atribuída.
A diferença é importante.
Um servidor pode estar ligado. Uma página pode responder. Uma automação pode estar tecnicamente ativa. Ainda assim, o resultado esperado pode não estar a acontecer.
O watchdog verifica esse resultado.
A palavra mais importante na definição é independente. Se o mecanismo que vigia estiver dentro do mesmo sistema que pode falhar, pode desaparecer juntamente com o problema. Um watchdog deve estar noutra conta, noutro serviço, noutra máquina ou, pelo menos, sujeito a uma lógica separada.
O watchdog não executa necessariamente o trabalho. Confirma que o trabalho foi feito. Não substitui a pessoa responsável, mas evita que essa pessoa tenha de estar permanentemente a olhar para cada processo.
É como a diferença entre alguém verificar manualmente o forno a cada cinco minutos e um mecanismo que avisa quando o pão devia estar no forno, mas ainda não está.
Watchdog, monitorização e alertas não são a mesma coisa
Estes conceitos são frequentemente misturados, mas cumprem funções diferentes.
Monitorização
A monitorização recolhe informação sobre o que está a acontecer:
- utilização de memória;
- velocidade de resposta;
- erros registados;
- tráfego;
- estado de um servidor;
- número de pedidos processados.
É sobretudo descritiva. Mostra o estado do sistema.
Alertas
Um alerta dispara quando um valor ultrapassa um limite definido.
Por exemplo:
- a utilização do processador ultrapassou 90%;
- a taxa de erros passou os 5%;
- o tempo de resposta excedeu três segundos;
- o espaço disponível desceu abaixo de 10%.
É uma reação a um facto observado.
Watchdog
Um watchdog verifica se o próprio processo continua a acontecer e se o resultado faz sentido.
Pode perguntar:
- o formulário recebeu algum pedido nas últimas 24 horas?
- a tarefa das seis da manhã foi executada?
- os dados chegaram ao sistema seguinte?
- o backup foi criado e pode ser restaurado?
- o agente de IA produziu um relatório válido?
- o número de pagamentos no sistema coincide com o número de pagamentos no banco?
Um servidor pode estar completamente “verde” na monitorização enquanto o formulário do site não gera um único contacto há cinco dias. O problema não está necessariamente no servidor. Pode estar numa integração, numa regra, numa autorização ou num processo posterior.
A monitorização vê o que está a acontecer. O watchdog procura o que devia estar a acontecer e deixou de acontecer.
Como funciona um watchdog na prática?
Existem várias formas de construir esta vigilância. A escolha depende do processo e do prejuízo associado à falha.
1. Sinal de vida
O processo envia regularmente um sinal para um local independente. Esse sinal confirma duas coisas:
- o processo está vivo;
- a tarefa foi executada.
Se a tarefa devia correr de hora a hora e o último sinal chegou há três horas, o watchdog dispara.
Este é o mecanismo mais simples e útil para automações, agentes de IA, tarefas agendadas e integrações.
2. Verificação por tempo limite
Define-se o tempo máximo aceitável para uma tarefa.
Se um relatório devia ficar pronto em dez minutos e continua sem resultado ao fim de trinta, o sistema assume que alguma coisa correu mal. Não é preciso esperar por uma mensagem de erro.
Um tempo limite demasiado curto gera falsos alarmes. Um tempo limite demasiado longo faz com que descubras o problema tarde demais. O valor deve ser definido a partir do impacto real da falha.
3. Teste sintético
Em vez de esperar que um cliente descubra o problema, o watchdog simula periodicamente a ação real.
Num formulário, por exemplo, pode:
- enviar uma submissão de teste;
- confirmar que o registo apareceu;
- verificar que foi atribuído corretamente;
- confirmar que a notificação chegou ao destino.
Verificar apenas se a página abre não chega. O teste deve seguir o caminho completo da operação.
4. Regra de negócio
Aqui o watchdog não verifica o processo técnico. Verifica o resultado comercial.
Exemplos:
- devem entrar pelo menos cinco pedidos de contacto por dia;
- todas as faturas emitidas devem ficar registadas;
- cada pagamento recebido deve corresponder a uma encomenda;
- nenhuma oportunidade pode ficar mais de 48 horas sem acompanhamento;
- todos os dias deve existir um relatório atualizado.
Estas regras não provam, por si só, que existe uma falha técnica. Mas mostram que há algo que merece investigação.
5. Verificação cruzada
Compara-se a mesma realidade em duas fontes independentes.
Por exemplo:
- o CRM regista 12 vendas;
- o sistema de pagamentos regista 11;
- a faturação mostra 10 documentos emitidos.
A diferença é o sinal. O watchdog não precisa de saber imediatamente qual é a fonte errada. Precisa de impedir que a discrepância passe despercebida.
6. Verificação de integridade
É particularmente importante nos backups.
Não basta confirmar que um ficheiro foi criado. É preciso verificar:
- a data;
- o tamanho;
- a existência dos dados esperados;
- a possibilidade de abrir ou ler o ficheiro;
- a capacidade de restaurar a informação.
Um backup que nunca foi restaurado é uma promessa, não uma garantia.
7. Alerta com contexto e responsável
Um alerta enviado para uma caixa de correio que ninguém lê não protege o negócio.
Cada alerta deve indicar:
- o que devia ter acontecido;
- o que foi detetado;
- quando começou o problema;
- qual o impacto provável;
- quem é responsável;
- qual a ação esperada;
- qual o grau de urgência.
O objetivo não é produzir mais notificações. É permitir uma decisão rápida.
Em que situações vale a pena montar um watchdog?
Há alguns processos onde esta vigilância é especialmente prática.
Formulários e pedidos de contacto
Confirma que cada pedido chega ao CRM, gera uma notificação e fica atribuído a uma pessoa.
Uma submissão de teste semanal pode detetar problemas que, de outra forma, só seriam descobertos quando um potencial cliente telefona a perguntar por que razão nunca recebeu resposta.
Integrações entre ferramentas
Sempre que dois sistemas trocam informação, existe um ponto possível de falha.
Uma alteração numa autorização, numa API ou num campo pode interromper a passagem de dados sem desligar completamente nenhum dos sistemas. O watchdog confirma que os dados continuam a chegar ao destino.
Automações e tarefas agendadas
Se uma rotina devia correr todos os dias às seis da manhã, o alerta deve chegar às seis e cinco — não três semanas depois.
Isto aplica-se a relatórios, sincronizações, atualizações de preços, processamento de pedidos e tarefas administrativas.
Agentes de IA
Quanto mais autonomia deres a um agente, mais importante é confirmares o que ele realmente fez.
Um watchdog pode verificar:
- se o agente correu;
- quando correu;
- quantos registos processou;
- se produziu um resultado;
- se o resultado tem conteúdo plausível;
- se existem valores absurdos ou contradições.
Um agente que falha em silêncio pode dar a impressão de que está a trabalhar enquanto a operação fica parada.
Backups
É o caso clássico. Fazer uma cópia é fácil. Saber se a cópia permite recuperar o negócio é a parte que costuma ser ignorada.
O watchdog deve testar a existência, a atualidade e, periodicamente, o restauro.
Pagamentos e faturação
Aqui, o silêncio transforma-se rapidamente em dinheiro perdido.
Deves vigiar:
- faturas que deviam ter sido emitidas;
- pagamentos que não foram conciliados;
- cobranças recorrentes que falharam;
- encomendas pagas que não chegaram à operação;
- diferenças entre vendas, pagamentos e faturação.
Sites e lojas online
Verificar apenas se a página inicial abre é insuficiente.
O teste deve confirmar o percurso completo:
- o produto ou serviço é apresentado;
- o pedido pode ser submetido;
- o pagamento pode ser concluído;
- a encomenda fica registada;
- a operação recebe a informação.
Quando não vale a pena montar um watchdog?
Nem tudo precisa de vigilância automática.
Não vale a pena criar um watchdog quando:
- ninguém está definido para agir sobre o alerta;
- o processo é trivial e fácil de corrigir;
- o custo da falha é inferior ao custo de construir e manter a vigilância;
- já existe outro alerta eficaz para o mesmo problema;
- há tantos alertas que as pessoas já deixaram de os levar a sério.
Cada alerta deve merecer uma interrupção.
Se não merece, transforma-o num relatório. Um relatório informa. Um alarme interrompe porque há uma razão para agir agora.
Como montar o primeiro watchdog
Começa pelo prejuízo, não pela tecnologia.
Pergunta:
Se este processo parar amanhã e ninguém me avisar, quanto tempo demorarei a descobrir?
Escolhe depois três ou quatro processos críticos. Não tentes vigiar tudo.
Para cada um, define:
- O que devia acontecer?
- Com que frequência?
- Como confirmo que aconteceu?
- Quanto tempo posso esperar antes de considerar que existe um problema?
- Quem recebe o alerta?
- O que deve fazer?
- Em quanto tempo?
Constrói a verificação fora do sistema vigiado. Usa outra conta, outro serviço ou outra infraestrutura quando fizer sentido.
Depois, testa o watchdog de propósito. Desliga a automação. Interrompe a integração. Simula um backup inválido. Confirma que o alerta chega à pessoa certa e que ela sabe o que fazer.
Um watchdog que nunca foi testado é apenas uma suposição.
Deves também revê-lo ao longo do tempo. Os parâmetros mudam quando aumentam os pedidos, quando alteras horários ou quando o negócio passa a depender de novos sistemas.
Para organizar estes processos, pode ser útil começar por um sistema simples de ferramentas e estratégia digital e documentar o que deve acontecer sem depender da memória de uma única pessoa. Essa documentação torna as falhas mais fáceis de detetar e corrigir.
O papel da inteligência artificial
A inteligência artificial pode acrescentar uma camada de análise ao watchdog.
Em vez de verificar apenas se um ficheiro chegou, pode avaliar se o conteúdo faz sentido. Pode detetar:
- um relatório vazio;
- números muito diferentes dos períodos anteriores;
- uma resposta que contradiz dados conhecidos;
- um resumo que omite informação essencial;
- uma alteração anormal no comportamento dos clientes.
Também pode reduzir o ruído, agrupando vários alertas relacionados, distinguindo sintomas de causas prováveis e resumindo o problema numa linguagem útil para quem tem de decidir.
Mas há uma regra: a IA não substitui a definição do que está errado.
Primeiro defines o resultado esperado. Depois decides que parte da verificação pode ser automatizada. A inteligência artificial pode ajudar a interpretar o sinal; não deve inventar o critério.
A pergunta que deves fazer hoje
Um sistema watchdog não é um luxo técnico. É uma forma prática de reduzir o tempo entre uma falha e a sua descoberta.
A regra é simples:
Se isto parar amanhã e ninguém te avisar, quanto tempo passará até descobrires?
Se a resposta for “algumas horas” ou “alguns dias”, encontraste um candidato claro a watchdog.
Começa pelo processo que pode morrer em silêncio e causar mais prejuízo. Define o que devia acontecer, cria uma verificação independente e garante que o alerta chega a quem pode agir.
O objetivo não é vigiar mais. É deixar de depender da sorte para descobrir que uma parte importante do teu negócio deixou de funcionar.