En synkroniseringskörning kan stanna halvvägs för att en worker startar om, det andra systemet ligger nere eller en post avvisas. Efter en stoppad worker eller ett tillfälligt avbrott tar Tajo upp synkroniseringen igen på egen hand. Poster som skrivits de senaste sju dagarna skickas inte igen. Den här sidan beskriver vad Tajo gör, vad du ser på synkroniseringens sida och de få fall där du behöver agera.
Snabbkontroll Öppna synkroniseringen från Syncs and mappings under Connections och läs den senaste körningen i Run history. En misslyckad körning säger vad som hände och vad du ska göra härnäst.
Vad Tajo gör på egen hand
Cursorn. En körning läser källan i batchar från synkroniseringens sparade cursor. Cursorn flyttas fram i slutet av en batch bara när varje post i batchen kom fram. Om körningen misslyckas behålls den senaste position som den nådde utan fel. Nästa körning börjar där, så en avbruten batch läses igen i stället för att hoppas över.
Leveransledgern. Innan en post skrivs får den en leveransnyckel. Nyckeln är en hash av synkroniseringen, källan, sidans cursor, postens position på sidan och själva posten, så den innehåller inga personuppgifter. Innan destinationen anropas reserveras nyckeln. När skrivningen lyckas markeras nyckeln som slutförd och sparas i sju dagar. Nyckeln beror inte på vilken körning som frågar, så ett nytt försök eller en senare schemalagd körning härleder samma nyckel för samma post. Inom de sju dagarna används det sparade resultatet och destinationen anropas inte igen. Därför landar en upprepad batch inte två gånger.
En körning i taget. Varje synkronisering har en lease, som den pågående körningen håller under hela sin livstid. Leasen har en egen token och en livslängd på 15 minuter, och den förnyas var 5:e minut medan körningen arbetar. En körning som förlorar sin lease stannar före nästa skrivning eller checkpoint, för att inte skriva två gånger. När en worker stannar förnyas inte längre dess lease, och den löper ut inom 15 minuter.
Automatiska nya försök. En köad körning som misslyckas får upp till fem försök. Tajo väntar 60 sekunder före det andra försöket, sedan 120, 240 och 480 sekunder. Ett nytt försök eller en testkörning som du startar själv körs en gång. En körning som krockade med en körning som redan pågick körs inte igen, och inte heller en körning vars publicerade version eller anslutningar inte längre är giltiga.
Körningar som har fastnat. För en synkronisering som Tajo kör enligt schema stängs en körning och en ny köas när den startade för över en timme sedan och inte längre har sin lease. Den stängda körningen visar ”The run stopped reporting progress and was closed.” (körningen slutade rapportera förlopp och stängdes). En stoppad körnings lease varar alltså högst 15 minuter, och en schemalagd synkroniserings körning som har fastnat ersätts efter en timme. Förstå datasynkronisering visar vilka synkroniseringar som körs enligt schema.
Paus efter upprepade fel. Om alla de fem senaste avslutade körningarna sedan synkroniseringen senast ändrades misslyckades pausar Tajo synkroniseringen. Dess sida visar ”Paused automatically by the failure circuit breaker” (pausad automatiskt av felbrytaren) med det senaste felet. En enda lyckad körning nollställer räkningen. Ingenting startar om en pausad synkronisering av sig själv: den förblir pausad tills du åtgärdar orsaken och publicerar den igen.
Kontrollen varje timme. Varje timme, 13 minuter över, larmar Tajo sitt eget team om varje arbetsyta som har en aktiv synkronisering men ingen lyckad körning de senaste 24 timmarna. Det gäller även en arbetsyta där ingen körning alls har registrerats. Larmet utlöses en gång och utlöses igen först när en körning har lyckats. En arbetsyta vars äldsta aktiva synkronisering aktiverades eller ändrades för mindre än 24 timmar sedan kontrolleras inte än. Larmet når Tajo, inte dig, och det ändrar inte din synkronisering.
Vad du ser
Öppna synkroniseringen från Syncs and mappings. Run history listar varje körning med skrivna poster av lästa poster, antalet misslyckade, varaktigheten och när den startade. Statusen är Queued, Running, Succeeded, Partial (vissa poster misslyckades) eller Failed.
- En pågående körning som inte har rapporterat förlopp på 2 minuter visar ”Waiting for a fresh progress update” (väntar på en ny förloppsuppdatering).
- En misslyckad körning visar en mening om vad som hände, en om vad du ska göra härnäst, felets namn och körningens id.
- View DLQ på sidan Syncs listar misslyckade och delvis lyckade körningar för alla synkroniseringar, var och en med en Retry-knapp.
Vad du gör
- Läs den senaste misslyckade körningen. Dess rad om vad du ska göra är nästa steg. Tabellen nedan listar de fel du troligast stöter på.
- Om det står ”Nothing” (ingenting), vänta. Nästa schemalagda körning återhämtar sig av sig själv.
- Om det står att du ska köra synkroniseringen igen, tryck på Retry på den misslyckade körningen under View DLQ. Det nya försöket startar från den sparade cursorn, så batchar som redan skrivits skrivs inte igen. Ett lyckat nytt försök tar bort den misslyckade körningen från listan.
- Om synkroniseringen har pausats, åtgärda orsaken som bannern anger och publicera sedan synkroniseringen igen med Publish sync eller Request publish approval.
- Om samma fel kommer tillbaka, skicka oss körningens id som visas under den misslyckade körningen.
Varje felnamn motsvarar en mening om vad som hände, en om vad du ska göra härnäst och vem som åtgärdar det: du eller Tajo.
| Felnamn | Vad som hände | Vad du gör | Vem åtgärdar |
|---|---|---|---|
lease_conflict | En annan körning av den här synkroniseringen pågick redan. | Ingenting. Den pågående körningen blir klar; nästa schemalagda körning startar som vanligt. | Tajo |
lease_lost | Körningen förlorade sin plats halvvägs och stoppade för att inte skriva två gånger. | Kör synkroniseringen igen. | Tajo |
lease_unavailable | Synkroniseringen kunde inte reservera sin körplats. | Kör synkroniseringen igen. Om den misslyckas på samma sätt, skicka oss körningens id. | Tajo |
stale_job_swept | Körningen slutade rapportera förlopp och stängdes. | Kör synkroniseringen igen. | Tajo |
provider_rate_limited | Det andra systemet bad oss sakta ner. | Ingenting. Vänta på nästa schemalagda körning. | Tajo |
provider_unavailable | Det andra systemet var otillgängligt eller svarade inte i tid. | Ingenting. Vänta på nästa schemalagda körning. Om den misslyckas på samma sätt under ett dygn, skicka oss körningens id. | Tajo |
connection_missing | Ett verktyg som synkroniseringen använder är inte anslutet i den här arbetsytan; körningen anger vilket. | Anslut det och kör sedan synkroniseringen igen. | Du |
connection_unauthorized | Det andra systemet nekade oss åtkomst. | Återanslut anslutningen så att den får en ny behörighet och kör sedan synkroniseringen igen. | Du |
destination_rejected | Destinationen avvisade varje post i den här körningen. | Kontrollera fältmappningen mot destinationens obligatoriska fält och format och kör sedan synkroniseringen igen. | Du |
node_failed | Ett steg i synkroniseringen misslyckades när poster lästes, omvandlades eller skrevs. | Öppna körningen för att se vilket steg som misslyckades och varför, åtgärda det och kör sedan synkroniseringen igen. | Du |
attestation_rule_not_active | Den här synkroniseringen är pausad. | Återuppta synkroniseringen för att köra den. | Du |
attestation_publication_not_attested | Den här versionen av synkroniseringen har inte publicerats. | Publicera synkroniseringen. Ändringar i en synkronisering körs inte förrän de har publicerats. | Du |
unclassified_exception | Synkroniseringen misslyckades av en orsak som vi inte har klassificerat än. | Kör synkroniseringen igen. Om den misslyckas på samma sätt, skicka oss körningens id. | Tajo |
Vad som kan gå fel
- Retry svarar ”This sync rule is already running.” (den här synkregeln körs redan). Ett nytt försök eller en testkörning som du startar avvisas så länge någon körning av synkroniseringen visas som Queued eller Running, även en körning vars worker har stannat. För en synkronisering som Tajo kör enligt schema stängs och ersätts den körningen när den startade för mer än en timme sedan. För alla andra synkroniseringar, skicka oss körningens id.
- En synkronisering har misslyckats i mer än sju dagar. Efter sju dagar glömmer ledgern en slutförd skrivning. En batch som upprepas efter det kan skriva poster igen, så kontrollera destinationen efter dubbletter av kontakter.
- En synkronisering är tyst medan en annan fungerar. Kontrollen varje timme bevakar arbetsytan, inte varje synkronisering. En frisk synkronisering döljer en tyst i samma arbetsyta, så läs Run history för varje synkronisering.
- Du vill ha andra gränser. Pausen efter fem fel och kontrollen efter 24 timmar gäller hela Tajo-driftsättningen, inte en enskild synkronisering.