# Context pack: Feilsøking Source: https://nordvec.com/no/docs/guides/troubleshooting Pack: https://nordvec.com/no/docs/packs/troubleshooting This pack bundles one Nordvec guide with the guides it builds on and the guides it links to, in reading order, so an assistant reading it meets no reference it cannot follow. ## Contents 1. [Feil og ratelimiter](https://nordvec.com/no/docs/guides/errors-and-rate-limits) (builds on) 2. [Feilsøking](https://nordvec.com/no/docs/guides/troubleshooting) (this guide) 3. [Koble til en kobling på nytt](https://nordvec.com/no/docs/guides/troubleshooting/reconnect-integration) (linked from this guide) 4. [Gi manglende tillatelser](https://nordvec.com/no/docs/guides/troubleshooting/insufficient-scopes) (linked from this guide) 5. [Dokumentgrensen er nådd](https://nordvec.com/no/docs/guides/troubleshooting/document-limit) (linked from this guide) 6. [Daglig behandlingsgrense nådd](https://nordvec.com/no/docs/guides/troubleshooting/daily-processing-limit) (linked from this guide) --- # Feil og ratelimiter Source: https://nordvec.com/no/docs/guides/errors-and-rate-limits Den ene feilenveloppen som hvert mislykkede forespørsel returnerer, ratelimit-hodene, og hvordan du kan prøve en skriving på nytt på en trygg måte. Hvert endepunkt feiler på samme måte, så en klient håndterer feil, ratelimiter og omforsøk én gang og gjenbruker den koden overalt, inkludert over [MCP](/docs/guides/mcp). ## Feilkonvolutten [#feilkonvolutten] Hvert ikke-2xx-svar er ett JSON-objekt: ```json { "defined": false, "code": "TOO_MANY_REQUESTS", "message": "Too many requests", "data": { "reason": "rate_limit.exceeded", "retryAfterMs": 12000 } } ``` * `code` er HTTP-nivåfeilen, for eksempel `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `BAD_REQUEST` eller `TOO_MANY_REQUESTS`. * `data.reason`, når til stede, er en mer presis maskinlesbar årsak som `auth.key_not_found` eller `rate_limit.exceeded`. Forgrening baseres på denne i stedet for på `message`, som er for mennesker og kan endre seg. * `defined` er `true` når operasjonen lister den feilen i [API-referansen](/docs/api), og `false` for feil enhver forespørsel kan møte (autentisering, ratelimiter, en ukjent rute). * Et valideringsproblem svarer med `BAD_REQUEST` med problemene i `data.formErrors` og `data.fieldErrors`. Hvert svar inneholder også en `X-Request-ID`. Oppgi den når du kontakter support, så kan vi finne akkurat den forespørselen. ## Vanlige statuskoder [#vanlige-statuskoder] | Status | Kode | Hva du skal gjøre | | ------ | ----------------------- | ------------------------------------------------------------------------- | | `400` | `BAD_REQUEST` | Rett forespørselen; `data.fieldErrors` navngir feltene | | `401` | `UNAUTHORIZED` | Send en gyldig nøkkel eller sesjon | | `403` | `FORBIDDEN` | Nøkkelen mangler scopet eller rollen operasjonen trenger | | `404` | `NOT_FOUND` | Ressursen finnes ikke, eller du har ikke tilgang til å se den | | `409` | `CONFLICT` | En duplikat skriving er fortsatt under behandling; prøv igjen om kort tid | | `413` | `PAYLOAD_TOO_LARGE` | Forespørselsteksten er over 1 MB; del en bulk-push i mindre batcher | | `422` | `UNPROCESSABLE_CONTENT` | Forespørselen er velformet, men kan ikke utføres | | `429` | `TOO_MANY_REQUESTS` | Vent i `Retry-After`, så prøv igjen | ## Ratelimiter [#ratelimiter] Hvert svar oppgir grensen det ble telt mot, i to former: * `X-RateLimit-*`-headerne; * de IETF-strukturerte feltene `RateLimit` (live-tilstand: `r` er gjenværende forespørsler, `t` sekunder til vinduet nullstilles) og `RateLimit-Policy` (kvoten: `q` er grensen, `w` vinduet i sekunder). Et `429` inneholder også `Retry-After` i sekunder og `data.retryAfterMs`. Vent minst så lenge før neste forespørsel; å prøve igjen tidligere telles og avslås på nytt. ## Sikker omprøving av skriveoperasjoner [#sikker-omprøving-av-skriveoperasjoner] En skriveoperasjon som lister en `Idempotency-Key`-header i [API-referansen](/docs/api) kan prøves på nytt uten å utføre arbeidet to ganger. Send én nøkkel per logisk skriving og gjenta samme nøkkel ved hvert omforsøk: * samme nøkkel med samme kropp innen 24 timer spiller av det lagrede svaret; * samme nøkkel med ulik kropp avslås med `422`; * et duplikat som ankommer mens den første fortsatt kjører får `409`. En operasjon uten headeren er ikke idempotent, så prøv den bare på nytt når du vet at det første forsøket ikke ble gjennomført. --- # Feilsøking Source: https://nordvec.com/no/docs/guides/troubleshooting Løsninger for synkroniseringsfeilene og grenseverdiene for planen du kan støte på, hver starter fra meldingen du ser. Hver side starter med meldingen Nordvec viser deg, forklarer hvorfor den vises, og går gjennom løsningen. For feil som en API-forespørsel returnerer, se [Feil og ratebegrensninger](/docs/guides/errors-and-rate-limits). - [Koble til en kobling på nytt](https://nordvec.com/no/docs/guides/troubleshooting/reconnect-integration): Fiks synkroniseringsfeil som «autentiseringen har utløpt» og «tilgangen er trukket tilbake» ved å koble til den berørte koblingen på nytt. - [Gi manglende tillatelser](https://nordvec.com/no/docs/guides/troubleshooting/insufficient-scopes): Fiks synkroniseringsfeil med «manglende påkrevde tillatelser» ved å koble til koblingen på nytt og godkjenne alle forespurte tillatelser. - [Dokumentgrensen er nådd](https://nordvec.com/no/docs/guides/troubleshooting/document-limit): Hva skjer når dokumentgrensen i abonnementet ditt stopper synkroniseringen, og hvordan du kan frigjøre plass eller oppgradere for å fortsette. - [Daglig behandlingsgrense nådd](https://nordvec.com/no/docs/guides/troubleshooting/daily-processing-limit): Hva skjer når din arbeidsområdes daglige behandlingsgrense stopper synkroniseringen, og når den starter igjen. --- # Koble til en kobling på nytt Source: https://nordvec.com/no/docs/guides/troubleshooting/reconnect-integration Fiks synkroniseringsfeil som «autentiseringen har utløpt» og «tilgangen er trukket tilbake» ved å koble til den berørte koblingen på nytt. Når en synkronisering rapporterer **«Din autentisering har utløpt»** eller **«Din tilgang er blitt opphevet»**, kan ikke Nordvec lenger handle på dine vegne hos tilbyderen. Koblingen må fornyes. Å prøve synkroniseringen på nytt uten å koble til på nytt, hjelper ikke. ## Hvorfor dette skjer [#hvorfor-dette-skjer] * Tilbyderen har utløpt det langsiktige tilgangsbeviset som Nordvec har. Noen tilbydere gjør dette etter en fast tidsplan, andre etter en periode med inaktivitet. * Du har endret passordet ditt hos tilbyderen, noe som vanligvis opphever tilgangen for alle tilkoblede apper. * Du (eller en arbeidsområdeadministrator) har opphevet Nordvecs tilgang i tilbyderens innstillinger for tilkoblede apper eller sikkerhet. * Tilbyderen har endret sikkerhetspolitikken sin (for eksempel etter mistenkelig aktivitet på kontoen din) og ugyldiggjort eksisterende tilganger. ## Slik løser du det [#slik-løser-du-det] 1. Åpne **Connectors** i Nordvec. 2. Finn koblingen som er berørt. Den viser feiltilstanden som ble rapportert ved siste synkronisering, og en **Koble til på nytt**-knapp på kortet. 3. Velg **Koble til på nytt** og logg inn hos tilbyderen med **samme konto** som du opprinnelig koblet til. Godkjenn alle tillatelser som tilbyderen lister opp. Hvis du avslår én, får du en [feil om manglende tillatelser](/docs/guides/troubleshooting/insufficient-scopes) i stedet. Du kan også koble til på nytt fra koblingens detaljer når som helst, ikke bare etter en feil. Å koble til på nytt beholder alt som allerede er synkronisert. Ikke bruk **Koble fra** for å fikse en utløpt innlogging: å koble fra sletter permanent alle dokumenter som koblingen har synkronisert. Hvis du logger inn med en annen konto enn den koblingen ble satt opp med, nekter Nordvec å koble til på nytt og endrer ingenting. For å bytte konto, kobler du fra koblingen og kobler til den andre kontoen i stedet. ### Koblinger som ikke kan kobles til på nytt på plass [#koblinger-som-ikke-kan-kobles-til-på-nytt-på-plass] Guru, Notion, Zendesk, Freshdesk, Trello og e-conomic tilbyr ikke **Koble til på nytt**, fordi Nordvec ikke kan bekrefte at en ny innlogging tilhører samme konto. For disse må du koble fra koblingen og koble den til igjen. Å koble fra sletter dokumentene som er synkronisert, og neste synkronisering importerer dem på nytt fra starten. ## Hva skjer etter å ha koblet til på nytt [#hva-skjer-etter-å-ha-koblet-til-på-nytt] Den nye innloggingen erstatter den gamle, og feilen forsvinner. En synkronisering starter med en gang, og dokumenter som mislyktes mens koblingen var nede, blir forsøkt på nytt. Elementene som er oppført under **«Elementer som ikke kunne importeres»**, forsvinner etter hvert som de importeres vellykket. Koblinger er koblet per bruker: å koble til på nytt fornyer *din* kobling og påvirker ikke andres. Bare personen som koblet til en kobling, kan koble den til på nytt, og det gjelder også arbeidsområdeadministratorer: en administrator kan ikke koble til på nytt en kollegas kobling. --- # Gi manglende tillatelser Source: https://nordvec.com/no/docs/guides/troubleshooting/insufficient-scopes Fiks synkroniseringsfeil med «manglende påkrevde tillatelser» ved å koble til koblingen på nytt og godkjenne alle forespurte tillatelser. Når en synkronisering rapporterer **«Kontoen din mangler nødvendige tillatelser»**, fungerer koblingen til leverandøren, men den har fått færre tillatelser (OAuth-scope) enn koblingen trenger for å lese innholdet ditt. Dette er en egenskap ved selve tilgangen, så den eneste løsningen er å opprette koblingen på nytt med hele settet av tillatelser. ## Hvorfor dette skjer [#hvorfor-dette-skjer] * En tillatelse ble avslått under den opprinnelige tilkoblingsprosessen. Noen leverandører lar deg fjerne hake ved enkelte tillatelser på samtykkeskjermen. * Koblingen har fått en ny funksjon som krever en ekstra tillatelse, og den eldre tilgangen din er fra før dette. * En arbeidsområdeadministrator har begrenset hvilke tillatelser tredjepartsapper kan ha, eller leverandøren krever administratorgodkjenning for noen av dem. ## Slik løser du det [#slik-løser-du-det] 1. Åpne **Connectors** i Nordvec. 2. Finn den berørte koblingen og velg **Koble til på nytt** på kortet. 3. Logg på med samme konto som du opprinnelig koblet til, og godkjenn **alle** forespurte tillatelser på leverandørens samtykkeskjerm. Hver tillatelse tilsvarer et konkret behov, vanligvis lesing av dokumentene, filene eller meldingene som koblingen synkroniserer. Det finnes ingen valgfrie tillatelser i listen. Å koble til på nytt beholder dokumentene som allerede er synkronisert. Guru, Notion, Zendesk, Freshdesk, Trello og e-conomic kan ikke kobles til på nytt på plass. For disse må du koble fra og koble til igjen, noe som sletter de synkroniserte dokumentene og importerer dem på nytt fra starten. Hvis samtykkeskjermen sier at en administrator må godkjenne appen, videresender du forespørselen til arbeidsområdeadministratoren din. Leverandører med administratorgodkjenningsflyter (for eksempel Google Workspace- og Microsoft 365-organisasjoner, eller Slack-arbeidsområder med app-godkjenning) blokkerer tilgangen inntil en administrator godkjenner den. Å koble til på nytt før godkjenningen vil gi samme feil. ## Hva skjer etter å ha koblet til på nytt [#hva-skjer-etter-å-ha-koblet-til-på-nytt] Den nye tilgangen erstatter den gamle, feilen forsvinner, og en synkronisering starter umiddelbart. Elementer som tidligere feilet på grunn av tillatelsesfeil, blir forsøkt på nytt. --- # Dokumentgrensen er nådd Source: https://nordvec.com/no/docs/guides/troubleshooting/document-limit Hva skjer når dokumentgrensen i abonnementet ditt stopper synkroniseringen, og hvordan du kan frigjøre plass eller oppgradere for å fortsette. Når en synkronisering rapporterer **«Du har nådd dokumentgrensen for abonnementet ditt»**, er koblingen frisk og ingenting har feilet hos tilbyderen. Korpuset ditt har ganske enkelt nådd det maksimale antallet dokumenter abonnementet ditt tillater, så importen ble satt på pause i stedet for å fjerne innhold stille. ## Hva grensen omfatter [#hva-grensen-omfatter] Grensen teller dokumenter lagret i korpuset ditt på tvers av alle kilder: synkroniseringer fra koblinger, opplastinger og dokumenter sendt via API-en. Den finnes for å holde indekserings- og søkekostnader forutsigbare. Det er en kvote per arbeidsområde, ikke per kobling. ## Slik fortsetter du synkroniseringen [#slik-fortsetter-du-synkroniseringen] Gjør ett av følgende: * **Frigjør plass.** Slett dokumenter du ikke lenger trenger, eller koble fra en kilde hvis innholdet ikke skal indekseres. Når du sletter et dokument, fjernes det fra indeksen umiddelbart. * **Oppgrader abonnementet eller legg til lisenser.** Kvoten er satt per lisens, og høyere abonnementer tillater flere dokumenter per lisens. Etterpå trenger du ikke å starte på nytt manuelt: Den neste planlagte synkroniseringen oppdager den frigjorte kapasiteten og fortsetter der den slapp. Du kan også utløse en synkronisering manuelt fra koblingens kort når det er ledig plass. ## Hva skjer med dokumenter som ikke fikk plass [#hva-skjer-med-dokumenter-som-ikke-fikk-plass] Ingenting går tapt hos kilden; tilbyderen forblir systemet for registrering. Dokumenter som ikke kunne importeres, blir hentet inn av neste vellykkede synkronisering når det er kapasitet tilgjengelig. --- # Daglig behandlingsgrense nådd Source: https://nordvec.com/no/docs/guides/troubleshooting/daily-processing-limit Hva skjer når din arbeidsområdes daglige behandlingsgrense stopper synkroniseringen, og når den starter igjen. Når en synkronisering rapporterer **«Ditt arbeidsområde har nådd dagens behandlingsgrense»**, er koblingen frisk og ingenting feilet hos leverandøren. Arbeidsområdet ditt har behandlet så mye nytt innhold på én dag som grensen tillater, så importen ble satt på pause i stedet for å fortsette å avvise element for element. ## Hva grensen dekker [#hva-grensen-dekker] Grensen teller innholdet som behandles for indeksering på tvers av alle kilder (koblingssynkroniseringer, opplastinger, dokumenter sendt via API) i ett kalenderdøgn, målt i UTC. Den eksisterer for å hindre at en første synkronisering av en stor kilde kjører ubegrenset på én dag. Uendret innhold telles aldri igjen, så etter den første importen kommer et arbeidsområde sjelden i nærheten av grensen. Grensen er en tillatelse per arbeidsområde som skalerer med antall seter, og hvert medlem kan bruke en andel av den per dag. Dermed kan ikke én persons store import bruke opp hele arbeidsområdets kvote. ## Hvordan synkroniseringen gjenopptas [#hvordan-synkroniseringen-gjenopptas] Ingenting å gjøre. Koblingen er planlagt til å kjøre igjen etter midnatt UTC, når dagens kvote nullstilles, og den fortsetter der den stoppet. Statusmeldingen fjernes ved denne kjøringen. Du kan også utløse en synkronisering manuelt fra koblingens kort. Den vil fortsette der den forrige stoppet så snart kvoten er tilgjengelig. ## Hva skjer med innhold som ikke ble behandlet [#hva-skjer-med-innhold-som-ikke-ble-behandlet] Ingenting går tapt hos kilden; leverandøren forblir systemet for registrering. Elementer som ikke kunne behandles i dag, blir hentet inn ved neste kjøring.