Health Check — Guia do usuário | YoBench

Para que serve o módulo «Health Check»

O módulo monitora continuamente a disponibilidade dos seus sites e APIs por HTTP. Não precisa manter uma aba do UptimeRobot aberta nem pagar um serviço externo de monitoramento — o YoBench consulta as URLs configuradas em um intervalo definido, registra o tempo de resposta, calcula o uptime e envia uma notificação assim que um site para de responder.

Diferente do Scanner de segurança (que inspeciona configuração: SSL, cabeçalhos, portas), o Health Check responde a uma única pergunta: «Este site está disponível agora?» — mas faz isso de forma regular, durante anos, e mantém histórico.

O que você obtém:

• Monitoramento de uptime local — os dados ficam no banco criptografado do seu computador, sem dependência de SaaS de terceiros.
• Tempo de resposta — último valor mais a média no período de retenção dos logs (7 dias por padrão).
• Uptime % em 7 dias — calculado a partir dos logs de cada verificação.
• Notificações apenas em mudança de estado — na transição «disponível → indisponível» ou em timeout, sem spam a cada sondagem bem-sucedida.
• Suporte a proxy e timeout — para monitorar recursos em redes privadas ou back-ends lentos.

Parâmetros de monitoramento

Ao criar uma verificação você especifica:

• Nome — rótulo livre (visível na lista).
• URL — endereço a ser sondado. O módulo usa HTTP GET; outros métodos ainda não são suportados.
• Descrição (opcional) — anotação para você ou seu time.
• Timeout — tempo máximo de espera de resposta em milissegundos. Faixa 500–60 000 ms; padrão 5 000.
• Proxy (opcional) — escolha um perfil de proxy nas configurações; todas as requisições desta verificação passarão por ele.
• Ativada — flag de atividade. Desmarque para pausar uma verificação sem excluí-la.

O que conta como sucesso. Uma verificação tem sucesso quando o código HTTP de resposta é < 500. Qualquer valor entre 200 e 499 é success. Um erro de rede vira error. Estourar o timeout é timeout.

Cabeçalho da requisição. Todas as requisições saem com um User-Agent: AutomationsDesk/1.0 HealthCheck fixo.

SSL. Os certificados são validados de forma padrão; não há interruptor na UI para desativar a validação SSL.

Configurações globais do módulo

Configuradas em Configurações → Health Check:

• Ativar verificações automáticas — interruptor principal do agendador. Desativado por padrão — enquanto não ligar, as verificações só rodam sob demanda.
• Intervalo de verificação (minutos) — com que frequência o agendador sonda cada URL ativa. Valor de 1 a 1440 (1 minuto a 24 horas); padrão 5 minutos. O intervalo vale para o módulo todo; intervalo por verificação não é configurável.
• Retenção de logs (dias) — quanto tempo o histórico permanece no banco. Padrão 7 dias. A mesma janela é usada para calcular uptime % e a média de tempo de resposta.
• Notificar timeouts — enviar notificação quando um site não responde dentro do timeout. Ligado por padrão.
• Notificar erros — enviar notificação em caso de erro de rede ou resposta 5xx. Ligado por padrão.

As notificações disparam apenas em mudança de estado (por exemplo, último resultado success, atual timeout). Lembretes do tipo «tudo bem» não são enviados.

Notificações

As notificações saem por dois canais configurados no centro de notificações do app:

• Telegram — bot token + chat ID.
• E-mail — SMTP (host, porta, usuário, senha, remetente, destinatário, opção TLS).

Os canais são configurados uma única vez para todo o YoBench e usados automaticamente por todos os módulos que emitem notificações. Outros canais (Discord, Slack, push, webhook) ainda não são suportados.

Fluxo de uso

1. Adicione uma verificação

1. Abra o módulo Health Check no menu lateral esquerdo.
2. Clique em + Adicionar site.
3. Preencha nome, URL e (opcional) descrição.
4. Defina o timeout e escolha um proxy se precisar.
5. Mantenha Ativada marcada para iniciar o monitoramento na hora.
6. Salve.

2. Ative verificações automáticas

1. Abra Configurações de monitoramento no topo da página Health Check.
2. Marque Ativar verificações automáticas.
3. Defina o intervalo em minutos (padrão 5).
4. Configure a retenção de logs e os canais de notificação.
5. Salve as configurações.

A partir daí o agendador passa a sondar cada URL ativa nesse intervalo.

3. Verificação manual

Você pode rodar uma verificação a qualquer momento sem esperar o próximo tick do agendador:

• Verificar ao lado de uma linha — sonda uma única URL.
• Verificar todas no topo — sonda em paralelo todas as verificações ativas.

4. Analise os resultados

A página principal exibe uma tabela com as colunas:

Para ver o histórico completo, clique em Logs ao lado de uma verificação. Abre-se um painel com timestamp, status, tempo de resposta e texto de erro por linha. Filtro por status (Todos / Disponível / Indisponível / Timeout) e paginação a cada 50 linhas.

5. Gerencie verificações

• Editar — altera parâmetros (URL, timeout, proxy).
• Desmarcar «Ativada» — pausa a verificação sem excluí-la.
• Excluir (×) — remove a verificação e seus logs (com confirmação).

Próximos passos

• Conecte as notificações (Telegram/e-mail) para saber das quedas na hora.
• Configure os proxies se precisar monitorar recursos em rede privada.
• Se a segurança da configuração é tão importante quanto o uptime, rode em paralelo o Scanner de segurança.

Ajuda e feedback

Encontrou um bug ou tem uma ideia de função? Escreva para nós pelo formulário de contato.