Come capire se un errore di Immich proviene dal client o dal server

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

Per capire se un errore di Immich è lato client o lato server, ripeti la stessa azione cambiando una sola variabile e segui la richiesta non riuscita lungo il percorso.

Un banner nell'app mobile che segnala un «errore del server» può comunque dipendere dallo stato del client, da TLS, da un reverse proxy o da una richiesta che il server ha rifiutato correttamente. Analogamente, un problema che si verifica solo nel browser non dimostra che il browser sia guasto. Mantieni invariati account, contenuto e azione; confronta client e percorsi; poi usa i codici di stato e i log sincronizzati per individuare il primo livello in cui si verifica il problema.

Ripeti la stessa azione su un secondo client

Scegli un'azione riproducibile, come accedere, aprire un contenuto noto, caricare la stessa foto di piccole dimensioni o eseguire la stessa ricerca. Ripetila con lo stesso account in un browser e in un client mobile, senza cambiare percorso di rete. Registra l'ora esatta e il risultato di entrambi i tentativi.

Un recente resoconto su Immich, in cui un client Android non funzionava mentre venivano testati altri percorsi di accesso, illustra il valore del confronto tra client. La causa di una singola discussione non è generalizzabile, ma un risultato specifico di un client restringe notevolmente le possibili aree da controllare.

Se tutti i client non riescono a eseguire la stessa azione nello stesso momento, server, database, spazio di archiviazione o percorso di rete condiviso diventano le cause più probabili. Se non funziona solo un client mentre un altro riesce tramite lo stesso endpoint, controlla la versione del client, lo stato della cache, le autorizzazioni, l'attendibilità del certificato locale e la richiesta precisa che differisce.

Cambia percorso senza cambiare account o contenuto

Poi confronta un percorso locale affidabile con il normale percorso tramite reverse proxy, VPN, tunnel o accesso remoto. Usa lo stesso account e la stessa azione. Se l'accesso locale riesce ma quello remoto no, è improbabile che il problema riguardi il file multimediale stesso; è più probabile che dipenda dai livelli di DNS, TLS, proxy, firewall o instradamento upstream.

La guida ZimaSpace alla diagnosi dei percorsi locali e remoti spiega perché il successo sulla LAN e quello via Internet sono prove diverse. Applica questa distinzione a Immich prima di reinstallare un'app mobile o ricostruire il server.

Se entrambi i percorsi non funzionano nello stesso modo, smetti di modificare le impostazioni del proxy e controlla la richiesta lato applicazione. Se non funziona solo il percorso tramite proxy, registra lo stato del proxy, il risultato TLS, la risposta dell'upstream e il timeout. Questo confronto a variabile singola evita che un messaggio del client indirizzi l'indagine verso il livello sbagliato.

Usa i codici di stato come indizi, non come verdetti definitivi

Le classi di stato HTTP aiutano a capire dove cercare, ma non identificano automaticamente il componente che ha causato il problema. Un 4xx spesso indica che la richiesta, l'autenticazione o l'autorizzazione non erano valide; un 5xx indica che un componente lato server non è riuscito a soddisfare la richiesta. I proxy possono generare entrambe le classi prima che Immich riceva la richiesta.

La guida ai campi dei log di accesso indica il codice di stato, il percorso URL, il tempo di richiesta, l’host remoto e gli identificatori delle richieste come campi utili per la risoluzione dei problemi. Acquisisci questi valori per la singola azione che non riesce, invece di esaminare migliaia di righe non pertinenti.

Se il proxy registra un 502 o un timeout senza una richiesta Immich corrispondente, verifica il percorso upstream. Se Immich registra una richiesta e restituisce un 4xx deterministico, controlla l’autenticazione, le autorizzazioni o il contenuto della richiesta. Se il client segnala un errore ma tutti i livelli lato server mostrano un 2xx, controlla l’analisi della risposta da parte del client, la cache locale o le richieste successive.

Correla il tasso di errore, la latenza e i log del server allo stesso orario

Una richiesta non riuscita può essere un caso isolato. Ripeti l’azione da cinque a dieci volte e registra la percentuale di successo e la latenza, controllando i log pertinenti del server e del proxy. Se gli errori aumentano in presenza di pressione sulle risorse o picchi nelle code, il server potrebbe non essere disponibile in modo intermittente, anche se un secondo tentativo riesce.

La panoramica di Better Stack su errori e latenza come segnali del servizio distingue il tasso di errore da latenza e traffico. Questo approccio aiuta a distinguere una singola richiesta del client non valida da un percorso del server che peggiora solo sotto carico.

Se i log del server contengono la stessa eccezione per più client, considera il problema lato server finché non viene dimostrato il contrario. Se il server non riceve mai la richiesta non riuscita, verifica DNS, TLS, proxy e rete del client. Se solo un client genera una richiesta con una struttura diversa, aggiorna o reimposta quel client dopo aver raccolto prove sufficienti per confermare la differenza.

Formula il giudizio finale con un test a doppia entrata

Usa due client e due route: browser in locale, browser da remoto, dispositivo mobile in locale e dispositivo mobile da remoto. Mantieni lo stesso account e lo stesso asset di test. Questa matrice distingue i problemi specifici di un client da quelli specifici di una route e dai problemi del server che riguardano tutte le combinazioni.

L’ipotesi di un problema del client è supportata quando un client fallisce su entrambe le route mentre un altro le supera. L’ipotesi di un problema della route è supportata quando entrambi i client falliscono solo attraverso una route. L’ipotesi di un problema del server è supportata quando tutte e quattro le combinazioni riproducono lo stesso errore applicativo e i log del server mostrano la stessa operazione non riuscita.

Dopo aver corretto il livello individuato, esegui di nuovo tutte e quattro le celle e riavvia una volta il componente interessato. Fermati quando la cella che aveva originariamente fallito supera il test senza compromettere i controlli. Per l’escalation, invia la matrice, le indicazioni temporali, i codici di stato HTTP, estratti dei log del proxy e del server, le versioni dei client e una richiesta riproducibile, non un semplice screenshot generico.

Assistenza e consigli

Altre letture

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.