Cómo saber si un error de Immich proviene del cliente o del servidor

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

Determina si un error de Immich se origina en el cliente o en el servidor repitiendo la misma acción y cambiando una sola variable, y sigue la solicitud fallida a lo largo de la ruta.

Un aviso en el móvil que dice «error del servidor» también puede deberse al estado del cliente, TLS, un proxy inverso o una solicitud que el servidor rechazó correctamente. Del mismo modo, un fallo que solo ocurre en el navegador no demuestra que el navegador esté averiado. Mantén la misma cuenta, el mismo archivo y la misma acción; compara clientes y rutas; luego usa los códigos de estado y los registros sincronizados para localizar la primera capa que falla.

Repite la misma acción en un segundo cliente

Elige una acción reproducible, como iniciar sesión, abrir un archivo conocido, subir la misma foto pequeña o ejecutar la misma búsqueda. Repítela con la misma cuenta en un navegador y en un cliente móvil, sin cambiar la ruta de red. Registra la hora exacta y el resultado de ambos intentos.

Un informe reciente de Immich en el que se probó un cliente de Android que fallaba junto con otras vías de acceso ilustra el valor de comparar varios clientes. La causa de un hilo no es necesariamente generalizable, pero un resultado específico de un cliente permite acotar considerablemente dónde buscar a continuación.

Si todos los clientes fallan al realizar la misma acción en el mismo momento, suben en la lista de posibles causas el servidor, la base de datos, el almacenamiento o una ruta de red compartida. Si solo falla un cliente y otro funciona a través del mismo punto de conexión, comprueba la versión del cliente, el estado almacenado en caché, los permisos, la confianza local en el certificado y la solicitud exacta que difiere.

Cambia la ruta sin cambiar la cuenta ni el archivo

A continuación, compara una ruta local de confianza con la ruta habitual a través de un proxy inverso, una VPN, un túnel o una conexión remota. Usa la misma cuenta y realiza la misma acción. Si funciona localmente pero falla de forma remota, es menos probable que el problema esté en el registro multimedia y más probable que esté en las capas de DNS, TLS, proxy, firewall o enrutamiento al servidor de origen.

La guía de ZimaSpace sobre el diagnóstico de rutas locales y remotas explica por qué el éxito en la LAN y el éxito a través de internet son pruebas distintas. Aplica esa distinción a Immich antes de reinstalar una aplicación móvil o reconstruir el servidor.

Si ambas rutas fallan de la misma manera, deja de cambiar la configuración del proxy e inspecciona la solicitud en la aplicación. Si solo falla la ruta del proxy, registra el estado del proxy, el resultado de TLS, la respuesta del servidor de origen y el tiempo de espera. Esta comparación con una sola variable evita que un mensaje del cliente lleve la investigación por el camino equivocado.

Usa los códigos de estado como pistas, no como veredictos definitivos

Las clases de códigos de estado HTTP ayudan a determinar dónde buscar, pero no identifican automáticamente el componente que causó el problema. Un código 4xx suele indicar que la solicitud, la autenticación o la autorización no eran aceptables; un código 5xx indica que un componente del servidor no pudo completar la solicitud. Los proxies pueden generar cualquiera de las dos clases antes de que Immich reciba la solicitud.

La guía de campos del registro de acceso destaca el código de estado, la ruta URL, el tiempo de solicitud, el host remoto y los identificadores de solicitud como campos útiles para solucionar problemas. Captura esos valores para la acción que falla, en lugar de revisar miles de líneas no relacionadas.

Si el proxy registra un 502 o un tiempo de espera agotado sin una solicitud correspondiente de Immich, sigue la ruta hacia el servidor de origen. Si Immich registra una solicitud y devuelve un 4xx determinista, revisa la autenticación, los permisos o el contenido de la solicitud. Si el cliente indica un fallo, pero todas las capas del servidor muestran un 2xx, revisa el análisis del cliente, la caché local o las solicitudes posteriores.

Correlaciona la tasa de errores, la latencia y los registros del servidor en una misma marca de tiempo

Una solicitud fallida puede ser un caso aislado. Repite la acción de cinco a diez veces y registra la tasa de éxito y la latencia mientras supervisas los registros relevantes del servidor y del proxy. Si los errores aumentan durante una presión sobre los recursos o picos en la cola, es posible que el servidor no esté disponible de forma intermitente, aunque un segundo intento tenga éxito.

La guía de Better Stack sobre los errores y la latencia como indicadores del servicio distingue la tasa de errores de la latencia y el tráfico. Este enfoque ayuda a diferenciar una única solicitud malformada del cliente de una ruta del servidor que se degrada solo bajo carga.

Si los registros del servidor contienen la misma excepción para varios clientes, considera que el problema está en el servidor hasta que se demuestre lo contrario. Si el servidor nunca recibe la solicitud fallida, rastrea DNS, TLS, el proxy y la red del cliente. Si solo un cliente genera una solicitud con un formato distinto, actualiza o restablece ese cliente después de conservar pruebas suficientes para confirmar la diferencia.

Emite el juicio final con una prueba de dos por dos

Usa dos clientes y dos rutas: navegador en local, navegador en remoto, móvil en local y móvil en remoto. Usa la misma cuenta y el mismo recurso de prueba. Esta matriz permite distinguir los fallos específicos del cliente de los específicos de la ruta y de los fallos del servidor que afectan a todas las combinaciones.

La causa está en el cliente si uno falla en ambas rutas mientras otro funciona. La causa está en la ruta si ambos clientes fallan solo en una de ellas. La causa está en el servidor si los cuatro reproducen el mismo error de aplicación y los registros del servidor muestran la misma operación fallida.

Tras corregir la capa identificada, vuelve a ejecutar las cuatro celdas y reinicia una vez el componente afectado. Detente cuando la celda que fallaba originalmente supere la prueba sin que fallen los controles. Escala el problema con la matriz, las marcas de tiempo, los estados HTTP, extractos de los registros del proxy y del servidor, las versiones de los clientes y una solicitud reproducible, en lugar de una captura de pantalla genérica.

Soporte y consejos

Más para leer

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.