Feilsøking

Lokal utvikling

Cosmos DB Emulator-tilkobling feiler

• Sørg for at Cosmos DB Emulator kjører
• Sjekk at endepunktet i api/local.settings.json stemmer med emulatoren (standard: https://localhost:8081)
• Verifiser at emulatorsertifikatet er klarert
  • Windows: Emulatoren installerer sertifikatet automatisk
  • Mac/Linux: Eksporter og klarér sertifikatet manuelt

Magic links fungerer ikke

• Kontroller at RESEND_API_KEY og FROM_EMAIL er konfigurert for e-postlevering.
• Uten RESEND_API_KEY hoppes leveringen over, og API-et logger bare maskert informasjon om mottaker, emne og avsender. Innloggingslenken og verifiseringskoden vises ikke i loggen eller det vanlige API-svaret.
• For automatisert lokal testing bruker du bare den beskyttede E2E-testmodusen som er beskrevet i miljøvariabelreferansen. Den kan returnere devLink og devCode bare når sikkerhetskravene for localhost og ikke-produksjon er oppfylt.

Frontenden kan ikke koble til API-et

• Verifiser at API-et kjører på http://localhost:7071
• Sjekk proxy-konfigurasjonen i vite.config.ts
• Sørg for at api/local.settings.json har korrekte CORS-innstillinger

Databasecontainere finnes ikke

• Kjør oppsettskriptet: cd api && npx ts-node scripts/setup-database.ts
• Verifiser at alle containere ble opprettet i Cosmos DB Emulator Data Explorer

Produksjonsutrulling

Utrulling av Static Web App feiler

• Verifiser at GitHub Actions-arbeidsflyten har korrekt AZURE_STATIC_WEB_APPS_API_TOKEN-hemmelighet
• Sjekk at app_location, api_location og output_location er riktige
• Gjennomgå GitHub Actions-logger for byggfeil

API-funksjoner svarer ikke

• Sjekk Azure Function App-logger i Azure Portal
• Verifiser at miljøvariabler er satt i Function App Configuration
• Sørg for at Cosmos DB-brannmuren tillater Azure-tjenester

Autentisering fungerer ikke i produksjon

• Verifiser at miljøvariabelen FRONTEND_URL er satt til ditt produksjonsdomene
• Sjekk at JWT_SECRET er satt og er sikker
• Sørg for at RESEND_API_KEY og FROM_EMAIL er konfigurert
• Hvis en ny lenke vises som ugyldig eller utløpt, ber du om én ny e-post og tester den nyeste lenken eller koden én gang. Lenker og koder utløper etter 30 minutter og kan brukes én gang.
• Ikke lim inn en full lenke, kode, e-postadresse, autorisasjonshode eller forespørselskropp i logger, saker eller støttemeldinger.

Produksjonsovervåking

Et varsel ble utløst

1. Åpne Azure Monitor → Alerts, og gjennomgå det aktuelle tidsvinduet.
2. Kontroller feil og nylige forespørsler i Application Insights for samme periode.
3. Sammenlign starttidspunktet med nylige utrullinger eller en bølge av innlogging, bestillinger, invitasjoner eller kapasitetsaktivitet.
4. Registrer bare operasjonen, tidsperioden, alvorlighetsgraden og en renset feilkategori i en sak.

Grunnvarslene sender ikke e-post eller webhook-varsler fordi de ikke har handlingsgrupper.

Cosmos-aktivitet mangler under avhengigheter

Cosmos DB-tilgang som bruker Azure Functions-bindinger, vises kanskje ikke som avhengighetstelemetri. Bruk mislykkede forespørsler, Function-spor, applikasjonens feilhendelser og Cosmos DB-metrikker sammen. Ikke tolk en tom avhengighetsvisning som bevis på at ingen databasekall skjedde.

Inntaksvarselet ble utløst

• Se etter løkker med nye forsøk, gjentatte feil eller midlertidig feilsøkingslogging.
• Kontroller at inntaket er under grensen på 0,1 GB per dag etter at årsaken er fjernet.
• Husk at grensen kan gjøre telemetrien ufullstendig til den tilbakestilles. Telemetrisvikt stopper ikke applikasjonsflytene.

Hastighetsbegrensning

Får 429 Too Many Requests

• Vent 15 minutter til hastighetsbegrensningen tilbakestilles
• Begrensninger: 5 forespørsler per IP/e-post per 15 minutter
• Kontakt admin for å justere begrensningene ved behov

---

Se også: Lokal utvikling · Azure-utrulling · Miljøvariabler