Notificações

O roteador verifica a si mesmo a cada minuto (Alarmes e a tela 24/7). Com as notificações ligadas, o que mudou em uma verificação é enviado na hora: uma mensagem por verificação e por canal, com todos os alarmes disparados e limpos nela.

Canal	O que você precisa	Custo
E-mail	Um servidor SMTP: o do seu provedor de e-mail, ou o seu próprio	Grátis
Telegram	Um bot (do @BotFather) adicionado ao grupo do seu NOC	Grátis
WhatsApp	A WhatsApp Cloud API da Meta: um número comercial, um token e um template aprovado	Grátis até a cota mensal da Meta, depois por mensagem
SMS	Uma conta e um número da Twilio	Por mensagem

Configure tudo com dtvsol notify …, a API ou em Settings → Notifications no monitor. Senhas e tokens são armazenados criptografados no roteador e nunca mais são mostrados.

O que é enviado

• Alarmes críticos por padrão (acrescente avisos ou informativos com dtvsol notify level).
• Cada alteração que falhou no roteador (veja Alterações que falharam), seja qual for o seu nível.
• Quando um alarme é limpo, para que ninguém se desloque até um problema que já sumiu.

Os disparos e as limpezas de uma verificação vão juntos, no máximo 15 linhas, depois … and N more. Um canal envia no máximo 30 mensagens por hora; a 30ª avisa isso, e o resto daquela hora fica no monitor.

[DTVSOL router-1] CRITICAL: 1 alarm(s) raised, 1 cleared
CRITICAL: bond0 (uplink) is down
CLEARED: DHCP service is not running
https://XXX.XXX.XXX.10:8881/

Ligar as notificações

dtvsol notify on
dtvsol notify level critical warning       # which levels (critical only by default)
dtvsol notify link https://XXX.XXX.XXX.10:8881/   # the monitor, at the end of each message
dtvsol notify                               # the settings, and how the last message went

dtvsol notify changes off interrompe o envio das alterações que falharam, dtvsol notify clears off o das limpezas.

E-mail

dtvsol notify email to noc@your-isp.com,boss@your-isp.com
dtvsol notify email server smtp.your-isp.com 587 starttls
dtvsol notify email user alarms@your-isp.com
dtvsol notify email password               # asked for, not echoed
dtvsol notify email on
dtvsol notify test email

• security: starttls (porta 587, o usual), tls (porta 465) ou none (porta 25, um relay dentro da sua rede).
• from: o remetente (dtvsol notify email from …); o login, quando não definido.
• O Gmail e o Microsoft 365 exigem uma senha de app, não a senha da própria conta.

Telegram

1. No Telegram, fale com o @BotFather, envie /newbot e guarde o token que ele fornece.
2. Adicione o bot ao grupo do seu NOC e envie uma mensagem no grupo.
3. Descubra o chat id do grupo: abra https://api.telegram.org/bot<token>/getUpdates em um navegador e leia "chat":{"id":-100…} (um número negativo).

dtvsol notify telegram token               # asked for, not echoed
dtvsol notify telegram chat add -1001234567890
dtvsol notify telegram on
dtvsol notify test telegram

WhatsApp

O WhatsApp só permite que uma empresa inicie uma conversa com um template aprovado, então o roteador envia cada mensagem de alarme como o único parâmetro do seu template.

1. No Meta for Developers, crie um app com WhatsApp e adicione o número de telefone da sua empresa.

2. Em WhatsApp → API setup, anote o phone number ID (ID do número de telefone).

3. Crie um token permanente: nas configurações do Meta Business, um usuário do sistema com a permissão whatsapp_business_messaging.

4. No WhatsApp Manager, crie um template da categoria Utility, chamado dtvsol_alarm (ou outro nome), no seu idioma, com um corpo como:

   Router alarm: {{1}}

   Aguarde até que a Meta o aprove.

dtvsol notify whatsapp phone-id 123456789012345
dtvsol notify whatsapp token                        # asked for, not echoed
dtvsol notify whatsapp template dtvsol_alarm es     # the template's name and language
dtvsol notify whatsapp to add +573001234567
dtvsol notify whatsapp on
dtvsol notify test whatsapp

Os números são escritos com + e o código do país. Um parâmetro do WhatsApp é uma só linha, então as linhas do alarme são unidas com ·.

SMS (Twilio)

dtvsol notify sms sid ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
dtvsol notify sms token                   # the auth token, asked for, not echoed
dtvsol notify sms from +15005550006       # your Twilio number
dtvsol notify sms to add +573001234567
dtvsol notify sms on
dtvsol notify test sms

Um SMS leva os primeiros 480 caracteres da mensagem (até 3 SMS).

Quando um canal falha

Cada canal guarda como foi a sua última mensagem (dtvsol notify, e o monitor). Um canal cuja última mensagem falhou é ele mesmo um alarme, Alarm notifications by telegram fail: …, enviado pelos outros canais. Ele é limpo quando uma mensagem nesse canal volta a funcionar, por exemplo com dtvsol notify test telegram.

dtvsol notify telegram reset (ou Forget no monitor) remove as configurações de um canal, incluindo o seu token.

Seguro por projeto

• Tokens e senhas são selados com a chave do cofre (vault) do roteador, vinculada a esta máquina: uma cópia do banco de dados não os abre em outro lugar. Eles nunca são mostrados pela API, pela CLI ou pelo monitor.
• O roteador envia com o curl, com as suas configurações em um arquivo privado removido após cada mensagem: nenhum segredo aparece em uma linha de comando ou em uma lista de processos.
• Um servidor de e-mail lento nunca trava as verificações de alarme: as mensagens são enviadas à parte.