Ga naar hoofdinhoud

Admin e-mail alerts (infra)

Platform-beheerders ontvangen HTML-e-mails bij ernstige serverproblemen. SMS (Twilio) is optioneel en niet vereist.

Configuratie

VariabeleVerplichtUitleg
ADMIN_ALERT_EMAILJa (voor e-mail)Ontvanger, bv. danny.verheyen@denys.com
MICROSOFT_SEND_MAILBOX + MICROSOFT_*AanbevolenVerzenden via Graph (zelfde als andere FieldOps-mail)
SMTP_HOST + MAIL_FROMAlternatiefAls Graph niet beschikbaar is
FIELDOPS_ALERT_MEMORY_MBNeeRSS-drempel geheugen-alert (default 3500)

Zet ADMIN_ALERT_EMAIL in GitHub Secrets (deploy workflow) en in .env.production op de VPS.

Export-worker en app-container hebben dezelfde mail-variabelen nodig (Graph of SMTP).

E-mailtemplates (soorten)

TemplateWanneerErnst
Onverwacht herstartApp herstart < 5 min na vorige startup (OOM/crash?)Kritiek
Geheugen kritiekRSS ≥ drempel (FIELDOPS_ALERT_MEMORY_MB); max. 1×/30 minKritiek
Export-worker herstartBij startup: stuck export-jobs gereset of failedWaarschuwing/kritiek
Export-jobs vrijgemaaktPeriodieke reclaim: jobs terug naar pendingWaarschuwing
Export-jobs definitief misluktNa max reclaim-pogingen (default 3×)Kritiek
Serverstatus roodGezondheidscheck detecteert kritieke combinatie; max. 1×/30 minKritiek

Elke mail bevat: titel, korte uitleg, feiten (server, tijdstip, aantallen), aanbevolen acties en link naar Monitor waar relevant.

Technisch

  • Templates: src/server/adminAlertTemplates.ts
  • Verzending: src/server/alertService.tssendNotificationMail() (Graph, fallback SMTP)
  • Triggers: server.ts (startup, geheugen, serverstatus), exportJobWorker.ts (export reclaim)

SMS blijft beschikbaar via Twilio-secrets maar is uitgeschakeld zolang Twilio-variabelen leeg zijn.