Jak ustalić, czy błąd Immich pochodzi z klienta czy z serwera

Eva Wong jest redaktorką techniczną i rezydentką majsterkowania w ZimaSpace. Jest geekiem od zawsze, z pasją do domowych laboratoriów i oprogramowania open source, a jej specjalnością jest przekładanie złożonych zagadnień technicznych na przystępne, praktyczne poradniki. Eva wierzy, że samodzielne hostowanie powinno sprawiać radość, a nie onieśmielać. Dzięki swoim samouczkom pomaga społeczności oswoić konfigurację sprzętu, od budowy pierwszego serwera NAS po opanowanie kontenerów Docker.

Ustal, czy błąd Immich występuje po stronie klienta, czy serwera: powtórz tę samą czynność, zmieniając jedną zmienną, i prześledź nieudane żądanie na całej trasie.

Baner w aplikacji mobilnej z komunikatem „błąd serwera” może w rzeczywistości wskazywać na stan klienta, TLS, odwrotne proxy lub żądanie prawidłowo odrzucone przez serwer. Podobnie awaria występująca tylko w przeglądarce nie dowodzi, że to ona jest uszkodzona. Ujednolić konto, plik i czynność; porównaj klientów oraz trasy; następnie użyj kodów statusu i zsynchronizowanych logów, aby ustalić, na której warstwie pojawia się pierwszy błąd.

Powtórz tę samą czynność na drugim kliencie

Wybierz jedną powtarzalną czynność, na przykład logowanie, otwarcie znanego pliku, przesłanie tego samego małego zdjęcia lub uruchomienie tego samego wyszukiwania. Powtórz ją na tej samej trasie sieciowej, używając tego samego konta w przeglądarce i na urządzeniu mobilnym. Zapisz dokładną godzinę i wynik obu prób.

Najnowszy zgłoszony przypadek Immich, w którym klient na Androidzie nie działał, podczas gdy testowano inne sposoby dostępu, pokazuje, jak przydatne jest porównywanie klientów. Przyczyna z jednego wątku nie musi dotyczyć innych przypadków, ale wynik ograniczony do jednego klienta znacznie zawęża zakres dalszych poszukiwań.

Jeśli wszystkim klientom w tym samym czasie nie udaje się wykonać tej samej czynności, wyżej na liście podejrzanych powinny znaleźć się serwer, baza danych, pamięć masowa lub wspólna ścieżka sieciowa. Jeśli problem występuje tylko u jednego klienta, a drugi działa przez ten sam punkt końcowy, sprawdź wersję klienta, stan pamięci podręcznej, uprawnienia, lokalne zaufanie do certyfikatu oraz dokładną treść różniącego się żądania.

Zmień trasę, nie zmieniając konta ani pliku

Następnie porównaj zaufane połączenie lokalne ze standardowym połączeniem przez odwrotne proxy, VPN, tunel lub trasę zdalną. Użyj tego samego konta i wykonaj tę samą czynność. Jeśli połączenie lokalne działa, a zdalne nie, problem prawdopodobnie nie dotyczy samego pliku multimedialnego, lecz warstwy DNS, TLS, proxy, zapory sieciowej lub routingu do serwera nadrzędnego.

Przewodnik ZimaSpace dotyczący diagnozowania połączenia lokalnego i zdalnego wyjaśnia, dlaczego dostęp przez sieć LAN i przez internet to dwa różne testy. Zanim ponownie zainstalujesz aplikację mobilną lub przebudujesz serwer, sprawdź w ten sposób działanie Immich.

Jeśli obie ścieżki zawodzą w ten sam sposób, przestań zmieniać ustawienia proxy i sprawdź żądanie po stronie aplikacji. Jeśli zawodzi tylko połączenie przez proxy, zanotuj jego status, wynik TLS, odpowiedź serwera nadrzędnego i limit czasu. To porównanie przy zmianie jednej zmiennej zapobiega skierowaniu dochodzenia na niewłaściwą warstwę z powodu komunikatu klienta.

Traktuj kody statusu jako wskazówki, nie ostateczne rozstrzygnięcia

Klasy statusów HTTP pomagają określić, gdzie szukać problemu, ale nie wskazują automatycznie komponentu, który go spowodował. Kod 4xx często oznacza, że żądanie, uwierzytelnienie lub autoryzacja były nieprawidłowe; kod 5xx wskazuje, że komponent po stronie serwera nie mógł zrealizować żądania. Serwery proxy mogą zwrócić kod z obu tych klas, zanim żądanie dotrze do Immich.

Przewodnik po polach logów dostępu wskazuje kod statusu, ścieżkę URL, czas żądania, zdalny host i identyfikatory żądań jako przydatne pola diagnostyczne. Zapisz te wartości dla jednej nieudanej czynności zamiast przeglądać tysiące niezwiązanych wierszy.

Jeśli serwer proxy odnotuje błąd 502 lub przekroczenie limitu czasu bez odpowiadającego mu żądania Immich, prześledź ścieżkę do serwera nadrzędnego. Jeśli Immich zapisze żądanie w logu i zwróci deterministyczny kod 4xx, sprawdź uwierzytelnianie, uprawnienia lub treść żądania. Jeśli klient zgłasza błąd, ale wszystkie warstwy po stronie serwera zwracają kod 2xx, sprawdź analizowanie odpowiedzi przez klienta, lokalną pamięć podręczną lub kolejne żądania.

Skoreluj współczynnik błędów, opóźnienia i logi serwera na podstawie tego samego znacznika czasu

Jedno nieudane żądanie może być odosobnionym przypadkiem. Odtwórz tę czynność pięć do dziesięciu razy i zapisuj wskaźnik powodzenia oraz opóźnienie, obserwując jednocześnie odpowiednie logi serwera i serwera proxy. Jeśli liczba błędów rośnie przy dużym obciążeniu zasobów lub skokach liczby żądań w kolejce, serwer może być okresowo niedostępny, nawet jeśli druga próba się powiedzie.

Omówienie Better Stack dotyczące błędów i opóźnień jako wskaźników usług oddziela współczynnik błędów od opóźnień i ruchu. Takie ujęcie ułatwia odróżnienie pojedynczego nieprawidłowo sformułowanego żądania klienta od ścieżki serwera, która działa gorzej tylko pod obciążeniem.

Jeśli logi serwera zawierają ten sam wyjątek dla wielu klientów, uznaj problem za występujący po stronie serwera, dopóki nie zostanie to wykluczone. Jeśli serwer nie otrzymuje nieudanego żądania, sprawdź DNS, TLS, serwer proxy i połączenie sieciowe klienta. Jeśli tylko jeden klient wysyła żądanie o innym formacie, zaktualizuj go lub zresetuj po zabezpieczeniu wystarczających dowodów potwierdzających tę różnicę.

Wydaj ostateczną ocenę na podstawie testu 2 × 2

Użyj dwóch klientów i dwóch tras: przeglądarki w sieci lokalnej, przeglądarki zdalnej, urządzenia mobilnego w sieci lokalnej i urządzenia mobilnego zdalnego. Używaj tego samego konta i tego samego pliku testowego. Ta macierz pozwala odróżnić awarie związane z konkretnym klientem od awarii związanych z trasą oraz awarii serwera, które dotyczą wszystkich kombinacji.

Przyczyna po stronie klienta jest prawdopodobna, gdy jeden klient zawodzi na obu trasach, a drugi działa. Przyczyna związana z trasą jest prawdopodobna, gdy oba klienty zawodzą tylko na jednej trasie. Przyczyna po stronie serwera jest prawdopodobna, gdy wszystkie cztery kombinacje odtwarzają ten sam błąd aplikacji, a logi serwera wskazują tę samą nieudaną operację.

Po naprawieniu wskazanej warstwy uruchom ponownie wszystkie cztery testy i jednokrotnie zrestartuj dotknięty komponent. Zakończ, gdy pierwotny nieudany test przejdzie bez powodowania błędów w testach kontrolnych. Zgłoś problem wraz z macierzą, znacznikami czasu, kodami HTTP, fragmentami logów serwera i serwera proxy, wersjami klientów oraz jednym odtwarzalnym żądaniem zamiast ogólnego zrzutu ekranu.

Wsparcie i porady

Więcej do przeczytania

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.