Wanneer is een Immich-waarschuwing veilig om in de gaten te houden, en wanneer moet je stoppen?

Eva Wong is de Technisch Schrijver en en vaste knutselaar bij ZimaSpace. Een levenslange geek met een passie voor homelabs en open-source software, zij is gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva gelooft dat zelf-hosting leuk moet zijn, niet intimiderend. Met haar tutorials stelt ze de community in staat om hardware-setup te ontrafelen, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Een Immich-waarschuwing is veilig om te monitoren wanneer deze binnen de perken blijft, de betreffende bewerking nog steeds wordt voltooid, nuttig werk doorgaat en er geen aanwijzingen zijn voor problemen met de database, het bestandssysteem, een mount of het geheugen. Stop met nieuwe schrijfbewerkingen wanneer dezelfde waarschuwing zich herhaalt in combinatie met mislukte bewerkingen, verdwijnende opslag, OOM-kills, databaseherstelfouten of snel toenemende druk op resources.

Het woord “waarschuwing” bepaalt niet wat je moet doen. Zowel een onschadelijk bericht over een nieuwe poging als een bericht “geen ruimte meer op het apparaat” kan tijdens een drukke import verschijnen, maar ze brengen zeer verschillende risico’s met zich mee. Noteer de eerste tijdstempel, de exacte bewerking, het betreffende item of de betreffende taak en de status van de opslag en containers voordat je iets opnieuw start.

Classificeer de waarschuwing aan de hand van de bewerking die hierdoor kan mislukken

Begin met één concrete gebruikersactie: upload een testfoto, open een oud item, voer één zoekopdracht uit of observeer de achtergrondtaak die het bericht heeft veroorzaakt. Koppel het tijdstip van de waarschuwing aan de logs van de Immich-server, machine-learningservice, PostgreSQL, reverse proxy en opslag. De vraag is of de waarschuwing hoort bij een geslaagd verzoek, een verzoek waarvoor opnieuw wordt geprobeerd of een mislukte schrijfbewerking.

Een gids voor logniveaus is een nuttig uitgangspunt: WARN betekent doorgaans een onverwachte toestand waar de applicatie mogelijk nog van kan herstellen, terwijl ERROR duidt op een mislukte bewerking. Bij het oplossen van problemen met Immich moet je dat label echter koppelen aan het betreffende verzoek, schrijfpad of de betreffende afhankelijkheid voordat je bepaalt of verder gebruik veilig is.

Als dezelfde actie herhaaldelijk slaagt en het aantal waarschuwingen niet verder toeneemt, classificeer je dit als een monitoringsituatie totdat er nieuwe aanwijzingen zijn. Leg de normale frequentie en context vast, zodat je kunt vaststellen of een toekomstige versie, wijziging in een bibliotheek of capaciteitsprobleem het bericht vaker veroorzaakt. Eén geïsoleerd bericht zonder zichtbaar effect voor de gebruiker is geen voldoende reden om de stack opnieuw op te bouwen.

Het ZimaSpace-besliskader voor het repareren versus opnieuw opbouwen van Immich hanteert dezelfde grens: behoud de status en diagnosticeer een lokale fout voordat je een werkende implementatie vervangt. Een waarschuwing wordt belangrijker wanneer deze zich uitbreidt naar meer dan één bewerking of terugkomt nadat de bijbehorende oorzaak is verholpen.

Blijf monitoren zolang voortgang en status gezond blijven

Een waarschuwing die alleen monitoring vereist, heeft een stabiel bereik. De wachtrij blijft afnemen nadat nieuwe items niet meer binnenkomen, nieuwe pogingen slagen uiteindelijk, databasequery’s blijven normaal, de vrije ruimte blijft boven de operationele ondergrens, mounts blijven aanwezig en containers stapelen geen herstarts op. De voor de gebruiker zichtbare workflow moet binnen het normale bereik van latency en fouten blijven.

Test die grens in plaats van ervan uit te gaan. Herhaal dezelfde actie vijf keer, gebruik daarbij één ouder en één nieuw geüpload item en vergelijk het aantal waarschuwingen voor en na de test. Als een waarschuwing één keer verschijnt tijdens het laden van een model of een tijdelijke nieuwe poging voor een afhankelijkheid, maar de volgende pogingen probleemloos verlopen, documenteer je dit met de exacte versie en blijf je het volgen. Onderdruk of filter de waarschuwing niet voordat je weet wat deze betekent. Het stilzetten van een luidruchtige logregel verwijdert je uitgangswaarde en kan verbergen dat onschadelijke nieuwe pogingen veranderen in mislukte schrijfbewerkingen. Monitor de duur, frequentie, gerelateerde mislukte taken en de resource die het bericht noemt; die aspecten zijn nuttiger dan alleen ernstlabels.

Stop met nieuwe schrijfbewerkingen wanneer de waarschuwing een grens voor gegevensveiligheid bereikt

Stop uploads en achtergrondtaken wanneer waarschuwingen wijzen op een vol of alleen-lezen bestandssysteem, een ontbrekende verwachte mount, herhaalde herstel- of schrijffouten van PostgreSQL, OOM-kills van containers of een service die herhaaldelijk opnieuw start voordat transacties zijn voltooid. Bewaar logs en de huidige gegevenspaden voordat je ruimte vrijmaakt of eigenaarschap wijzigt.

Een databasegerelateerd bericht “geen ruimte meer op het apparaat” is geen gewone logruis. Een Immich-discussie over een storing beschreef problemen met de tijdlijn in combinatie met ruimtefouten van PostgreSQL tijdens een problematische implementatie.

De casus stelt geen universele hoofdoorzaak vast; hij laat zien waarom databasewaarschuwingen die met opslag te maken hebben onmiddellijk moeten worden onderzocht voordat meer schrijfbewerkingen worden geaccepteerd.

Pas dezelfde stopregel toe als de host onbeheersbaar begint te swappen, bestanden op een onverwachte lege mount verschijnen of nieuwe uploads in een beschrijfbare containerlaag terechtkomen omdat de bedoelde opslag niet is gemount. Doorgaan met schrijven kan een herstelbaar configuratieprobleem veranderen in een groter reconciliatieprobleem.

-15% OFF
Single board computer zimaboard2

Voer één omkeerbare oplossing uit en reproduceer de oorspronkelijke trigger

Corrigeer alleen de bevestigde oorzaak: herstel de bedoelde mount, maak veilig vrije ruimte vrij, verlaag de gelijktijdigheid van één taak, herstel een defecte afhankelijkheid of repareer een toegangsrechtenbeperking. Wis niet alle wachtrijen, verwijder geen databasebestanden, verwijder geen onbekende Docker-volumes en upgrade niet tegelijkertijd versies; daarmee vernietig je het bewijs dat nodig is om het resultaat te beoordelen.

Start indien nodig alleen de betreffende service opnieuw en herhaal vervolgens exact de trigger die de waarschuwing heeft veroorzaakt. Er is sprake van een geslaagde oplossing wanneer de gebruikersactie slaagt, de waarschuwing stopt of terugkeert naar de gedocumenteerde onschadelijke frequentie, wachtrijen leeglopen, opslag en geheugen gezond blijven en een tweede herstart de fout niet opnieuw veroorzaakt. Schakel over naar escalatie in plaats van verder te experimenteren wanneer het bericht na een schone reproductie blijft bestaan, de integriteit van de database onzeker is, vereiste bestanden verdwijnen of de eerste veilige reparatie de normale voortgang niet herstelt. Lever de exacte versies van Immich en PostgreSQL aan, samen met logs met tijdstempels, de status van het bestandssysteem, de herstart-/OOM-status van containers en één minimale reproductie, zodat de volgende stap zich op de falende laag kan richten.

Ondersteuning & Tips

Meer om te lezen

Dubbele taken of imports in Immich voorkomen
Sep 08, 2026

Dubbele taken of imports in Immich voorkomen

Scheid herhaalde taken van dubbele assets. Gebruik één canoniek ingestiepad, beheer retries en padwijzigingen en test vervolgens opnieuw invoeren op een kleine groep.

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.