Zum Inhalt springen

Benachrichtigungen

Nota kann dir sagen, wenn etwas beginnt, dich zu brauchen, und wenn es vorbei ist. Heute geht das über ntfy und Webhooks.

Ziele für Benachrichtigungen gehören zur Konfiguration. Ein Ziel ist ntfy oder webhook; min_status sagt, ab wann es Bescheid haben will (warn oder crit).

{
"notify": [
{"id": "phone", "type": "ntfy", "url": "https://ntfy.example.org/${NOTA_NTFY_TOPIC}", "token": "${NOTA_NTFY_TOKEN}", "min_status": "crit"},
{"id": "ops-hook", "type": "webhook", "url": "https://hooks.example.org/attention", "secret": "${NOTA_HOOK_SECRET}"}
]
}

${ENV_VAR} wird in Adressen, Geheimnissen und Schlüsseln ersetzt, sodass kein Geheimnis in der Datei stehen muss. Die Vorlage ist templates/conf.d/notify.json.example im Quelltext.

Was nur aus einem anderen Problem folgt, benachrichtigt niemanden: der ausgefallene Host schon, der Dienst darauf nicht.

Auf Wunsch schickt Nota einmal am Tag einen Satz: „Alles ruhig“ oder „2 Sachen brauchen dich“ — mit dem Wichtigsten, wie viele weitere daraus folgen und wie viele diese Woche fällig werden.

{
"digest": {"at": "07:30", "tz": "Europe/Berlin"}
}

Er geht an jedes Ziel, gleich welcher Stufe. Es ist die eine Nachricht, die auch sagt, dass alles in Ordnung ist.

Ausgehende Webhooks tragen zwei Header, damit der Empfänger prüfen kann, woher sie kommen:

  • X-Nota-Timestamp
  • X-Nota-Signature: sha256=hex(HMAC-SHA256(secret, "<timestamp>.<body>"))

Ein Core, der nicht läuft, kann nicht benachrichtigen. Eine zweite Sonde auf einem anderen Rechner kann den Core beobachten und selbst über ntfy oder einen Webhook Bescheid sagen, wenn sie ihn nicht erreicht.