Pular para o conteúdo

Monitor HTTP

Acompanha um site ou uma API pelo código de resposta, pelo tempo de resposta e pelo conteúdo.

Atualizado em

Neste artigo

O monitor HTTP faz uma requisição a uma URL a cada intervalo e confere a resposta: o código de status, o tempo e, se você quiser, o conteúdo. É o tipo certo para sites, páginas específicas e endpoints de API.

Criar o monitor#

  1. Em Monitores, clique em Novo monitor e escolha HTTP.
  2. Preencha Nome e URL. A URL precisa ser completa, com http:// ou https://.
  3. Ajuste os demais campos, se precisar (veja abaixo).
  4. Em Alertas, escolha para onde vão os avisos.
  5. Clique em Criar monitor.

Os campos do formulário#

CampoO que é
IntervaloDe quanto em quanto tempo checar, de 30 segundos a 1 dia. Opções abaixo do mínimo do plano ficam desabilitadas.
Tempo limite (segundos)Quanto esperar pela resposta, de 1 a 30 segundos. Padrão: 10.
ConfirmaçõesFalhas seguidas antes de abrir um incidente, de 1 a 10. Padrão: 2.
MétodoGET (padrão), HEAD, POST, PUT, PATCH, DELETE ou OPTIONS.
CabeçalhosEnviados em cada verificação, até 50. Use para um token de acesso, por exemplo.
Corpo da requisiçãoAparece com POST, PUT, PATCH e DELETE. Até 65.536 caracteres.
Status esperadosOs códigos que contam como sucesso.
Seguir redirecionamentosLigado por padrão.
AsserçõesCondições sobre o conteúdo da resposta.

Host, Content-Length, Transfer-Encoding e Connection são definidos pelo Notifex e não podem ser cabeçalhos seus. A requisição sai com o User-Agent NotifexMonitor/1.0 (+https://notifex.com.br), a não ser que você defina outro.

Status esperados#

Cada item é um código (200) ou uma faixa (200-399), até 10 itens. O padrão é 200-399.

Com Seguir redirecionamentos ligado, o Notifex segue até 5 redirecionamentos e confere o status da resposta final. Se o redirecionamento leva a outro endereço de origem (outro domínio ou subdomínio, outra porta, ou de http:// para https://), os seus cabeçalhos e o corpo não vão junto. Para monitorar com cabeçalhos, informe a URL final.

Desligado, um 3xx é conferido contra os status esperados. O padrão 200-399 já aceita 301 e 302. Se você restringiu a lista (por exemplo, só 200), inclua 301 ou 302 quando o redirecionamento for o comportamento certo.

Asserções#

Uma asserção é uma condição sobre a resposta, além do status. Clique em Adicionar asserção e escolha:

  • a origem: Corpo, Cabeçalho (informe o nome do cabeçalho) ou JSON (informe o caminho com pontos, como data.status);
  • o operador: contém, não contém, é igual a ou corresponde à regex;
  • o valor.

Todas as asserções precisam passar. São aceitas até 20 por monitor. Só os primeiros 64 KB do corpo entram na conferência. Se a origem for JSON e o corpo não for JSON válido, a asserção falha. A regex não aceita referências para trás nem lookarounds.

Tempo limite#

O tempo limite conta desde a resolução do nome do host até a leitura da resposta, incluindo os redirecionamentos. Ele precisa ser menor que o intervalo. Uma resposta que passa do limite conta como falha, com o erro Tempo esgotado.

Nota

As checagens partem de um único ponto, nos Estados Unidos. O tempo medido inclui essa distância: um servidor no Brasil tende a mostrar um tempo maior do que o medido de dentro do país.

Quando conta como falha#

Uma checagem falha quando o status não está entre os esperados (Status HTTP inesperado), quando uma asserção não passa (Asserção não atendida), quando o tempo limite estoura (Tempo esgotado), quando há mais de 5 redirecionamentos (Redirecionamentos demais) ou quando a conexão não acontece: Falha de DNS, Conexão recusada, Erro de TLS (inclusive certificado inválido) ou Erro de conexão.

A falha só abre incidente depois de confirmada; veja Confirmação da falha.

O detalhe do monitor#

Clique no nome do monitor na lista para abrir o detalhe.

  • Resumo: Uptime, Tempo médio, p95, Verificações e Falhas no período escolhido (24 horas, 7 dias, 30 dias ou 90 dias), com o gráfico do tempo de resposta. Períodos maiores que o histórico do seu plano ficam desabilitados. Fora das 24 horas, o p95 aparece como p95 aprox.
  • Verificações: cada checagem, com Data e hora, Resultado (Sucesso, Falha ou Inconclusivo), Tempo, Código HTTP, Erro e, em Detalhes, o IP para o qual o nome resolveu. Filtre pelo resultado no seletor ao lado do título.
  • Incidentes recentes: os últimos incidentes do monitor; Ver todos abre a lista filtrada.
  • Configuração: os campos do monitor e os Canais de alerta.

Os cabeçalhos e o corpo configurados só aparecem para quem pode editar monitores; para as demais pessoas, ficam como "oculto".

Limitações#

  • Endereços de rede interna não são aceitos: o formulário mostra Não foi possível resolver este endereço, ou ele aponta para uma rede interna.
  • As portas 25, 465 e 587 não podem ser monitoradas.
  • O tipo do monitor não muda depois de criado. Para editar os demais campos, veja Gerenciar monitores.

Não encontrou o que procurava?

Escreva para a gente pelo formulário de contato do site.

Falar com o Notifex