# O momento em que um backup falha.

> Receba uma notificação push quando um backup falhar, além de um aviso diário confirmando que ele rodou. Adicione uma linha ao seu job de pg_dump, rsync ou restic e falhas silenciosas viram alertas.

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

Última atualização: 2026-10-17

Encadeie um alerta ao pg_dump, rsync, restic ou qualquer comando de backup. Uma falha envia uma notificação push para o seu celular no momento em que acontece, e um ping diário de sucesso confirma que o resto continua rodando.

## Três passos para ter tranquilidade com seus backups

1. **Pegue a CLI ou a chave** — Instale a CLI do Pocket Alert e rode pocketalert auth, ou pegue sua chave de API para uma chamada curl simples.
2. **Envolva seu backup** — Encadeie o pocketalert send ao seu comando de backup: || para falhas, && para sucesso.
3. **Durma tranquilo** — As falhas geram notificação push no momento em que acontecem. Os pings de sucesso confirmam que a tarefa continua rodando.

## Volte a confiar nos seus backups

Um backup que você nunca verifica é uma aposta. Transforme falhas silenciosas em alertas e comprove cada execução.

- **Detecte falhas silenciosas** — Um backup com falha envia uma notificação push para o seu celular no momento em que quebra, semanas antes de uma restauração vazia.
- **Confirme que rodou** — Um ping de sucesso em cada execução prova que a tarefa ainda funciona. Quando ele deixa de chegar, você sabe que ela parou.
- **Veja o motivo** — Envie o stderr para a mensagem. O alerta mostra o motivo da falha do pg_dump, do rsync ou do restic.
- **Qualquer ferramenta de backup** — pg_dump, mysqldump, rsync, restic, borg e tar disparam todos pelo código de saída.
- **Um canal que se encaixa** — Envie falhas e pings rotineiros de sucesso para aplicativos separados, para que os urgentes nunca se escondam no meio do ruído.
- **Uma linha para adicionar** — Uma linha encadeada ao script de backup que você já roda. Sem agente, sem painel e sem janela de manutenção.

## Proteja sua tarefa de backup

### Instale e autentique a CLI

```
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
```

### Alerte quando um dump de banco falhar

Encadeie com `||` para que o alerta dispare apenas com um código de saída diferente de zero:

```
pg_dump mydb | gzip > /backups/mydb.sql.gz || pocketalert send \
  -t "Backup failed: mydb" -m "pg_dump exited non-zero"
```

### restic, com as últimas linhas do log de erro

```
restic backup /data 2>/tmp/restic.err \
  && pocketalert send -t "Backup OK: data" -m "restic done $(date)" \
  || pocketalert send -t "Backup failed: data" -m "$(tail -n 3 /tmp/restic.err)"
```

### borg ou rsync, agendados no cron

```
0 3 * * * borg create /repo::'data-{now}' /data \
  && pocketalert send "Backup OK: data" "borg finished" \
  || pocketalert send "Backup failed: data" "borg exited non-zero"
```

### Sem CLI? Chame a API com curl

```
rsync -a /data /backup || curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Backup failed: rsync","message":"rsync exited non-zero","level":"critical"}'
```

A [documentação](https://info.pocketalert.app/getting-started.html) explica como direcionar a notificação para um aplicativo ou dispositivo específico.

## Perguntas frequentes

### Como receber alertas quando um backup falha?

Encadeie uma notificação ao seu comando de backup. Com `||`, uma falha envia uma notificação push para o seu celular na hora, dias antes da restauração que a revelaria.

### Dá para confirmar que um backup realmente rodou?

Sim, e é aí que está o valor real. Envie um ping de sucesso com `&&` em cada execução. Quando o "Backup OK" diário deixar de chegar, você sabe que a tarefa parou de funcionar em silêncio.

### Dá para ver o motivo da falha do backup?

Capture o stderr e coloque-o na mensagem. A CLI envia as últimas linhas do log de erro no alerta, para você ver por que o pg_dump ou o rsync falhou.

### Quais ferramentas de backup são suportadas?

Qualquer coisa que você automatize pode disparar um alerta pelo código de saída: pg_dump, mysqldump, rsync, restic, borg, Duplicati, tarefas com tar e scripts de snapshot de serviços gerenciados.

### Como evitar que os pings de sucesso sejam barulhentos?

Envie falhas e pings de sucesso para aplicativos diferentes. As falhas chegam em um canal que você acompanha de perto, enquanto o "Backup OK" diário fica em um canal silencioso e auditável.

### Um backup com falha consegue furar o modo Não perturbe?

Sim. Adicione `level=critical` no ramo de falha e o Android publica a notificação em um canal que ignora o modo Não perturbe, enquanto no iPhone ela aparece como notificação sensível ao tempo, que fura o Foco. Envie o "Backup OK" diário com `level=silent` e ele vai para o histórico sem som.
