Alertas
O que são
Regras do Grafana que olham métricas e logs da plataforma e mandam um e-mail quando algo sai do normal: serviço fora do ar, erros em excesso, certificado perto de vencer, tentativa de invasão, pagamento parado. Cada alerta tem uma página aqui dizendo o que ele representa, como confirmar no Grafana e o que fazer.
Como receber
Os alertas vão para o grupo ops@coderoom.com.br (Zoho). Para receber, peça a quem administra o Zoho da Coderoom para entrar no grupo. Quem recebe se muda no grupo, sem mexer no Grafana.
- O remetente é
Coderoom Alertas <alertas@coderoom.com.br>. Se o primeiro e-mail cair no spam, marque como não spam. - Os e-mails saem pelo Oracle Email Delivery, com franquia de 3.000 por mês para a conta inteira. Por isso os avisos são agrupados (veja abaixo).
Como ler o e-mail
O assunto traz o estado e o nome: [FIRING:1] nginx limitando requisições em volume alto. Dentro:
| Campo | O que é |
|---|---|
| Summary | O fato, com o número do momento. |
| Description | Três linhas: Dispara (a condição exata), Risco (o que está em jogo) e O que fazer (os primeiros passos). |
| Values | Os números da regra: A é a medida, B o valor reduzido e C=1 quer dizer condição verdadeira. |
| Labels | severity, service e o que identifica o caso (host, zone, ip...). |
| View runbook | Abre a página do alerta neste site. |
| View alert / Silence | Abre a regra no Grafana / silencia o alerta por um tempo. |
Estados
- Firing: o problema está acontecendo.
- Resolved: o problema acabou. Nos alertas de log (Loki) o Resolved chega uns 10 minutos depois, porque a regra olha uma janela de 10 minutos. Um Resolved com
NoDataé o estado saudável: não há mais nada para contar.
Severidade
- critical (crítico): há ou pode haver usuário sem serviço agora. Aja logo.
- warning (aviso): precisa de atenção, mas não derruba nada sozinho. Olhe no mesmo dia útil.
Agrupamento e repetição
Avisos do mesmo alerta, serviço e tenant saem num e-mail só. O primeiro sai em 30 segundos; mudanças dentro de um grupo já avisado esperam 5 minutos; um problema que não some é lembrado a cada 12 horas. Para parar um alerta que você já está tratando, use Silence no e-mail.
O que fazer quando um alerta chega
- Leia o Risco e a severidade.
- Abra o View runbook e confirme no Grafana (seção "Como verificar"). Se o nginx estiver fora do ar, o Grafana não abre: veja Acessar o Grafana com o nginx fora do ar.
- Siga "Como agir". Se há sinal de ataque ou vazamento, vá direto para "Se for ataque ou incidente real".
- Quando acabar, o e-mail Resolved confirma. Se o problema volta, é sinal de que a causa não foi tratada.