Monitores de disponibilidade

Um monitor vigia um site ou uma API por si. O Zenhook pode verificar um URL público a partir de fora da sua infraestrutura, ou receber os resultados assinados de uma verificação que corre dentro da sua rede privada.

Monitores e webhooks

São os dois sentidos opostos em que o Zenhook funciona, e é fácil confundi-los:

  • Canais (webhooks): é a sua app que chama o Zenhook. Envia um webhook por POST para o URL de um canal e o Zenhook transforma-o num alerta.
  • Monitores (disponibilidade): o Zenhook verifica um URL público, ou o seu agendador verifica um URL privado e envia o resultado assinado. O Zenhook avisa-o quando o serviço fica em baixo e quando volta.

Um monitor acompanha o estado de um serviço ao longo do tempo. Uma verificação pública só precisa de um URL. Uma verificação privada exige que execute o comando gerado dentro da rede.

Adicionar um monitor

1. Abra Monitores. Na web, clique em Monitores por baixo da caixa de entrada e depois em Adicionar monitor. No telemóvel, abra o separador Monitores e toque em +.

2. Cole o URL. Introduza o endereço que quer vigiar, por exemplo https://example.com ou um endpoint de saúde como https://api.example.com/health.

3. Guarde. O Zenhook começa a verificar de imediato e mostra o estado atual, o último tempo de resposta e o histórico recente das verificações.

Monitorizar uma rede privada

Escolha Rede privada para um serviço numa VPN, tailnet, VPC, LAN ou localhost. O Zenhook dá-lhe um comando para executar nessa rede. O comando verifica o alvo localmente e envia apenas o resultado assinado ao Zenhook, por HTTPS.

O segredo do heartbeat é mostrado uma única vez. O Zenhook guarda a impressão digital do segredo completo e um prefixo curto para o identificar. Se os resultados deixarem de chegar durante o período de tolerância, o Zenhook marca o monitor como em baixo. Assim deteta também um agendador parado, uma rede desligada ou uma máquina avariada.

Não precisa de nenhuma porta de entrada, endpoint público, par de VPN nem agente do Zenhook. Coloque o comando gerado no cron, num timer do systemd, num CronJob do Kubernetes, num runner de CI ou em qualquer agendador capaz de executar curl.

Como funcionam as verificações

Cada monitor é consultado a cada minuto no Free e a cada 30 segundos no Pro, com um tempo limite de 10 segundos. Uma verificação é bem-sucedida quando o URL responde com um estado HTTP entre 200 e 399 (os redirecionamentos são seguidos).

Uma falha isolada nunca o acorda. Quando uma verificação falha, o Zenhook tenta novamente 10 segundos depois e pergunta a um ponto de observação independente, noutra rede e com o seu próprio resolvedor de DNS, se ainda chega ao site. Um monitor só passa a estar em baixo depois de a falha ser confirmada e de essa segunda opinião também não o conseguir alcançar. Enquanto o site está em baixo, é verificado a cada 10 segundos, e a primeira verificação bem-sucedida volta a marcá-lo como online de imediato.

Na prática, fica a saber de uma falha real, no máximo, cerca de 70 segundos depois de o site ter ficado em baixo no Free, 40 segundos no Pro, e do regresso em 10 segundos.

Quando o estado muda, de online para em baixo ou o inverso, o Zenhook envia um alerta pelos seus canais de notificação (som, desktop, push e e-mail), tal como são entregues os alertas dos canais.

Um site que cai de forma intermitente

Um site que cai um minuto a cada dez minutos alertaria duas vezes de cada vez. Por isso, à segunda falha numa hora, o Zenhook diz-lhe uma vez que o monitor está instável e deixa de anunciar as falhas curtas.

Enquanto está instável, continua a ser alertado de uma falha que dure 5 minutos, e da sua recuperação. Após uma hora sem falhas, um alerta fecha o episódio com o número de falhas e a sua duração. A página do monitor lista todas as falhas das últimas 24 horas, anunciadas ou não.

Pausar um monitor

Na web, abra o monitor e clique em Pausar, ou use o menu do seu mosaico. Há três opções:

  • Alertas por 1 hora ou Alertas por 24 horas: o monitor continua a ser verificado e a sua página mantém o histórico, nada é enviado. Os alertas voltam sozinhos no fim do prazo.
  • O monitor: as verificações também param, até retomar.

Retomar desfaz qualquer uma. No telemóvel, Pausar no menu do monitor pausa o monitor.

A partir de um script ou de um agente de IA, com um token das Definições, Tokens de API:

bash
# Os seus monitores e os respetivos ids
curl -H "Authorization: Bearer $ZENHOOK_TOKEN" https://zenhook.dev/api/monitors

# Alertas em pausa até uma data (7 dias no máximo); null retoma-os
curl -X PATCH -H "Authorization: Bearer $ZENHOOK_TOKEN" -H "Content-Type: application/json" \
  -d '{"mutedUntil": "2026-10-12T08:00:00Z"}' https://zenhook.dev/api/monitors/MONITOR_ID

# Monitor em pausa; true retoma-o
curl -X PATCH -H "Authorization: Bearer $ZENHOOK_TOKEN" -H "Content-Type: application/json" \
  -d '{"enabled": false}' https://zenhook.dev/api/monitors/MONITOR_ID

Um 200 nem sempre quer dizer online

Muitas falhas respondem com um código de estado perfeitamente saudável. O Zenhook lê a resposta, e não apenas o número, e considera em baixo:

  • Páginas de erro de CDN servidas com 200: bad gateway, serviço indisponível, origem inacessível, falha na negociação SSL e o resto do texto habitual.
  • Cache desatualizada: a sua CDN serve uma cópia em cache porque já não chega à sua origem. O visitante vê um site, mas o site está em baixo.
  • Páginas de desafio anti-bot: um CAPTCHA não é o seu conteúdo.

Perguntas frequentes

Verificam a partir de vários sítios ao mesmo tempo?

Não em todas as verificações, e não é uma votação. A verificação agendada parte de um único sítio. Um segundo ponto de observação independente só é consultado em caso de falha, e tem direito de veto: se ainda chega ao seu site, a falha é considerada nossa e não recebe nenhum alerta. Só avisamos quando ninguém o consegue alcançar. Esta assimetria é intencional: o erro caro é acordá-lo às 3 da manhã por causa de um site que estava a funcionar.

Posso alterar o intervalo de verificação?

Os URLs públicos são verificados a cada minuto no Free e a cada 30 segundos no Pro, e a cada 10 segundos em qualquer plano enquanto falham. O comando de rede privada foi pensado para ser executado a cada minuto. O Zenhook marca o serviço como em baixo se os resultados deixarem de chegar durante o período de tolerância.

Porque vejo um parâmetro _zenhook nos meus registos?

Somos nós. Cada verificação acrescenta um valor _zenhook único para que nenhuma cache, nossa ou sua, responda em vez do seu servidor. Um monitor que bate numa cache não vigia nada.

Como autorizo o Zenhook na minha firewall ou WAF?

As verificações identificam-se com o user agent Zenhook Uptime Monitor/1.0. Se a sua WAF o bloquear ou lhe apresentar um desafio, o monitor mostra o site em baixo quando está a funcionar.

Posso monitorizar localhost ou um endereço privado?

Sim. Escolha Rede privada ao criar o monitor e execute o comando gerado dentro da rede. O comando verifica localhost ou o endereço privado localmente e envia um resultado assinado ao Zenhook.

Porque é que Verificações recentes mostra menos linhas do que esperava?

A lista mostra primeiro as verificações mais recentes, as estatísticas cobrem as últimas 24 horas e o histórico detalhado é guardado durante 7 dias.

Vou receber quarenta alertas se a avaria for do Zenhook?

Não. Quando uma parte invulgar dos monitores falha no mesmo ciclo, a causa quase nunca é todos esses sites sem relação terem ficado em baixo ao mesmo tempo: o Zenhook suprime esses alertas, mantém os estados como estão e encaminha o problema para nós, não para si.

Limites dos planos

O plano gratuito inclui 3 monitores. O Pro sobe para 20 monitores.

Não recebe os alertas dos monitores? Consulte a resolução de problemas de notificações