Files
SluijsensandClaude Opus 5.5 0bfe50e723
Continuous Integration / check (pull_request) Successful in 6m2s
Continuous Integration / deploy-test (pull_request) Skipped
Continuous Integration / deploy-production (pull_request) Canceled after 0s
Continuous Integration / lighthouse (pull_request) Canceled after 12m29s
Adds the monitoring plan and setup for the front-end shell
Monitoring reuses the existing Sentry organisation, the self-hosted
Umami instance and UptimeRobot, with e-mail alerts. One build serves
both environments; the browser picks test or production from the
hostname and sends nothing on other hosts. Sentry captures errors only,
loads after the page and stores no personal data. Code changes follow
after approval.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 11:49:35 +02:00

5.1 KiB

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.
  • 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

  • 1. Answer the questions below
  • 2. Analyze answers (follow-up questions if needed)
  • 3. Generate operations/monitoring/monitoring-plan.md
  • 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)

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)

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)

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)

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)

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)