Requisição HTTP
A tarefa HTTP verifica se um site ou serviço web abre como você espera no trabalho normal.
Quando usar
- Quando precisar controlar uma página do site, painel pessoal ou endpoint de health.
- Quando for importante verificar não só a disponibilidade do servidor, mas também a resposta HTTP correta.
- Quando quiser ver a falha pelos olhos do usuário, e não só pela porta aberta.
Quando escolher outro tipo
- Se precisar verificar apenas a conectividade de rede básica do servidor, geralmente o Ping é suficiente.
- Se importar apenas a validade do certificado, o SSL é mais adequado.
- Se o monitoramento deve aguardar um sinal de um processo externo, use "Evento externo".
Atenção:
para a verificação principal, escolha melhor um URL que realmente reflita o estado operacional do serviço,
e não uma página aleatória que pode mudar por autenticação, anúncios ou personalização.
Campos gerais do formulário
| Campo | O que significa | O que indicar | Exemplo |
|---|---|---|---|
| Tarefa ativada | Determina se a verificação será iniciada imediatamente após a salvação. | Deixe a tarefa ativada se quiser começar o monitoramento imediatamente. | Ativado |
| Nome | Nome da verificação na lista e notificações. | Indique o que exatamente está sendo verificado. | Página inicial example.com |
| Grupo | Permite atribuir a tarefa a um projeto ou seção. | Selecione um grupo se quiser manter as tarefas do projeto juntas. | Site example.com |
| Intervalo | Com que frequência a verificação HTTP será executada. | Escolha o intervalo com base na importância da página ou serviço. | 5 minutos |
| Canais de notificação | Para onde enviar mensagens sobre problemas e recuperações. | Marque os canais onde você realmente lê as notificações. | Telegram e email |
| Relatórios | Resumos periódicos da tarefa. | Ative se quiser receber um overview sem entrar manualmente no painel. | Relatório semanal |
Campos da verificação HTTP
| Campo | O que significa | O que indicar | Exemplo |
|---|---|---|---|
| Método | Qual solicitação HTTP será enviada. | Geralmente GET é suficiente. Outros métodos são necessários se o seu endpoint os exigir. | GET |
| URL | Endereço completo da página ou endpoint a ser verificado. | Indique o URL completo com esquema e domínio. | https://example.com/health |
| Timeout | Quanto tempo esperar pela resposta antes de erro por indisponibilidade. | Escolha um valor um pouco maior que o tempo normal de resposta do seu serviço. | 30 segundos |
| Palavra-chave | Verificação adicional do conteúdo da resposta. | Indique o texto que deve estar presente na resposta. | OK |
| Configurações avançadas | Abre campos HTTP adicionais. | Ative apenas se precisar de cabeçalhos, corpo da solicitação ou lista personalizada de códigos de sucesso. | Ativado |
| Cabeçalhos | Cabeçalhos HTTP adicionais da solicitação. | Adicione apenas os cabeçalhos realmente necessários para a sua API. | Authorization: Bearer <token> Accept: application/json |
| Conteúdo | Corpo da solicitação HTTP para POST, PUT ou PATCH. | Preencha se o endpoint aguardar JSON ou outro corpo de solicitação. | {"event":"healthcheck"} |
| Códigos de resposta bem-sucedidos | Quais códigos HTTP considerar resultado normal. | Deixe o intervalo padrão ou defina seus próprios códigos e intervalos. | 200-299, 301 |
| Permitir certificado autoassinado | Não considerar erro um certificado que os navegadores não confiam. | Ative para serviços internos via HTTPS com seu próprio certificado. | Desativado |
| Pontos permitidos para verificação | De quais pontos a verificação será feita. | Deixe todos os pontos se não precisar de um cenário especial por regiões ou redes. | Todos os pontos de verificação |
Quando o alarme será acionado
- O site ou endpoint não responder no prazo.
- O servidor retornar um código que não está na lista de sucessos.
- Na resposta não houver o texto obrigatório, se você indicou uma palavra-chave.
- Para um endereço HTTPS, não será possível estabelecer uma conexão segura: certificado expirado, não é confiável ou foi emitido para outro nome. A razão da verificação indicará o que exatamente está errado.
Verificando um serviço interno? Se ele funciona via HTTPS com um certificado autoassinado,
ative «Configurações avançadas» e marque o parâmetro «Permitir certificado autoassinado» —
caso contrário, a verificação falhará devido à desconfiança do certificado, embora o serviço em si responda normalmente.
Configuração de notificações
Para cada canal de notificação na tarefa, é possível definir parâmetros adicionais. Eles valem apenas para eventos DOWN.
| Parâmetro | O que faz |
|---|---|
| Ativado | Permite ou proíbe o envio de notificações por este canal para esta tarefa. |
| Atrasar por PRO | Atrasar a primeira notificação de DOWN pelo tempo selecionado (até 12 horas). Útil para não receber alertas sobre falhas temporárias. |
| Repetir a cada PRO | Repete periodicamente a notificação enquanto a tarefa permanecer no status DOWN (até 1 hora entre repetições). Adequado quando é importante não perder um downtime prolongado. |
Os parâmetros «Adiar» e «Repetir» não afetam eventos UP e notificações de recuperação.