Ir para o conteúdo
Promovaweb

Notificações de backup e de falha

A notificação do Databasus é a mensagem que o painel envia a um canal seu, como Slack, Discord, Telegram, Microsoft Teams, e-mail ou webhook, quando um backup ou uma verificação de restauração termina. Você escolhe por banco se o canal recebe o sucesso, a falha ou os dois, por isso um backup que falhou de madrugada chega ao grupo do Slack sem você abrir o painel para conferir.

Ficha e sumário da página

Referência técnica
Databasus 3.70.0
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. O aviso que o script de backup não tem
  2. Os canais disponíveis
  3. Como o notificador do Slack é montado
  4. Sucesso, falha e cansaço de aviso
  5. Segredos dos canais

O aviso que o script de backup não tem

O pg_dump não avisa nada, apenas termina com um código de saída. O resto fica com o script ao redor dele, que precisa conferir o código, montar a mensagem e chamar a API do Slack com curl. O script de exemplo da documentação oficial faz isso nas últimas linhas. Um erro nesse trecho deixa a falha do backup sem aviso até a próxima conferência manual.

No Databasus, o aviso é uma peça cadastrada no painel, o notificador. Depois de criar o notificador uma vez, com as credenciais do canal, você liga esse notificador aos bancos que ele acompanha. Cada banco escolhe os eventos que disparam a mensagem: o backup concluído, o backup com falha ou os dois. No formulário do backup lógico da versão 3.70.0, só o aviso de falha vem marcado. O backup físico acrescenta dois eventos próprios no código da mesma versão, a cadeia de backups quebrada e a falha na sequência do WAL. A verificação de restauração tem as próprias opções, também independentes.

Os canais disponíveis

A documentação oficial lista seis tipos de notificador. Cada um usa o mecanismo de entrega do próprio serviço, do bot do Telegram ao webhook do Microsoft Teams:

  • SlackMensagem num canal, enviada por um app do Slack com token de bot.
  • DiscordAviso postado num canal de um servidor do Discord.
  • TelegramMensagem entregue por um bot do Telegram.
  • Microsoft TeamsAviso num canal pelo webhook de um workflow do Teams.
  • E-mailMensagem para um endereço de e-mail a cada evento escolhido.
  • WebhookChamada HTTP para qualquer serviço, como um workflow do n8n.

O webhook é a saída para tudo que não está na lista. Um workflow do n8n, por exemplo, recebe a chamada e decide o destino: abrir um chamado, mandar uma mensagem no WhatsApp ou registrar a falha numa planilha. O Mattermost aparece como sétimo canal no README e no código da versão 3.70.0, embora a documentação de notificadores não o inclua.

Como o notificador do Slack é montado

O notificador do Slack mostra bem o que cada canal exige. A documentação oficial monta um app do Slack com permissões de bot, instala o app no workspace e copia duas informações para o Databasus, o token do bot e o ID do canal de destino:

Notificador Slack do Databasus

App no Slack

chat:write:
Envia mensagens aos canais.
channels:join:
Entra automaticamente num canal público na primeira mensagem.
groups:write:
Envia mensagens a canais privados.
im:write:
Envia mensagens diretas.
channels:history:
Lê o histórico do canal.

Notificador no Databasus

Bot Token:
O Bot User OAuth Token do app, que começa com xoxb-.
Target Channel ID:
O ID do canal de destino, que começa com C, G, D ou U.
Os campos e as permissões do notificador Slack, conforme a página Slack notifications da documentação oficial. A imagem mostra só os nomes, porque o token do bot é um segredo do seu workspace.

Num canal público, o bot entra automaticamente na primeira mensagem, graças à permissão channels:join. Num canal privado, você convida o bot pelo nome antes do primeiro aviso, porque sem o convite a mensagem não chega. O Microsoft Teams segue outro caminho: um workflow com o modelo de postagem por webhook gera um endereço HTTP POST, que é a única informação do notificador. Depois do cadastro, a documentação dos dois canais recomenda enviar uma mensagem de teste.

Sucesso, falha e cansaço de aviso

Um backup de hora em hora com aviso de sucesso gera 24 mensagens por dia num único banco. Com dez bancos, o canal recebe 240 mensagens diárias, no meio das quais o aviso de falha se perde. Para a verificação de restauração, a documentação registra que a maior parte das instalações liga só o aviso de falha. O mesmo raciocínio vale para o backup, com o canal recebendo apenas o que exige ação.

O aviso de sucesso ainda serve num canal separado ou para bancos de agenda diária ou semanal, quando a mensagem confirma que a rotina continua rodando. A verificação também usa os notificadores já ligados ao banco, com as opções de verificação concluída e de verificação com falha. Uma falha de verificação diz algo diferente da falha de backup: o arquivo existe no destino, mas a restauração de teste não terminou.

Segredos dos canais

O token do Slack, a URL do webhook do Teams e as credenciais dos outros canais ficam cifrados com AES-256-GCM no PostgreSQL interno do Databasus. A documentação de segurança inclui os webhooks com segredo entre os valores protegidos. Segundo o README do projeto, a API e o painel não devolvem esses valores depois do cadastro, nem em logs ou mensagens de erro.

Nas instalações com mais de um projeto, os espaços de trabalho agrupam bancos, destinos e notificadores. O canal do Slack de um cliente fica no espaço desse cliente. Cada membro vê só os espaços para os quais foi convidado. O panorama do sistema, com a agenda, os destinos e a verificação que alimentam esses avisos, está na página O que é o Databasus.

Continue na comunidade

Leve ao Discord da Promovaweb o erro do backup ou da restauração de teste. Com a versão do banco e o tipo de cópia, a comunidade pode comparar o caminho da recuperação.

Uma VPS para o seu Databasus

O Databasus pode rodar numa VPS da StayCloud com acesso aos seus bancos. Guarde uma cópia em armazenamento externo para recuperar o banco após a perda do disco dessa VPS.

Ver a VPS da StayCloud

Link de parceiro da Promovaweb.