Status og feilsøking

Betaversjon under utvikling

Forvaltningssynkronisering er en betaversjon under utvikling. Vær forsiktig ved bruk på produksjonsdata, og ta backup før du synkroniserer. Se Om løsningen.

Denne siden forklarer Status-visningen, innstillingene og de vanligste feilmeldingene.

Status-siden

Visningen Status gir overblikket over synkroniseringsløsningen og oppdateres automatisk med noen sekunders mellomrom. Oppdater-knappen henter alt på nytt umiddelbart.

Helse

To prikker viser om synkroniseringsløsningen er oppe:

• Liveness (healthz) — om tjenesten kjører i det hele tatt (OK / Nede).
• Readiness (readyz) — om den er klar til å gjøre arbeid, dvs. når lagring og AGOL-pålogging virker (Klar / Ikke klar).

Er noe rødt her, ligger problemet i selve løsningen eller driftsmiljøet — kontakt Geodata.

Synkroniseringskø

Tre tellere viser tilstanden i synk-køen:

Teller	Betydning	Normalt
Venter	Forespørsler som ligger i kø og venter på worker-en.	Lavt tall som raskt går mot 0.
Behandles	Kjøringer som pågår akkurat nå.	0 eller 1.
Dead-letter	Koblinger som har feilet permanent og trenger oppfølging.	0.

Tidsstyrt synk pr kobling

Nederst listes hver kobling med tidsplanene sine per retning — frekvens og neste kjøretidspunkt, eller pauset. Her ser du raskt om automatikken faktisk er skrudd på for koblingene dine.

Dead-letter

En forespørsel havner i dead-letter når synkroniseringen har feilet på en måte som ikke løser seg selv: enten gjentatte ganger på rad (forbigående feil som aldri ga seg), eller umiddelbart ved en permanent feil — for eksempel en kodeverdi uten mapping der Ved ukjent verdi står på Feil endringen. Tidsstyrt synk lar en dead-lettered kobling ligge i fred.

Hver dead-letter krever oppfølging:

1. Finn ut hva som feilet — rett årsaken (typisk mappingen, kodeverdien eller AGOL-tjenesten). Feilårsaken står i løsningens logg; kontakt Geodata hvis du ikke finner den selv.
2. Kjør en manuell synk på koblingen i samme retning. Manuell synk nullstiller feiltelleren og prøver på nytt — også for koblinger i dead-letter.
3. Kontroller at Dead-letter-telleren på Status-siden går tilbake til 0.

Innstillinger

API-tilkobling

Base-URL peker på organisasjonens forvaltningssynkronisering-instans og hentes normalt fra appens oppsett — du trenger ikke røre den. Test tilkobling verifiserer at API-et svarer og viser helsestatusen, og er et godt førstesteg i feilsøking.

Innstillingene har ingen token-innstillinger. Synkadmin bruker alltid AGOL-tokenet fra innloggingen.

Data mangler etter at koblingen er opprettet

En ny kobling sender bare endringer gjort i AGOL etter at koblingen ble opprettet. Objekter som fantes i AGOL-tjenesten fra før, kommer ikke til det sentrale datasettet av seg selv. Kjør Initial last for å sende dem.

Mangler endringer i én retning, kontroller også at koblingens retningssperre tillater retningen. Synk i en sperret retning blir avvist eller hoppet over. Se Retningssperre.

Ser ikke provisjonert tjeneste i AGOL

En tjeneste som er provisjonert fra Synkadmin, eies av synkbrukeren. Du ser den bare hvis den er delt med gruppen SynkAdminShareGroup og du er medlem av gruppen. Vanlige årsaker til at den ikke vises:

• Gruppen finnes ikke, har feil navn, eller synkbrukeren er ikke medlem. Da hoppes delingen over.
• Du er selv ikke medlem av gruppen.
• Tjenesten ble provisjonert før gruppen ble satt opp. Delingen skjer bare når tjenesten opprettes.

Be administrator kontrollere gruppen, se Synlighet for provisjonerte tjenester. Eldre tjenester kan deles med gruppen manuelt i AGOL av synkbrukeren eller en administrator.

Vanlige feilmeldinger

Melding	Årsak	Løsning
«API-et avviste tokenet (401/403). Innloggingen kan ha utløpt, eller brukeren din mangler tilgang. Logg ut og inn igjen.»	AGOL-tokenet fra innloggingen er utløpt, eller brukeren din mangler tilgang.	Logg ut og inn igjen, eller last siden på nytt. Hjelper ikke det, kontroller at brukeren din har tilgang til AGOL-tjenesten.
«Fikk ikke kontakt med API-et.»	Feil Base-URL, eller løsningen er nede.	Kjør Test tilkobling under Innstillinger. Sjekk helse på Status-siden.
«Preflight feilet. Sjekk URL og token.»	AGOL-URL-en peker ikke på en gyldig feature-tjeneste, eller brukeren din har ikke tilgang til den.	Kontroller at URL-en peker på tjenesten (uten lag-ID), og at du har tilgang til elementet i AGOL.
«Tjenesten er ikke helt klar for synk» + punktliste	AGOL-tjenesten mangler forutsetninger — typisk ChangeTracking eller editor tracking.	Rett punktene på tjenesten i AGOL. Koblingen kan opprettes først og rettes etterpå, men synkroniser ikke før alt er grønt.
«AGOL-lag … er koblet til flere objekttyper: … Hver objekttype og geometri må ha sitt eget lag.»	To objekttyper eller geometrivarianter er koblet til samme AGOL-lag i mappingen.	Koble hver variant til sitt eget lag med riktig geometri. Lag som er i bruk, er merket brukt av … i lagvelgeren.
«… er koblet til … som har geometritype …»	En objekttype er koblet til et AGOL-lag med feil geometritype, for eksempel en flatevariant til et punktlag.	Velg et lag med samme geometritype.
«Synk pågår for bindingen. Prøv igjen når den er ferdig.»	Du bestilte initial last mens en synkronisering pågikk for koblingen.	Vent til kjøringen er ferdig (se Behandles på Status-siden), og bestill på nytt.
«Koblingen er låst til motsatt retning. Denne tidsplanen kjøres ikke — slett den.»	Koblingen har en tidsplan i en retning som retningssperren ikke tillater.	Slett tidsplanen, eller endre retningssperren hvis begge retninger faktisk skal synkroniseres.
«… forespørsel(er) i dead-letter. Sjekk logg for permanente feil.»	Én eller flere koblinger har feilet permanent.	Se Dead-letter over.
«Datasettet ga ingen features å vise.»	Datasettet er tomt, eller forhåndsvisningen fant ingen objekter.	Kontroller datasettet i forvaltningssystemet.
«mangler — konfliktdeteksjonen er blind» (på koblingens Editor-tracking)	AGOL-tjenesten eksponerer ikke editor- og redigeringsdato-felt.	Aktiver editor tracking på tjenesten og kjør Rediger mapping på nytt.

Får du ikke løst problemet, kontakt Geodata — oppgi kobling-ID, retning, ca. tidspunkt og feilmeldingen du ser.