# Context pack: Felsökning

Source: https://nordvec.com/sv/docs/guides/troubleshooting
Pack: https://nordvec.com/sv/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. [Fel och begränsningar för anrop](https://nordvec.com/sv/docs/guides/errors-and-rate-limits) (builds on)
2. [Felsökning](https://nordvec.com/sv/docs/guides/troubleshooting) (this guide)
3. [Återanslut en anslutning](https://nordvec.com/sv/docs/guides/troubleshooting/reconnect-integration) (linked from this guide)
4. [Bevilja saknade behörigheter](https://nordvec.com/sv/docs/guides/troubleshooting/insufficient-scopes) (linked from this guide)
5. [Dokumentgränsen är nådd](https://nordvec.com/sv/docs/guides/troubleshooting/document-limit) (linked from this guide)
6. [Daglig bearbetningsgräns nådd](https://nordvec.com/sv/docs/guides/troubleshooting/daily-processing-limit) (linked from this guide)

---

# Fel och begränsningar för anrop
Source: https://nordvec.com/sv/docs/guides/errors-and-rate-limits

Det enda felmeddelande som varje misslyckad förfrågan returnerar, gränshuvudena för anrop, och hur du säkert försöker igen med en skrivning.



Varje slutpunkt misslyckas på samma sätt, så en klient hanterar fel, hastighetsbegränsningar och omsändningar en gång och återanvänder den koden överallt, inklusive över [MCP](/docs/guides/mcp).

## Felkuvertet [#felkuvertet]

Varje icke-2xx-svar är ett JSON-objekt:

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

* `code` är HTTP-nivåfelet, till exempel `UNAUTHORIZED`, `FORBIDDEN`,
  `NOT_FOUND`, `BAD_REQUEST` eller `TOO_MANY_REQUESTS`.
* `data.reason`, när det finns, är en mer detaljerad maskinläsbar orsak som
  `auth.key_not_found` eller `rate_limit.exceeded`. Grena på det i stället för på
  `message`, som är för människor och kan ändras.
* `defined` är `true` när operationen listar det felet i
  [API-referensen](/docs/api), och `false` för fel som alla förfrågningar kan möta
  (autentisering, hastighetsbegränsningar, en okänd rutt).
* Ett valideringsfel svarar `BAD_REQUEST` med problemen i
  `data.formErrors` och `data.fieldErrors`.

Varje svar innehåller också ett `X-Request-ID`. Ange det när du kontaktar
support, så kan vi hitta exakt den förfrågan.

## Vanliga statuskoder [#vanliga-statuskoder]

| Status | Kod                     | Vad du ska göra                                                          |
| ------ | ----------------------- | ------------------------------------------------------------------------ |
| `400`  | `BAD_REQUEST`           | Åtgärda förfrågan; `data.fieldErrors` namnger fälten                     |
| `401`  | `UNAUTHORIZED`          | Skicka en giltig nyckel eller session                                    |
| `403`  | `FORBIDDEN`             | Nyckeln saknar det omfång eller den roll som operationen kräver          |
| `404`  | `NOT_FOUND`             | Resursen finns inte, eller så har du inte behörighet att se den          |
| `409`  | `CONFLICT`              | En duplicerad skrivning är fortfarande pågående; försök igen om en stund |
| `413`  | `PAYLOAD_TOO_LARGE`     | Förfrågningskroppen är över 1 MB; dela upp en bulkpush i mindre batcher  |
| `422`  | `UNPROCESSABLE_CONTENT` | Förfrågan är välformulerad men kan inte tillämpas                        |
| `429`  | `TOO_MANY_REQUESTS`     | Vänta i `Retry-After`, sedan försöker du igen                            |

## Hastighetsbegränsningar [#hastighetsbegränsningar]

Varje svar anger den gräns som den räknades mot, i två former:

* `X-RateLimit-*`-huvudena;
* de IETF-strukturerade fälten `RateLimit` (aktuellt tillstånd: `r` är de återstående förfrågningarna, `t` sekunderna tills fönstret återställs) och `RateLimit-Policy` (kvoten: `q` är gränsen, `w` fönstret i sekunder).

Ett `429` innehåller också `Retry-After` i sekunder och `data.retryAfterMs`. Vänta minst så länge innan nästa förfrågan; att försöka tidigare räknas och nekas igen.

## Säker omsändning av skrivningar [#säker-omsändning-av-skrivningar]

En skrivoperation som listar en `Idempotency-Key`-huvud i
[API-referensen](/docs/api) kan omsändas utan att arbetet utförs två gånger. Skicka en nyckel per logisk skrivning och upprepa samma nyckel vid varje omsändning:

* samma nyckel med samma kropp inom 24 timmar spelar upp det lagrade svaret;
* samma nyckel med en annan kropp nekas med `422`;
* en duplicering som anländer medan den första fortfarande körs får `409`.

En operation utan huvudet är inte idempotent, så omsänd den bara när du vet att det första försöket inte landade.


---

# Felsökning
Source: https://nordvec.com/sv/docs/guides/troubleshooting

Lösningar för synkroniseringsfel och planbegränsningar du kan stöta på, var och en utgående från meddelandet du ser.



Varje sida börjar med meddelandet som Nordvec visar dig, förklarar varför det visas och går igenom lösningen. För fel som en API-begäran returnerar, se [Fel och begränsningar](/docs/guides/errors-and-rate-limits).

- [Återanslut en anslutning](https://nordvec.com/sv/docs/guides/troubleshooting/reconnect-integration): Åtgärda synkroniseringsfel som "autentiseringen har gått ut" och "åtkomsten har återkallats" genom att återansluta den berörda anslutningen.
- [Bevilja saknade behörigheter](https://nordvec.com/sv/docs/guides/troubleshooting/insufficient-scopes): Åtgärda synkroniseringsfel för "saknade nödvändiga behörigheter" genom att återansluta anslutningen och godkänna varje begärd behörighet.
- [Dokumentgränsen är nådd](https://nordvec.com/sv/docs/guides/troubleshooting/document-limit): Vad som händer när din plans dokumentgräns pausar synkningen, och hur du frigör utrymme eller uppgraderar för att återuppta.
- [Daglig bearbetningsgräns nådd](https://nordvec.com/sv/docs/guides/troubleshooting/daily-processing-limit): Vad som händer när din arbetsyta pausar synkroniseringen på grund av den dagliga bearbetningsgränsen, och när den återupptas.


---

# Återanslut en anslutning
Source: https://nordvec.com/sv/docs/guides/troubleshooting/reconnect-integration

Åtgärda synkroniseringsfel som "autentiseringen har gått ut" och "åtkomsten har återkallats" genom att återansluta den berörda anslutningen.



När en synkronisering rapporterar **"Din autentisering har upphört att gälla"** eller **"Din åtkomst har återkallats"**, kan Nordvec inte längre agera å din vägnar hos leverantören. Själva anslutningen måste förnyas; att försöka synkronisera igen utan att återansluta hjälper inte.

## Varför detta händer [#varför-detta-händer]

* Leverantören har upphört giltigheten för den långlivade inloggningsuppgift som Nordvec har. Vissa leverantörer gör detta enligt ett fast schema, andra efter en tids inaktivitet.
* Du har ändrat ditt lösenord hos leverantören, vilket vanligtvis återkallar åtkomst för alla anslutna appar.
* Du (eller en arbetsytans administratör) har återkallat Nordvecs åtkomst från leverantörens inställningar för anslutna appar eller säkerhet.
* Leverantören har uppdaterat sin säkerhetspolicy (till exempel efter misstänkt aktivitet på ditt konto) och ogiltigförklarat befintliga behörigheter.

## Så här åtgärdar du det [#så-här-åtgärdar-du-det]

1. Öppna **Connectors** i Nordvec.
2. Hitta den berörda anslutningen. Den visar felstatusen från den senaste synkroniseringen och en **Återanslut**-knapp på sitt kort.
3. Välj **Återanslut** och logga in hos leverantören med **samma konto** som du ursprungligen anslöt. Godkänn alla behörigheter som leverantören listar; att neka en leder till ett [fel för saknade behörigheter](/docs/guides/troubleshooting/insufficient-scopes) i stället.

Återanslut är också tillgängligt från anslutningens detaljer när som helst, inte bara efter ett fel.

Återanslutning behåller allt som redan har synkroniserats. Använd inte **Koppla från** för att åtgärda en utgången inloggning: att koppla från raderar permanent alla dokument som anslutningen har synkroniserat.

Om du loggar in med ett annat konto än det som anslutningen ursprungligen konfigurerades med, vägrar Nordvec återanslutningen och ändrar ingenting. För att byta konto, koppla från anslutningen och anslut det andra kontot i stället.

### Anslutningar som inte kan återanslutas på plats [#anslutningar-som-inte-kan-återanslutas-på-plats]

Guru, Notion, Zendesk, Freshdesk, Trello och e-conomic erbjuder inte **Återanslut**, eftersom Nordvec inte kan bekräfta att en ny inloggning tillhör samma konto. För dessa, koppla från anslutningen och anslut den igen. Att koppla från raderar de dokument som den har synkroniserat, och nästa synkronisering importerar dem på nytt från början.

## Vad som händer efter återanslutning [#vad-som-händer-efter-återanslutning]

Den nya inloggningen ersätter den gamla och felet rensas. En synkronisering startar omedelbart, och dokument som misslyckades medan anslutningen var nere försöks igen; objekten som listas under **"Objekt som inte kunde importeras"** rensas när de importeras framgångsrikt.

Anslutningar är anslutna per användare: att återansluta förnyar *din* anslutning och påverkar inte någon annans. Endast personen som anslöt en anslutning kan återansluta den, och det gäller även arbetsytans administratörer: en administratör kan inte återansluta en kollegas anslutning.


---

# Bevilja saknade behörigheter
Source: https://nordvec.com/sv/docs/guides/troubleshooting/insufficient-scopes

Åtgärda synkroniseringsfel för "saknade nödvändiga behörigheter" genom att återansluta anslutningen och godkänna varje begärd behörighet.



När en synkronisering rapporterar **"Ditt konto saknar nödvändiga behörigheter"**, fungerar anslutningen till leverantören, men den har beviljats färre behörigheter (OAuth-scope) än vad anslutningen behöver för att läsa ditt innehåll. Detta är en egenskap hos själva beviljandet, så den enda lösningen är att göra om anslutningen med hela uppsättningen behörigheter.

## Varför detta händer [#varför-detta-händer]

* En behörighet nekades under den ursprungliga anslutningsprocessen. Vissa leverantörer låter dig avmarkera enskilda behörigheter på samtyckesskärmen.
* Anslutningen har fått en ny funktion som kräver en ytterligare behörighet, och ditt äldre beviljande är från innan den infördes.
* En arbetsyta-administratör har begränsat vilka behörigheter tredjepartsappar får ha, eller leverantören kräver administratörsgodkännande för vissa av dem.

## Så här åtgärdar du det [#så-här-åtgärdar-du-det]

1. Öppna **Connectors** i Nordvec.
2. Hitta den berörda anslutningen och välj **Återanslut** på dess kort.
3. Logga in med samma konto som du ursprungligen anslöt, och godkänn **alla** efterfrågade behörigheter på leverantörens samtyckesskärm. Varje behörighet motsvarar ett konkret behov, vanligtvis att läsa dokumenten, filerna eller meddelandena som anslutningen synkroniserar. Det finns inga valfria tillägg i listan.

Att återansluta behåller de dokument som redan har synkroniserats. Guru, Notion, Zendesk, Freshdesk, Trello och e-conomic kan inte återanslutas på plats. För dessa måste du koppla från och ansluta igen, vilket raderar de synkroniserade dokumenten och importerar dem på nytt från början.

Om samtyckesskärmen säger att en administratör måste godkänna appen, vidarebefordra begäran till din arbetsyta-administratör. Leverantörer med administratörsgodkännande-flöden (till exempel Google Workspace- och Microsoft 365-organisationer, eller Slack-arbetsytor med app-godkännande) blockerar beviljandet tills en administratör tillåter det, och att återansluta innan det godkännandet kommer att ge samma fel.

## Vad händer efter återanslutning [#vad-händer-efter-återanslutning]

Det nya beviljandet ersätter det gamla, felet försvinner och en synkronisering startar omedelbart. Objekt som tidigare misslyckades på grund av behörighetsfel försöks igen.


---

# Dokumentgränsen är nådd
Source: https://nordvec.com/sv/docs/guides/troubleshooting/document-limit

Vad som händer när din plans dokumentgräns pausar synkningen, och hur du frigör utrymme eller uppgraderar för att återuppta.



När en synkronisering rapporterar **"Du har nått ditt abonnemangs dokumentgräns"**, är anslutningen frisk och inget misslyckades hos leverantören. Ditt korpus har helt enkelt nått det maximala antalet dokument som ditt abonnemang tillåter, så importen pausades istället för att tyst ignorera innehåll.

## Vad gränsen omfattar [#vad-gränsen-omfattar]

Gränsen räknar dokument som lagras i ditt korpus från alla källor: anslutningssynkroniseringar, uppladdningar och dokument som skickats via API:t. Den finns för att hålla indexerings- och sökkostnader förutsägbara; det är en tilldelning per arbetsyta, inte per anslutning.

## Så återupptar du synkronisering [#så-återupptar-du-synkronisering]

Gör något av följande:

* **Frigör utrymme.** Ta bort dokument du inte längre behöver, eller koppla från en källa vars innehåll du inte vill indexera. När du tar bort ett dokument försvinner det från indexet omedelbart.
* **Uppgradera ditt abonnemang eller lägg till platser.** Tilldelningen är satt per plats, och högre abonnemang tillåter fler dokument per plats.

Ingen manuell omstart behövs efteråt: nästa schemalagda synkronisering upptäcker det frigjorda utrymmet och återupptar där den slutade. Du kan också starta en synkronisering manuellt från anslutningens kort när utrymme finns tillgängligt.

## Vad händer med dokument som inte fick plats [#vad-händer-med-dokument-som-inte-fick-plats]

Inget går förlorat hos källan; leverantören förblir systemet för arkivering. Dokument som inte kunde importeras hämtas upp av nästa lyckade synkronisering när kapacitet finns.


---

# Daglig bearbetningsgräns nådd
Source: https://nordvec.com/sv/docs/guides/troubleshooting/daily-processing-limit

Vad som händer när din arbetsyta pausar synkroniseringen på grund av den dagliga bearbetningsgränsen, och när den återupptas.



När en synkronisering rapporterar **"Din arbetsyta har nått dagens bearbetningsgräns"**, är anslutningen frisk och inget misslyckades hos leverantören. Din arbetsyta har bearbetat så mycket nytt innehåll på en dag som dess gräns tillåter, så importen pausades istället för att fortsätta avvisas post för post.

## Vad gränsen omfattar [#vad-gränsen-omfattar]

Gränsen räknar innehållet som bearbetats för indexering från alla källor (anslutningssynkroniseringar, uppladdningar, dokument som skickats via API) under ett kalenderdygn, mätt i UTC. Den finns för att förhindra att en första synkronisering av en stor källa körs obegränsat under en enda dag. Oförändrat innehåll räknas aldrig igen, så efter den första importen når en arbetsyta sällan gränsen.

Gränsen är en tilldelning per arbetsyta som skalar med antalet platser, och varje medlem kan använda en del av den per dag. På så sätt kan en persons stora import inte använda upp hela arbetsytans tilldelning.

## Hur synkroniseringen återupptas [#hur-synkroniseringen-återupptas]

Ingenting att göra. Anslutningen är schemalagd att köras igen efter midnatt UTC, när dagens tilldelning återställs, och den fortsätter där den slutade. Statusmeddelandet rensas vid den körningen.

Du kan också trigga en synkronisering manuellt från anslutningens kort. Den kommer att fortsätta där den tidigare körningen slutade när tilldelningen är tillgänglig.

## Vad händer med innehåll som inte bearbetades [#vad-händer-med-innehåll-som-inte-bearbetades]

Inget går förlorat hos källan; leverantören förblir systemet för registrering. Objekt som inte kunde bearbetas idag hämtas upp av nästa körning.