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#
- Em Monitores, clique em Novo monitor e escolha HTTP.
- Preencha Nome e URL. A URL precisa ser completa, com
http://ouhttps://. - Ajuste os demais campos, se precisar (veja abaixo).
- Em Alertas, escolha para onde vão os avisos.
- Clique em Criar monitor.
Os campos do formulário#
| Campo | O que é |
|---|---|
| Intervalo | De 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ções | Falhas seguidas antes de abrir um incidente, de 1 a 10. Padrão: 2. |
| Método | GET (padrão), HEAD, POST, PUT, PATCH, DELETE ou OPTIONS. |
| Cabeçalhos | Enviados em cada verificação, até 50. Use para um token de acesso, por exemplo. |
| Corpo da requisição | Aparece com POST, PUT, PATCH e DELETE. Até 65.536 caracteres. |
| Status esperados | Os códigos que contam como sucesso. |
| Seguir redirecionamentos | Ligado por padrão. |
| Asserções | Condiçõ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.