# Canari.me — Alerting Webhook Integration (vorbereitet)

**Stand:** 2026-04-16
**Status:** Vorbereitet, noch nicht aktiv. Wartet auf canari.me Launch.

## Uebersicht

[canari.me](https://canari.me) ist ein eigener Alerting-Dienst der als zusaetzlicher Webhook-Kanal neben Slack integriert werden soll. Die Integration ist im Script vorbereitet — sobald die URL gesetzt wird, werden Alerts automatisch auch an canari.me gesendet.

## Konfiguration

**Variable:** `ALERT_WEBHOOK_CANARI` in `/etc/environment` auf allen 5 Servern.

```bash
# Wenn canari.me verfuegbar ist, URL eintragen:
echo 'ALERT_WEBHOOK_CANARI="https://api.canari.me/webhooks/..."' >> /etc/environment

# An alle Server verteilen:
for ip in 10.0.0.3 10.0.0.4 10.0.0.5 10.0.0.6; do
  ssh root@$ip 'echo "ALERT_WEBHOOK_CANARI=\"https://api.canari.me/webhooks/...\"" >> /etc/environment'
done
```

**Wenn die Variable leer oder nicht gesetzt ist, wird canari.me uebersprungen.** Kein Fehler, kein Log-Eintrag.

## Payload-Format

```json
{
  "severity": "critical",
  "message": "QUORUM REACHED: Cert-Server-0-FSN confirmed down by 3/3 servers",
  "server": "Cert-Server-1-NBG",
  "timestamp": "2026-04-16T12:34:56Z"
}
```

Wird als `POST` mit `Content-Type: application/json` gesendet. Timeout: 5 Sekunden. Bei Fehler: silent fail (kein Retry, kein Absturz).

## Selbe Events wie Slack

Alle Events die an Slack gehen, gehen auch an canari.me (siehe [SLACK.md](SLACK.md) fuer die Event-Liste). Kein Severity-Filtering — alle Levels (critical, warning, info) werden gesendet.

## TODO bei canari.me Launch

1. Account erstellen / Webhook-Endpoint erhalten
2. URL in `/etc/environment` eintragen (alle 5 Server)
3. Testen: `curl -s -X POST "$ALERT_WEBHOOK_CANARI" -H "Content-Type: application/json" -d '{"severity":"info","message":"test"}'`
4. Payload-Format mit canari.me API abgleichen und ggf. `send_alert()` anpassen
5. `docs/CANARI-ME.md` und `docs/BACKLOG.md` aktualisieren