Come capire se Immich è limitato da CPU, RAM, archiviazione o rete

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.

Individua cosa limita Immich riproducendo un carico di lavoro fisso per il caricamento, la navigazione, la ricerca o i job in background e mettendo in relazione il suo tasso di completamento con la saturazione della CPU, la pressione sulla memoria, la latenza dello storage e il throughput della rete nello stesso intervallo.

Una percentuale elevata, da sola, non indica un collo di bottiglia: la CPU al massimo può essere normale durante il machine learning, un uso elevato della RAM può dipendere dalla cache del filesystem e un caricamento lento può dipendere dal telefono o dal Wi-Fi. Misura il percorso dal client al container e all’host, rileva l’avanzamento della coda, poi modifica un solo vincolo sospetto e ripeti. La risorsa il cui alleggerimento migliora lo stesso carico di lavoro è il limite determinante.

Crea un test ripetibile e una cronologia

Scegli il sintomo che vuoi migliorare: l’importazione di un batch fisso di contenuti multimediali, l’apertura di originali non memorizzati nella cache, la generazione di miniature, l’esecuzione di Smart Search o la transcodifica di un video. Registra l’avvio, il primo risultato utilizzabile, il completamento, gli errori e l’avanzamento della coda dei job. Mescolare le attività produce grafici delle risorse senza fornire indicazioni utili.

L’indagine di un utente descrive un’implementazione di Immich insolitamente lenta e cerca riscontri su CPU, memoria, disco e rete. Il suo approccio diagnostico trasversale alle risorse è utile, ma il test con parametri fissi deve determinare la causa sul tuo server.

Ripeti una volta dopo che le cache si sono scaldate. Se la seconda esecuzione è molto più veloce, indica lo stato della cache anziché definire incoerente l’hardware. Se entrambe le esecuzioni si bloccano nella stessa fase, confronta quel timestamp con le metriche dell’host e del container e con il job responsabile.

Individua i segnali di CPU e memoria

La limitazione della CPU si manifesta con attività eseguibile sostenuta sui core interessati mentre il lavoro avanza in modo proporzionale; una concorrenza inferiore può migliorare la reattività, ma allungare i tempi di svuotamento della coda. Se un thread è al massimo mentre l’utilizzo totale della CPU sembra modesto, controlla la vista per processo e per core prima di presumere che ci sia capacità inutilizzata.

La limitazione della memoria richiede prove di pressione: swap in aumento, reclaim, major fault, arresti per OOM o riavvii dei container. Un uso elevato della memoria con cache stabile, senza swap e latenza normale non fa fallire il test. Ripeti con un worker a concorrenza inferiore o un modello più piccolo e confronta i tempi di completamento.

Un caso segnalato di Immich v2.5.5 relativo alle miniature ha consumato una quantità estrema di memoria in una specifica implementazione. La segnalazione sul consumo di memoria relativa a una versione specifica giustifica una verifica del job e della release interessati, ma non stabilisce un fabbisogno normale di RAM.

Distingui la latenza dello storage dal throughput della rete

Per lo storage, osserva la latenza del dispositivo, la profondità della coda, il throughput, lo spazio del filesystem e la disponibilità di inode mentre è in esecuzione il job specifico. Anche un throughput basso in megabyte al secondo può indicare un collo di bottiglia dello storage quando molte operazioni su database e miniature di piccole dimensioni sono in attesa su un disco ad alta latenza.

Per la rete, misura sia sul client sia sul server, poi confronta i percorsi locali e remoti. Un collegamento saturo, ritrasmissioni, nuovi tentativi Wi-Fi o un limite della VPN che coincidono con il trasferimento indicano un limite di rete. Se il traffico in upload termina ma l'elaborazione resta lenta, controlla invece la coda sul server.

La panoramica di ZimaSpace sui servizi su hardware meno recente fornisce un contesto per la pianificazione del sistema; questa diagnosi dovrebbe comunque basarsi sulla latenza e sulla velocità di elaborazione osservate, non sull'età dell'hardware.

Allenta un vincolo e verifica lo stesso carico di lavoro

Modifica una variabile sicura: riduci la concorrenza di un job, prova un limite di memoria temporaneo, sposta una copia dei dati attivi su uno storage più veloce oppure esegui un test su una rete locale cablata. Mantieni comparabili il dataset, le versioni e lo stato della cache. Il miglioramento sia nel completamento sia nella metrica prevista conferma il nesso causale.

Non acquistare hardware basandoti su una media a riposo o su un singolo picco. Vale la pena aggiornare una risorsa quando limita ripetutamente il carico di lavoro importante, una volta esclusi errori software, problemi di spazio libero e attività pianificate concorrenti.

Ripristina le modifiche che spostano il problema a un altro livello o allungano le code oltre l'obiettivo di servizio. Se il sistema si blocca senza che alcuna risorsa mostri segni di sovraccarico, segnala il problema includendo la definizione del carico di lavoro, i timestamp, le metriche per container, la latenza del disco, i test di rete, l'avanzamento delle code e i log; questo schema può indicare un blocco, un problema di dipendenze o un errore dell'applicazione.

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.