# Monitoring Setup Plan — frontend-shell ## Context - **What runs**: a static site (no back-end), deployed to test (Raspberry Pi, nginx) and later production (IIS webhost). See [deployment-plan.md](../deployment/deployment-plan.md). - **Current state**: no monitoring in this project. Errors only go to the browser console (`ErrorPage`, BR-ERR-03). - **Existing stack in your other projects** (SlpSoftware `react-frontend`, SlpModularCms): - **Sentry** (free tier): JavaScript errors - **Umami**, self-hosted on the Pi: visitor statistics without cookies - **UptimeRobot**: is the site reachable - **Already decided** (no question needed): - **One build for both environments stays.** Test vs production (for example for Sentry or Umami) is determined in the browser from the hostname, not with a separate build. The pipeline keeps deploying exactly the same build that was tested. - **External monitoring services need CSP exceptions.** The current CSP only allows the site's own origin. Each external service you choose is added to `config/securityHeaders.ts`, and from there to `web.config` and the nginx config, as narrowly as possible (only that host, only the directive that needs it). - **Privacy statement.** Whatever measures visitors must later be mentioned there. The page is still a placeholder, so this becomes an action item for that page. ## Plan - [x] 1. Answer the questions below - [x] 2. Analyze answers (follow-up questions if needed) - [x] 3. Generate `operations/monitoring/monitoring-plan.md` - [x] 4. Generate `operations/monitoring/monitoring-setup.md` (and, if needed, code and config changes on this PR after your approval) - [ ] 5. Update CSP, server config, tests and privacy action items for the chosen services --- ## Questions Vul per vraag de letter in na `[Answer]:`. Past geen enkele optie, kies dan de laatste (Anders) en licht toe. Waar ik een voorkeur heb staat **(aanbevolen)**. ### Vraag 1: Monitoring opzetten voor deze feature? A) Ja, help me monitoring op te zetten B) Nee, dit sluit aan op bestaande monitoring of valt nu buiten de scope C) Weet ik niet, stel een aanpak voor en ik beslis X) Anders (beschrijf hieronder na de [Answer]:-tag) [Answer]: A ### Vraag 2: Welke vormen van monitoring? A) Logging: JavaScript-fouten bij bezoekers vastleggen B) Meldingen: een bericht als de site plat ligt of er fouten optreden C) Dashboards: bezoekersstatistieken en een overzicht van de beschikbaarheid D) Een combinatie, namelijk alle drie, net als je andere projecten **(aanbevolen)** X) Anders (beschrijf hieronder na de [Answer]:-tag) [Answer]: D ### Vraag 3: Bestaande diensten hergebruiken? A) Ja: hetzelfde Sentry-account (een nieuw project of een eigen omgeving), dezelfde Umami-installatie op de Pi (nieuwe "websites" voor test en productie) en hetzelfde UptimeRobot-account (nieuwe monitors) **(aanbevolen)** Eén plek om alles te bekijken, geen extra kosten. B) Aparte, nieuwe accounts of installaties voor deze site X) Anders (beschrijf hieronder na de [Answer]:-tag) [Answer]: A ### Vraag 4: Hoe komen JavaScript-fouten bij Sentry? De site is statisch. In SlpSoftware loopt Sentry via een eigen doorgeefluik ("tunnel") langs adblockers, maar daarvoor is een server-onderdeel nodig. Bij de webhoster draait alleen IIS met statische bestanden, tot de .NET API er is. A) Nu rechtstreeks naar Sentry. De CSP krijgt alleen het ingest-adres van Sentry erbij (`connect-src`). Een deel van de fouten mist bij bezoekers met een adblocker. De tunnel komt later via de .NET API. **(aanbevolen)** B) Nog geen Sentry. Fouten alleen in de browserconsole, Sentry pas met de API. X) Anders (beschrijf hieronder na de [Answer]:-tag) [Answer]: A ### Vraag 5: Bezoekersstatistieken met Umami Umami gebruikt geen cookies en slaat geen persoonsgegevens op. Daarmee is volgens de Autoriteit Persoonsgegevens meestal geen cookiebanner nodig, mits het zo ingesteld is. A) Ja, met de bestaande Umami op de Pi. Aparte "websites" voor test en productie, zodat testverkeer niet in de echte cijfers komt. De CSP krijgt het Umami-adres erbij (`script-src` en `connect-src`). **(aanbevolen)** B) Alleen voor productie, niet voor test C) Nog geen statistieken X) Anders (beschrijf hieronder na de [Answer]:-tag) [Answer]: A ### Vraag 6: Beschikbaarheid bewaken met UptimeRobot A) Monitors op test nu, en op productie zodra de DNS omgezet is. Ze controleren de homepage en een deep link (`/portfolio`, om de SPA-fallback te testen). **(aanbevolen)** B) Alleen productie, na de livegang C) Geen beschikbaarheidsbewaking X) Anders (beschrijf hieronder na de [Answer]:-tag) [Answer]: A, maar gezien er nu ook al een site draait kan ik die nu ook al opzetten voor productie. Voor UptimeRobot hoeven we verder geen code toe te voegen toch? ### Vraag 7: Meldingen A) E-mail van UptimeRobot als de site plat ligt, en e-mail van Sentry bij een nieuw soort fout (hun standaardmeldingen) **(aanbevolen)** B) Alleen bij een storing (UptimeRobot), niet bij fouten C) Geen meldingen, ik kijk zelf in de dashboards D) Een ander kanaal (bv. Telegram, ntfy, Teams); beschrijf welk na de [Answer]:-tag X) Anders (beschrijf hieronder na de [Answer]:-tag) [Answer]: A