Adicionar e gerenciar monitores

Um monitor (check) é algo que o SentraX Status verifica de tempos em tempos — um site, uma API, uma porta TCP, um certificado SSL ou uma métrica do CloudWatch. Quando um monitor cai, a plataforma detecta, registra e (se você configurou) notifica.

Criar um monitor

No admin, vá em Checks → "Novo check". O formulário tem 3 passos: Tipo, Configuração e Agendamento.

Passo 1 — Tipo

Nome — como o monitor aparece no admin e na página pública (ex.: Chatwoot prod). Mínimo de 2 caracteres.
Tipo do check — escolha entre HTTP, TCP, SSL/TLS expiry ou CloudWatch metric.

Segurança: o nome e o tipo são o que aparece na página pública — nunca o alvo (URL, host ou porta). O alvo só é visível para você, no admin. Então escolha um nome que faça sentido pro seu cliente ("Portal", "API de pagamentos") sem expor endpoints internos.

Passo 2 — Configuração (por tipo)

HTTP — verifica uma URL:

Campo	Descrição	Default
URL	`https://...` a verificar	—
Método	GET / HEAD / POST	GET
Status esperados (vírgula)	Códigos aceitos, ex. `200,201,204`	`200,201,204,301,302`
Keyword (opcional)	Texto que deve aparecer no corpo da resposta	—
Falhar se a keyword aparecer (negate)	Inverte: alerta se o texto aparecer (útil pra pegar página de erro que responde 200)	desligado

TCP — verifica se uma porta aceita conexão:

Campo	Descrição
Host	ex.: `db.example.com`
Porta	entre 1 e 65535 (ex.: `5432`)

SSL/TLS expiry — avisa antes de um certificado vencer:

Campo	Descrição	Default
Hostname	sem `http://` e sem porta (ex.: `api.example.com`)	—
Avisar N dias antes da expiração	quantos dias antes do vencimento alertar	14

Let's Encrypt emite certificados de 90 dias e renova ~30 dias antes. Avisar com 14–30 dias pega renovação travada a tempo. Certificados do ACM renovam sozinhos.

CloudWatch metric — alerta quando uma métrica da AWS cruza um limite:

Campo	Descrição	Default
Região AWS	ex.: `sa-east-1`	sa-east-1
Namespace	ex.: `AWS/EC2`	—
Métrica	ex.: `CPUUtilization`	—
Dimensions (Key=Value, vírgula)	ex.: `InstanceId=i-0abc123,Service=api`	—
Estatística	Average / Sum / Maximum / Minimum	Average
Período (s)	mínimo 60	60
Alerta quando o valor for	`>`, `≥`, `<` ou `≤`	`>`
Threshold	valor numérico do limite	—

O CloudWatch exige a permissão IAM cloudwatch:GetMetricData no worker. Sem ela, o monitor fica "Fora do ar".

Passo 3 — Agendamento e visibilidade

Campo	Descrição	Default
Intervalo (s)	de quanto em quanto tempo verificar (mín. 10)	60
Timeout (ms)	quanto esperar por resposta (mín. 1000)	10000
Visível na página pública	se aparece em `status-<slug>...`	marcado

Clique em "Criar check".

Limite do plano: alguns planos limitam o número de monitores (monitors_max). Ao atingir o teto, a criação é bloqueada com um aviso pedindo upgrade no portal.

Estados de um monitor

Na lista de Checks e na página pública, cada monitor tem um status:

Status	Significado
Operacional	tudo certo
Degradado	respondendo, mas com problema
Fora do ar	falhando
Recuperando	voltando ao normal
Pausado	verificação suspensa por você
Sem dados	ainda não rodou

Ver detalhes

Clique em um monitor para abrir o detalhe. Aqui (e somente aqui, no admin) você vê o Alvo (URL/host/porta), o intervalo, se é visível, a última execução, os cards de Uptime 7d / 30d / 90d e o Histórico de execuções.

Editar, pausar e deletar

Editar — muda o nome e a configuração. O tipo não pode ser alterado depois de criado.
Pausar / Despausar — suspende as verificações (status vira "Pausado"). Despausar reagenda para rodar já.
Deletar — remove o monitor e todo o histórico (execuções e transições). Por segurança, é preciso digitar o nome do monitor para confirmar. As notificações param, mas os assinantes continuam cadastrados.

Todas essas ações ficam registradas no Log de auditoria.