Så avgör du om ett Immich-fel kommer från klienten eller servern

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Ta reda på om ett Immich-fel uppstår på klient- eller serversidan genom att upprepa samma åtgärd med en enda ändrad variabel och följa den misslyckade begäran genom hela kedjan.

En mobilbanner med texten ”serverfel” kan ändå bero på klienttillstånd, TLS, en omvänd proxy eller en begäran som servern avvisade korrekt. På samma sätt bevisar ett fel som bara uppstår i webbläsaren inte att det är fel på webbläsaren. Håll konto, objekt och åtgärd oförändrade; jämför klienter och anslutningsvägar och använd sedan statuskoder och synkroniserade loggar för att hitta det första lagret där felet uppstår.

Upprepa samma åtgärd på en andra klient

Välj en åtgärd som alltid går att upprepa, till exempel att logga in, öppna ett känt objekt, ladda upp samma lilla foto eller göra samma sökning. Upprepa den med samma konto i en webbläsare och en mobilklient utan att ändra nätverksväg. Anteckna exakt tid och resultat för båda försöken.

En aktuell Immich-rapport där en Android-klient misslyckades medan andra åtkomstvägar testades visar värdet av att jämföra mellan klienter. Orsaken i en diskussion gäller inte nödvändigtvis generellt, men ett klientspecifikt resultat avgränsar tydligt var du bör leta härnäst.

Om samma åtgärd misslyckas för alla klienter samtidigt hamnar servern, databasen, lagringen eller den gemensamma nätverksvägen högre upp på listan. Om bara en klient misslyckas medan en annan fungerar via samma slutpunkt ska du kontrollera klientversion, cachat tillstånd, behörigheter, lokal certifikattillit och exakt vilken begäran som skiljer sig.

Ändra anslutningsvägen utan att ändra kontot eller objektet

Jämför sedan en betrodd lokal väg med den vanliga omvända proxyn, VPN-anslutningen, tunneln eller fjärranslutningen. Använd samma konto och åtgärd. Om det fungerar lokalt men inte på distans tyder det på att problemet inte ligger i själva medieposten, utan i DNS-, TLS-, proxy-, brandväggs- eller uppströmsroutningslagret.

ZimaSpaces guide till felsökning av lokala kontra fjärranslutna vägar förklarar varför framgång på det lokala nätverket och på internet är olika slags bevis. Tillämpa den här avgränsningen på Immich innan du installerar om en mobilapp eller bygger om servern.

Om båda vägarna misslyckas på samma sätt ska du sluta ändra proxyinställningarna och granska begäran på applikationssidan. Om bara proxyvägen misslyckas ska du registrera proxystatus, TLS-resultat, svar från uppströmsservern och tidsgräns. Den här jämförelsen, där bara en variabel ändras, hindrar ett klientmeddelande från att leda felsökningen till fel lager.

Använd statuskoder som ledtrådar, inte som slutgiltiga besked

HTTP-statusklasser hjälper dig att avgöra var du ska leta, men de identifierar inte automatiskt komponenten som orsakade problemet. Ett 4xx innebär ofta att begäran, autentiseringen eller behörigheten inte godkändes; ett 5xx anger att en komponent på serversidan inte kunde hantera begäran. Proxyservrar kan generera båda klasserna innan Immich tar emot begäran.

Fälthandboken för åtkomstloggar lyfter fram statuskod, URL-sökväg, begärandetid, fjärrvärd och begärandeidentifierare som användbara fält vid felsökning. Samla in dessa värden för den enda felande åtgärden i stället för att söka igenom tusentals irrelevanta rader.

Om proxyn registrerar ett 502-fel eller en timeout utan någon motsvarande Immich-begäran ska du följa uppströmsvägen. Om Immich loggar en begäran och returnerar ett deterministiskt 4xx-fel ska du granska autentisering, behörigheter eller begärans innehåll. Om klienten rapporterar ett fel men alla lager på serversidan visar 2xx ska du granska klientens tolkning, lokala cache eller efterföljande begäranden.

Jämför felfrekvens, latens och serverloggar vid en och samma tidpunkt

En enda misslyckad begäran kan vara en avvikelse. Upprepa åtgärden fem till tio gånger och registrera lyckandefrekvens och latens medan du håller koll på relevanta server- och proxyloggar. Om felen ökar vid resursbrist eller kötoppar kan servern vara otillgänglig till och från, även om ett andra försök lyckas.

Better Stacks översikt över fel och latens som tjänstesignaler skiljer felfrekvens från latens och trafik. Det perspektivet gör det lättare att skilja en enstaka felaktigt formaterad klientbegäran från en serverväg som försämras endast vid hög belastning.

Om serverloggarna innehåller samma undantag för flera klienter ska du utgå från att felet ligger på serversidan tills motsatsen bevisats. Om servern aldrig tar emot den felande begäran ska du spåra DNS, TLS, proxy och klientens nätverk. Om bara en klient skickar en begäran med ett annat format ska du uppdatera eller återställa den klienten efter att ha sparat tillräckliga belägg för att bekräfta skillnaden.

Dra den slutliga slutsatsen med ett två gånger två-test

Använd två klienter och två rutter: webbläsare-lokalt, webbläsare-fjärranslutet, mobil-lokalt och mobil-fjärranslutet. Använd samma konto och testobjekt. Den här matrisen skiljer klientspecifika fel från ruttspecifika fel och serverfel som påverkar alla kombinationer.

En klientorsak stöds av att en klient misslyckas via båda rutterna medan en annan fungerar. En ruttorsak stöds av att båda klienterna misslyckas via endast en rutt. En serverorsak stöds av att alla fyra kombinationerna ger samma programfel och att serverloggarna visar samma misslyckade åtgärd.

När du har åtgärdat det identifierade lagret kör du alla fyra cellerna igen och startar om den berörda komponenten en gång. Avsluta när den ursprungliga felande cellen fungerar utan att kontrollerna slutar fungera. Eskalera med matrisen, tidsstämplar, HTTP-statuskoder, utdrag ur proxy- och serverloggar, klientversioner och en reproducerbar begäran i stället för en generisk skärmbild.

Support och tips

Mer att läsa

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.