# Saiba quando seu banco de dados para de responder.

> Receba uma notificação push quando seu banco de dados falhar. Perda de conexão no Postgres, MySQL ou Redis, atraso de replicação ou disco cheio chegam ao seu celular em menos de um segundo.

<!-- source: https://pocketalert.app/pt/use-cases/database-alerts -->

Última atualização: 2026-08-11

Uma verificação de saúde que falha, uma réplica atrasada, um disco se aproximando do limite. Seu monitoramento dispara um webhook para o Pocket Alert e o alerta chega no seu celular em menos de um segundo. Funciona com Postgres, MySQL, Redis e MongoDB, e não roda nenhum agente no host do banco de dados.

## Três passos para receber alertas de banco de dados no seu celular

1. **Crie um webhook ou chave** — Crie uma chave de API para um script cron, ou um webhook, e copie a URL de recebimento.
2. **Aponte o monitoramento para ela** — Adicione a URL de recebimento ao Grafana, Alertmanager ou pgwatch, ou use curl na API de mensagens a partir de um health check via cron.
3. **Receba o alerta** — Uma verificação que falha dispara o alerta e seu celular vibra em menos de um segundo. Use webhooks separados para o primário e as réplicas.

## Do gerenciador de alertas para o seu bolso

Seu monitoramento já sabe quando um banco de dados não está saudável. O Pocket Alert coloca essa informação no seu celular.

- **Todos os tipos de falha** — Conexão recusada, atraso de replicação acima do limite, WAL acumulando, disco quase cheio. Qualquer verificação que seu monitoramento execute pode disparar uma notificação push.
- **Funciona com a sua stack** — Grafana, Prometheus Alertmanager, pgwatch, Datadog e Zabbix fazem POST na URL do webhook que você já configura para outros alertas.
- **Severidade no título** — A queda de um primário e um aviso de atraso de réplica chegam como alertas distintos. O mapeamento GJSON lê a severidade do payload e a coloca no título.
- **Canais por banco de dados** — Cada banco de dados ganha seu próprio aplicativo, então produção, staging e a réplica de análise nunca dividem o mesmo canal.
- **Entrega em menos de um segundo** — As notificações chegam em bem menos de um segundo, rápido o suficiente para iniciar um failover antes que o pool de conexões se esgote.
- **Sem agente necessário** — Nada para instalar no host do banco. O monitoramento que você já roda faz todo o trabalho.

## Conecte o monitoramento do seu banco ao seu celular

### 1. Faça POST direto de um script de health check

Uma verificação com pg_isready ou uma consulta de consultas lentas/contagem de conexões em um script cron pode usar curl na API de mensagens com sua chave de API no header Token:

```
#!/usr/bin/env bash
# /usr/local/bin/pg-health.sh (run from cron)
if ! pg_isready -h prod-db -p 5432 -q; then
  curl -X POST "https://api.pocketalert.app/v1/messages" \
    -H "Token: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"title":"Postgres down","message":"prod-db: connection refused on 5432","level":"critical"}'
fi
```

O campo `"level":"critical"` faz esta notificação push atravessar o Não perturbe, então uma queda do primário às 3h da manhã realmente chega até você. A página sobre [alertas críticos](https://pocketalert.app/pt/use-cases/critical-alerts) explica como funcionam os níveis.

O mesmo padrão funciona para atraso de replicação ou um volume de dados cheio:

```
LAG=$(psql -tA -c "SELECT EXTRACT(EPOCH FROM (now() - pg_last_xact_replay_timestamp()))::int")
[ "$LAG" -gt 120 ] && curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"title\":\"Replication lag\",\"message\":\"replica-1 is ${LAG}s behind primary\"}"
```

### 2. Ou crie um webhook para o seu gerenciador de alertas

Crie um webhook com um template de `message` em GJSON que mapeia o payload das suas ferramentas. Grafana, Alertmanager, pgwatch, Datadog e Zabbix fazem POST do próprio JSON:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Alertmanager","message":"%alerts.0.labels.alertname%: %alerts.0.annotations.summary%","application_id":"qm47b9pzxzxg"}'
```

Cole a URL de recebimento `https://p4a.me/wh/1234abcd` no receptor de webhook do gerenciador de alertas. Uma verificação via cron também pode fazer POST de JSON simples para a mesma URL de recebimento.

A [documentação de configurações de webhook](https://info.pocketalert.app/api/webhooks/settings.html) cobre o mapeamento de campos GJSON e o roteamento por aplicativo.

## Perguntas frequentes

### Como receber uma notificação push quando meu banco cair?

Configure sua stack de monitoramento para fazer POST em um webhook do Pocket Alert quando uma verificação falhar. Grafana, Prometheus Alertmanager, pgwatch, Datadog e Zabbix suportam webhooks de saída, e um script de health check via cron pode usar curl na mesma URL.

### Quais bancos de dados são suportados?

Postgres, MySQL, Redis e MongoDB funcionam. O Pocket Alert lê o JSON que suas ferramentas enviam, então o motor do banco nunca importa. Se ele consegue disparar um webhook ou rodar um script de verificação, consegue chegar no seu celular.

### Consigo separar a queda do primário de um aviso de atraso?

Crie webhooks separados para o primário e para as réplicas, ou use um template GJSON que extrai a severidade do payload para o título. Assim, uma queda do primário e um aviso de atraso de réplica já se diferenciam assim que chegam.

### Como manter os alertas de produção e staging separados?

Dê a cada banco de dados seu próprio aplicativo e URL de webhook. Produção, staging e a réplica de análise chegam em canais separados, então um servidor de staging barulhento nunca abafa um incidente real em produção.

### Preciso instalar um agente no servidor do banco?

Não. O Pocket Alert não roda nenhum agente no host do banco de dados. Qualquer script de monitoramento ou health check que você já tenha dispara o webhook, e as notificações chegam em menos de um segundo.

### Um alerta de banco fora do ar pode me acordar de madrugada?

Sim. Envie com level=critical ou defina default_level como critical no webhook para que tudo que ele receber seja alto. No Android, o critical vai para um canal dedicado que ignora o Não perturbe depois que você conceder acesso ao DND, e pode tomar a tela. No iPhone, chega como uma notificação de horário sensível que atravessa o Foco. O plano gratuito entrega o critical como high, ainda instantâneo, só que sem o bypass do DND.
