# Context pack: Fejlfinding

Source: https://nordvec.com/da/docs/guides/troubleshooting
Pack: https://nordvec.com/da/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. [Fejl og hastighedsgrænser](https://nordvec.com/da/docs/guides/errors-and-rate-limits) (builds on)
2. [Fejlfinding](https://nordvec.com/da/docs/guides/troubleshooting) (this guide)
3. [Genforbind en connector](https://nordvec.com/da/docs/guides/troubleshooting/reconnect-integration) (linked from this guide)
4. [Giv manglende tilladelser](https://nordvec.com/da/docs/guides/troubleshooting/insufficient-scopes) (linked from this guide)
5. [Dokumentgrænse nået](https://nordvec.com/da/docs/guides/troubleshooting/document-limit) (linked from this guide)
6. [Dagligt behandlingsloft nået](https://nordvec.com/da/docs/guides/troubleshooting/daily-processing-limit) (linked from this guide)

---

# Fejl og hastighedsgrænser
Source: https://nordvec.com/da/docs/guides/errors-and-rate-limits

Den ene fejlkuvert, som hvert fejlslagent request returnerer, hastighedsgrænse-headers og hvordan du genforsøger en skrivning sikkert.



Hvert endpoint fejler på samme måde, så en klient håndterer fejl, rategrænser og genforsøg én gang og genbruger den kode overalt, herunder over [MCP](/docs/guides/mcp).

## Fejlkapslen [#fejlkapslen]

Ethvert ikke-2xx-svar er ét JSON-objekt:

```json
{
  "defined": false,
  "code": "TOO_MANY_REQUESTS",
  "message": "Too many requests",
  "data": { "reason": "rate_limit.exceeded", "retryAfterMs": 12000 }
}
```

* `code` er fejlen på HTTP-niveau, for eksempel `UNAUTHORIZED`, `FORBIDDEN`,
  `NOT_FOUND`, `BAD_REQUEST` eller `TOO_MANY_REQUESTS`.
* `data.reason`, når den er til stede, er en mere præcis maskinlæsbar årsag som
  `auth.key_not_found` eller `rate_limit.exceeded`. Forgrén på den i stedet for på
  `message`, som er til mennesker og kan ændre sig.
* `defined` er `true`, når operationen oplister den fejl i
  [API-referencen](/docs/api), og `false` for fejl, som enhver anmodning kan møde
  (autentificering, rategrænser, en ukendt rute).
* Et valideringsfejl svarer med `BAD_REQUEST` og problemerne i
  `data.formErrors` og `data.fieldErrors`.

Hvert svar indeholder også et `X-Request-ID`. Citér det, når du kontakter
support, så kan vi finde den præcise anmodning.

## Almindelige statuskoder [#almindelige-statuskoder]

| Status | Kode                    | Hvad du skal gøre                                                 |
| ------ | ----------------------- | ----------------------------------------------------------------- |
| `400`  | `BAD_REQUEST`           | Ret anmodningen; `data.fieldErrors` angiver felterne              |
| `401`  | `UNAUTHORIZED`          | Send en gyldig nøgle eller session                                |
| `403`  | `FORBIDDEN`             | Nøglen mangler det scope eller den rolle, som operationen kræver  |
| `404`  | `NOT_FOUND`             | Ressourcen findes ikke, eller du har ikke adgang til at se den    |
| `409`  | `CONFLICT`              | En duplikat-skrivning er stadig i gang; prøv igen om kort tid     |
| `413`  | `PAYLOAD_TOO_LARGE`     | Anmodningsbrød er over 1 MB; del en bulk-push op i mindre batches |
| `422`  | `UNPROCESSABLE_CONTENT` | Anmodningen er velformet, men kan ikke anvendes                   |
| `429`  | `TOO_MANY_REQUESTS`     | Vent i `Retry-After`, og prøv derefter igen                       |

## Rategrænser [#rategrænser]

Hvert svar angiver den grænse, som det blev talt op imod, i to former:

* `X-RateLimit-*`-headere;
* de IETF-strukturerede felter `RateLimit` (live-tilstand: `r` er de resterende anmodninger,
  `t` er sekunderne, indtil vinduet nulstilles) og `RateLimit-Policy`
  (kvotaen: `q` er grænsen, `w` er vinduet i sekunder).

Et `429` medfører også `Retry-After` i sekunder og `data.retryAfterMs`. Vent mindst så længe,
før du sender den næste anmodning; et tidligere genforsøg tælles med og
afvises igen.

## Sikker genafsendelse af skrivninger [#sikker-genafsendelse-af-skrivninger]

En skrivningsoperation, der oplister en `Idempotency-Key`-header i
[API-referencen](/docs/api), kan genafsendes uden at udføre arbejdet to gange. Send
én nøgle per logisk skrivning, og gentag den samme nøgle ved hvert genforsøg:

* den samme nøgle med det samme brød inden for 24 timer afspiller det gemte svar;
* den samme nøgle med et andet brød afvises med `422`;
* en duplikat, der ankommer, mens den første stadig kører, får `409`.

En operation uden headeren er ikke idempotent, så genafsend den kun, når du
ved, at det første forsøg ikke blev gennemført.


---

# Fejlfinding
Source: https://nordvec.com/da/docs/guides/troubleshooting

Løsninger på de synkroniseringsfejl og planbegrænsninger, du kan støde på, hver startende med den besked, du ser.



Hver side starter med den meddelelse, Nordvec viser dig, forklarer hvorfor den vises, og gennemgår løsningen. Hvis der er tale om fejl, som en API-forespørgsel returnerer, kan du se [Fejl og hastighedsgrænser](/docs/guides/errors-and-rate-limits).

- [Genforbind en connector](https://nordvec.com/da/docs/guides/troubleshooting/reconnect-integration): Løs synkroniseringsfejl som "godkendelsen er udløbet" og "adgangen er blevet tilbagekaldt" ved at genforbinde den berørte connector.
- [Giv manglende tilladelser](https://nordvec.com/da/docs/guides/troubleshooting/insufficient-scopes): Løs synkroniseringsfejl med "manglende påkrævede tilladelser" ved at genoprette forbindelsen til connectoren og godkende alle anmodede tilladelser.
- [Dokumentgrænse nået](https://nordvec.com/da/docs/guides/troubleshooting/document-limit): Hvad sker der, når din plans dokumentgrænse sætter synkroniseringen på pause, og hvordan du frigør plads eller opgraderer for at genoptage.
- [Dagligt behandlingsloft nået](https://nordvec.com/da/docs/guides/troubleshooting/daily-processing-limit): Hvad sker der, når dit arbejdsområdes daglige behandlingsloft sætter synkroniseringen på pause, og hvornår den genoptages.


---

# Genforbind en connector
Source: https://nordvec.com/da/docs/guides/troubleshooting/reconnect-integration

Løs synkroniseringsfejl som "godkendelsen er udløbet" og "adgangen er blevet tilbagekaldt" ved at genforbinde den berørte connector.



Når en synkronisering rapporterer **"Din autentificering er udløbet"** eller **"Din adgang er blevet tilbagekaldt"**, kan Nordvec ikke længere handle på dine vegne hos udbyderen. Forbindelsen skal fornyes; at forsøge synkroniseringen igen uden at genoprette forbindelsen vil ikke hjælpe.

## Hvorfor dette sker [#hvorfor-dette-sker]

* Udbydere har udløbet det langvarige token, som Nordvec har. Nogle udbydere gør dette efter en fast tidsplan, andre efter en periode uden aktivitet.
* Du har ændret din adgangskode hos udbyderen, hvilket ofte tilbagekalder adgangen for alle tilsluttede apps.
* Du (eller en admin for arbejdsområdet) har tilbagekaldt Nordvecs adgang via udbyderens indstillinger for tilsluttede apps eller sikkerhed.
* Udbyderen har ændret sin sikkerhedspolitik, for eksempel efter mistænkelig aktivitet på din konto, og har gjort eksisterende tilladelser ugyldige.

## Sådan løser du det [#sådan-løser-du-det]

1. Åbn **Connectors** i Nordvec.
2. Find den berørte connector. Den viser fejltilstanden fra den seneste synkronisering og en **Genopret forbindelse**-knap på sit kort.
3. Vælg **Genopret forbindelse** og log ind hos udbyderen med den **samme konto**, som du oprindeligt tilsluttede. Godkend alle de tilladelser, som udbyderen viser; hvis du afviser en, fører det til en [fejl om manglende tilladelser](/docs/guides/troubleshooting/insufficient-scopes) i stedet.

Genopret forbindelse er også tilgængelig fra connectorens detaljer når som helst, ikke kun efter en fejl.

Genoprettelse af forbindelsen bevarer alt, der allerede er synkroniseret. Brug ikke **Afbryd forbindelse** for at løse en udløbet login: at afbryde forbindelsen sletter permanent alle dokumenter, som connectoren har synkroniseret.

Hvis du logger ind med en anden konto end den, som connectoren blev opsat med, nægter Nordvec at genoprette forbindelsen og ændrer intet. For at skifte konto skal du afbryde connectoren og tilslutte den anden konto i stedet.

### Connectors, der ikke kan genoprettes på stedet [#connectors-der-ikke-kan-genoprettes-på-stedet]

Guru, Notion, Zendesk, Freshdesk, Trello og e-conomic tilbyder ikke **Genopret forbindelse**, fordi Nordvec ikke kan bekræfte, at en ny login tilhører den samme konto. For disse skal du afbryde connectoren og tilslutte den igen. Når du afbryder forbindelsen, slettes de dokumenter, den har synkroniseret, og næste synkronisering importerer dem igen fra starten.

## Hvad sker der efter genoprettelse af forbindelsen [#hvad-sker-der-efter-genoprettelse-af-forbindelsen]

Den nye login erstatter den gamle, og fejlen forsvinder. En synkronisering starter med det samme, og dokumenter, der mislykkedes, mens forbindelsen var nede, forsøges igen. De elementer, der er angivet under **"Elementer, der ikke kunne importeres"**, fjernes, efterhånden som de importeres med succes.

Connectors er tilsluttet per bruger: genoprettelse af forbindelsen fornyer *din* forbindelse og påvirker ikke andres. Kun den person, der har tilsluttet en connector, kan genoprette den, og det gælder også admins for arbejdsområdet: en admin kan ikke genoprette en kollegas connector.


---

# Giv manglende tilladelser
Source: https://nordvec.com/da/docs/guides/troubleshooting/insufficient-scopes

Løs synkroniseringsfejl med "manglende påkrævede tilladelser" ved at genoprette forbindelsen til connectoren og godkende alle anmodede tilladelser.



Når en synkronisering rapporterer **"Din konto mangler de nødvendige tilladelser"**, fungerer forbindelsen til udbyderen, men den har fået færre tilladelser (OAuth-scopes), end connectoren har brug for til at læse dit indhold. Dette er en egenskab ved selve tilladelsen, så den eneste løsning er at genoprette forbindelsen med det fulde sæt af tilladelser.

## Hvorfor dette sker [#hvorfor-dette-sker]

* En tilladelse blev afvist under den oprindelige forbindelsesproces. Nogle udbydere lader dig fravælge individuelle tilladelser på samtykkeskærmen.
* Connectoren har fået en ny funktion, der kræver en ekstra tilladelse, og din ældre tilladelse er fra før denne opdatering.
* En arbejdsområde-administrator har begrænset, hvilke tilladelser tredjepartsapps må have, eller udbyderen kræver admin-godkendelse for nogle af dem.

## Sådan løser du det [#sådan-løser-du-det]

1. Åbn **Connectors** i Nordvec.
2. Find den berørte connector, og vælg **Genopret forbindelse** på dens kort.
3. Log ind med den samme konto, du oprindeligt forbandt, og godkend **alle** de anmodede tilladelser på udbyderens samtykkeskærm. Hver tilladelse svarer til et konkret behov, typisk læsning af de dokumenter, filer eller beskeder, som connectoren synkroniserer. Der er ingen valgfrie ekstra tilladelser på listen.

Genoprettelse af forbindelsen bevarer de dokumenter, der allerede er synkroniseret. Guru, Notion, Zendesk, Freshdesk, Trello og e-conomic kan ikke genoprettes på stedet. For disse skal du afbryde forbindelsen og forbinde igen, hvilket sletter de synkroniserede dokumenter og importerer dem igen fra starten.

Hvis samtykkeskærmen angiver, at en administrator skal godkende appen, skal du videresende anmodningen til din arbejdsområde-administrator. Udbydere med admin-godkendelsesflows (f.eks. Google Workspace- og Microsoft 365-organisationer eller Slack-arbejdsområder med app-godkendelse) blokerer tilladelsen, indtil en admin har godkendt den. Genoprettelse af forbindelsen før dette godkendelse vil give den samme fejl.

## Hvad sker der efter genoprettelse af forbindelsen [#hvad-sker-der-efter-genoprettelse-af-forbindelsen]

Den nye tilladelse erstatter den gamle, fejlen forsvinder, og en synkronisering starter med det samme. Elementer, der tidligere mislykkedes på grund af tilladelsesfejl, bliver forsøgt igen.


---

# Dokumentgrænse nået
Source: https://nordvec.com/da/docs/guides/troubleshooting/document-limit

Hvad sker der, når din plans dokumentgrænse sætter synkroniseringen på pause, og hvordan du frigør plads eller opgraderer for at genoptage.



Når en synkronisering rapporterer **"Du har nået dit abonnements dokumentgrænse"**, er forbindelsen sund, og der er ikke sket fejl hos udbyderen. Dit korpus har blot nået det maksimale antal dokumenter, som dit abonnement tillader, så importen er sat på pause i stedet for at droppe indhold uden varsel.

## Hvad grænsen dækker [#hvad-grænsen-dækker]

Grænsen tæller dokumenter, der er gemt i dit korpus på tværs af alle kilder: connectorsynkroniseringer, uploads og dokumenter, der er sendt via API'en. Den eksisterer for at holde indekserings- og søgeomkostninger forudsigelige. Det er en tilladelse per arbejdsområde, ikke per connector.

## Sådan genoptager du synkronisering [#sådan-genoptager-du-synkronisering]

Gør ét af følgende:

* **Frigør plads.** Slet dokumenter, du ikke længere har brug for, eller frakobl en kilde, hvis indhold du ikke ønsker indekseret. Når du sletter et dokument, fjernes det fra indekset med det samme.
* **Opgrader dit abonnement eller tilføj pladser.** Tilladelsen er sat per plads, og højere abonnementer tillader flere dokumenter per plads.

Der er ikke behov for manuel genstart bagefter. Den næste planlagte synkronisering registrerer den frigjorte kapacitet og genoptager, hvor den slap. Du kan også udløse en synkronisering manuelt fra connectorens kort, når der er plads tilgængelig.

## Hvad sker der med dokumenter, der ikke kunne være med [#hvad-sker-der-med-dokumenter-der-ikke-kunne-være-med]

Intet går tabt hos kilden; udbyderen forbliver systemet, der registrerer data. Dokumenter, der ikke kunne importeres, bliver hentet ved den næste succesfulde synkronisering, når der er kapacitet til det.


---

# Dagligt behandlingsloft nået
Source: https://nordvec.com/da/docs/guides/troubleshooting/daily-processing-limit

Hvad sker der, når dit arbejdsområdes daglige behandlingsloft sætter synkroniseringen på pause, og hvornår den genoptages.



Når en synkronisering rapporterer **"Dit arbejdsområde har nået dagens behandlingsgrænse"**, er forbindelsen sund, og intet mislykkedes hos udbyderen. Dit arbejdsområde har behandlet så meget nyt indhold på én dag, som dets grænse tillader, så importen blev sat på pause i stedet for at fortsætte med at afvise element for element.

## Hvad grænsen dækker [#hvad-grænsen-dækker]

Grænsen tæller det indhold, der er behandlet til indeksering på tværs af alle kilder (connector-synkroniseringer, uploads, dokumenter sendt via API'en) på én kalenderdag, målt i UTC. Den eksisterer for at forhindre, at en første synkronisering af en stor kilde kører ubegrænset på én dag; uændret indhold tæller aldrig igen, så efter den første import når et arbejdsområde sjældent grænsen.

Grænsen er en tilladelse pr. arbejdsområde, der skalerer med antallet af pladser, og hvert medlem kan bruge en andel af den pr. dag, så én persons store import ikke kan bruge hele arbejdsområdets tilladelse op.

## Sådan genoptages synkroniseringen [#sådan-genoptages-synkroniseringen]

Ingenting at gøre. Connectoren er planlagt til at køre igen efter midnat UTC, når dagens tilladelse nulstilles, og den fortsætter, hvor den stoppede. Statusmeddelelsen forsvinder ved den kørsel.

Du kan også udløse en synkronisering manuelt fra connectorens kort. Den vil fortsætte, hvor den forrige stoppede, når tilladelsen er tilgængelig.

## Hvad sker der med indhold, der ikke blev behandlet [#hvad-sker-der-med-indhold-der-ikke-blev-behandlet]

Intet går tabt hos kilden; udbyderen forbliver systemet, der registrerer data. Elementer, der ikke kunne behandles i dag, bliver hentet ved næste kørsel.