Gå til innhold

Feilsøking⚓︎

Logger⚓︎

Kai bruker strukturert logging med ILogger. Viktige logg-egenskaper:

  • Saksnummer — Saksnummer for korrelasjon
  • ConversationId — Teams-samtale-ID
  • RequestId — Forespørsels-ID for rate limiting-kø

Logger finnes i Application Insights under App Service-ressursen.

Vanlige feil⚓︎

QueueWorker prosesserer ikke jobber⚓︎

Symptom: Analyser forblir i køen, brukeren får ikke svar.

Sjekkliste:

  1. Sjekk om _isRunning-flagget henger — worker prosesserer kun én jobb om gangen
  2. Sjekk visibility timeout (5 min) — meldinger er usynlige mens de prosesseres
  3. Se etter feil i Application Insights: QueueWorker eller JobProcessor

Ingen retry

Feilede meldinger slettes alltid fra køen. Sjekk loggene for feilmelding sendt tilbake til bruker.

Dokumentsøk returnerer ingen resultater⚓︎

Symptom: Analysen feiler med "Ingen dokumenter funnet".

Sjekkliste:

  1. Sjekk at indexeren har kjørt — det er en ventetid etter opplasting (maks 1 min)
  2. JobProcessor prøver opptil 5 ganger med 2s delay
  3. Verifiser at dokumenter er lastet opp til riktig blob-path
  4. Sjekk Azure AI Search indexer-status i Azure Portal

Autentiseringsfeil⚓︎

Symptom: 401 Unauthorized på /api/messages.

Sjekkliste:

  1. Sjekk hvilket JWT-skjema som avviser — se OnAuthenticationFailed-logg
  2. For ABS-tokens: Verifiser at Bot Service-konfigurasjonen peker til riktig endepunkt
  3. For Entra ID-tokens: Sjekk Audiences og TenantId i TokenValidation-konfigurasjon
  4. ClockSkew er 5 minutter — sjekk klokkeavvik mellom systemer

Azure Content Understanding henger på dokument⚓︎

Symptom: Kai henger uten svar, ingen feilmelding. Analysen starter men fullfører aldri. Azure Content Understanding timeout i loggene.

Årsak: Dokumentet er ikke en ekte PDF — det er en skjermdump av en PDF-visning skrevet ut til PDF via «Print til PDF». Hver side består av hundrevis av bittesmå JPEG-bildebiter (37–53 bilder per side er typisk). Azure Content Understanding finner ingen tekst, bytter til OCR-modus og henger på å prosessere alle bildebitene.

Slik gjenkjenner du det:

Signal Betyr
Producer: Microsoft: Print To PDF i PDF-metadata Lagret via Windows Print to PDF
Sidetopp med PDF.js viewer eller file:///C:/Users/.../AppData/Local/Temp/... Skrevet ut fra nettleservisning
Ingen ekte tekst — bare sidetopp/bunn fra nettleseren Alt innhold er låst inne i bildebiter

Løsning: Be avsender om å eksportere PDF-en på nytt fra kildesystemet:

Slik fikser avsender det

  1. Foretrukket: Åpne originaldokumentet i Acrobat eller faktureringssystemet og bruk Fil → Lagre som PDF (ikke Skriv ut)
  2. Kun nettleser tilgjengelig: Bruk Ctrl+S → «Lagre som PDF» i Chrome/Edge — ikke Skriv ut → Print til PDF

Unngå

Fil → Skriv ut → Microsoft Print to PDF produserer alltid bilde-PDF-er som bryter AI-dokumentprosessering.

Mimir/Databricks timeout⚓︎

Symptom: Saksdata lastes ikke, timeout etter 15 sekunder.

Sjekkliste:

  1. Refit-klienten har 15s timeout — store spørringer kan overstige dette
  2. Sjekk at NAT Gateway er oppe (Databricks krever fast IP)
  3. Verifiser DefaultAzureCredential — Databricks-token kan ha utløpt
  4. Sjekk Databricks SQL Warehouse status (må være aktiv)

Cache-problemer⚓︎

Symptom: Analyse kjøres på nytt selv om den allerede er kjørt.

Sjekkliste:

  1. Cache-nøkkel er {saksnummer}-{journalPostId} — ny journalpost = ny cache
  2. Cache-feil logger men kaster ikke unntak (sjekk logger for QueryCacheService)
  3. Verifiser at Table Storage og Blob Storage er tilgjengelige

Nyttige spørringer (Application Insights / KQL)⚓︎

Finn feilede analysejobber
Text Only
1
2
3
traces
| where message contains "Sluttrapport generering feilet"
| order by timestamp desc
Sjekk cache-treff
Text Only
1
2
3
traces
| where message contains "CACHE HIT" or message contains "Cache miss"
| order by timestamp desc
Rate limiting-status
Text Only
1
2
3
traces
| where message contains "Token bucket refilled" or message contains "Insufficient tokens"
| order by timestamp desc