# Integratie health monitoring
Wij draaien een automatische cron-job elke 5 minuten die test of onze externe koppelingen (Vecozo, Vektis, Zorgdomein) bereikbaar zijn. Bij falen ontvangt de superadmin direct een e-mail.
## Dashboard
Ga naar /beheer/integrations. Per integratie ziet u:
- Status badge: healthy (groen) / degraded (geel) / down (rood) / unknown (grijs)
- Uptime 24h: percentage geslaagde checks afgelopen 24 uur
- Checks 24h: totaal aantal uitgevoerde checks
- Consecutive fails: aantal opeenvolgende mislukte calls
- Interval, threshold, alert email: per integratie aanpasbaar
- Snooze knoppen: 1u / 6u / 24u stil tijdens onderhoud
- Test nu: handmatige check, direct resultaat
- Recent checks: laatste 50 calls met HTTP-code, fase, duration, error
## Wat wordt elke 5 min getest
| Integratie | Test |
|---|---|
| Vecozo | mTLS handshake naar api.vecozo.nl + statuscode check |
| Vektis | GET /v3/zorgsoorten/zorgverlener met token + mTLS — verwacht HTTP 200 |
| Zorgdomein | Config check (volledige ping vereist tenant-context) |
## Email-alerts
- Down-alert: na X opeenvolgende fails (default 2) — voorkomt false positives bij netwerk-hapertjes
- Recovery-alert: zodra integratie weer healthy is
- Geen spam: niet elke 5 min een mail terwijl het nog down is — alleen bij transitions
Mailadres komt uit:
1. Per-integratie override (instelbaar in dashboard)
2. Default: INTEGRATION_ALERT_EMAIL env-var
## Snooze
Voor maintenance windows of bekende incidents:
- 1u snooze: tijdens korte ingreep
- 6u snooze: bij Vecozo onderhoud (eerste maandag van maand)
- 24u snooze: bij langere upgrade
Snooze gestopt door op "Stop snooze" te klikken. Tijdens snooze loopt monitoring door, alleen mails blijven uit.
## Nieuwe integratie toevoegen
Eén plek voor superadmin: src/lib/integration-checks.ts → voeg entry toe aan INTEGRATIONS array. Cron + dashboard pikken het automatisch op.
## Vereisten
SMTP_*env vars (al gezet — gebruikt voor alle EPD e-mails)INTEGRATION_ALERT_EMAILenv-var (de superadmin's mail)CRON_SECRETenv-var (al gezet voor andere crons)