Een Immich-database die alleen traag is, heeft mogelijk regelmatig PostgreSQL-onderhoud of een oplossing voor een resourceprobleem nodig; een database met terugkerende integriteits- of herstelfouten moet mogelijk worden teruggezet of vervangen aan de hand van een geverifieerde back-up.
Gebruik ‘de database opnieuw opbouwen’ niet als algemene oplossing voor prestatieproblemen. Maak eerst onderscheid tussen normale groei, bloat, verouderde statistieken, geblokkeerd onderhoud en opslaglatentie enerzijds, en beschadiging of een onherstelbare clusterstatus anderzijds. Bewaar een herstelpunt voordat je ingrijpend werk uitvoert, meet telkens één onderhoudswijziging en ga pas over op een schone herstelactie als uit de gegevens blijkt dat de huidige database niet te vertrouwen of veilig te repareren is.
Maak onderscheid tussen prestatieverlies en integriteitsproblemen
Begin met het exacte symptoom: trage zoekopdrachten, trage tijdlijnquery's, een grote database, hoge schijfactiviteit, terugkerende PostgreSQL-fouten, lussen van crashherstel of een Immich-migratie die niet kan worden voltooid. Prestatieproblemen en integriteitsproblemen brengen verschillende risico's met zich mee en vereisen niet dezelfde eerste herstelmaatregel.
Controleer voordat je PostgreSQL de schuld geeft of de host nog over gezonde opslag en voldoende vrije ruimte beschikt, zich normaal gedraagt qua geheugengebruik en geen op hol geslagen Immich-taak op de achtergrond uitvoert. Een overbelaste of defecte schijf kan een gezonde database traag laten lijken en ook daadwerkelijke databaseschade veroorzaken als de onderliggende opslag onbetrouwbaar wordt.
Bewaar logboeken, de databaseversie, extensieversies, de recente upgradegeschiedenis en een back-up of snapshot voordat je ingrijpend onderhoud uitvoert. Als de enige databasekopie mogelijk beschadigd is, voer dan geen destructieve opschoning uit om te kijken of de fout verdwijnt; bewaar de informatie die nodig is om een weloverwogen beslissing over herstel te nemen.
Let op meetbare onderhoudssignalen
Regelmatig onderhoud is een aannemelijke aanpak wanneer de database start en intern bruikbaar blijft, maar de queryprestaties of de benodigde schijfruimte na verloop van tijd verslechteren. Nuttige aanwijzingen zijn onder meer een toenemend aantal dode rijen, tabellen of indexen die onevenredig groeien, autovacuum dat het niet kan bijbenen, verouderde plannerstatistieken of langdurig onderhoud dat door andere sessies wordt geblokkeerd.
Dode tuples, bloat, druk door freezing, geblokkeerde VACUUM en onvoldoende vacuümfrequentie kunnen allemaal invloed hebben op het onderhoud en de queryprestaties van PostgreSQL. Gebruik in de loop der tijd VACUUM-signalen op tabelniveau in plaats van aan te nemen dat een groot databasebestand op zichzelf bewijst dat de database moet worden vervangen.
Als statistieken naar één tabel of index wijzen, kies dan de minst ingrijpende ondersteunde onderhoudsactie voor die bevinding en meet opnieuw. Grijp niet meteen naar VACUUM FULL, brede REINDEX-bewerkingen of willekeurige aanpassingen van autovacuum voor het hele cluster; zulke acties kunnen vergrendelingen, I/O-belasting of extra schijfruimte vereisen en pakken mogelijk niet het echte knelpunt aan.
Controleer of bloat of indexgroei overeenkomt met het trage pad
Vergelijk de objecten die betrokken zijn bij trage Immich-bewerkingen met de tabel- en indexgrootte, het verloop van rijen en het querygedrag. Bloat is relevant wanneer hierdoor meer werk nodig is om bruikbare rijen te vinden of indexen minder effectief worden, maar de database kan ook groot zijn simpelweg omdat de bibliotheek en metadata omvangrijk zijn.
Beoordeel tabel- en indexbloat afzonderlijk, omdat overmatige bloat het werk voor queries kan vergroten zonder dat dit op databasecorruptie wijst. Gebruik metingen van PostgreSQL-bloat om een waargenomen object gericht te controleren en vernieuw waar nodig de plannerstatistieken, in plaats van de totale databaseomvang als diagnose te beschouwen.
Voer na het onderhoud exact dezelfde trage Immich-actie opnieuw uit en vergelijk zowel de door de gebruiker ervaren vertraging als het gedrag van de database en opslag. Als de bewerking niet sneller wordt, herstel dan waar mogelijk de vorige afstemming en onderzoek de opslag, querypatronen, achtergrondtaken of oorzaken op applicatieniveau, in plaats van steeds meer wijzigingen aan de database door te voeren.
Schakel over op herstel of vervanging wanneer de integriteit onzeker is
Vervanging is gerechtvaardigd als er bewijs is dat de huidige PostgreSQL-status niet te vertrouwen is of niet veilig kan worden hersteld, niet alleen vanwege de leeftijd ervan. Voorbeelden zijn terugkerende pagina- of checksumcorruptie, opstart- of herstelfouten die blijven optreden op gezonde opslag, een beschadigd cluster na een onvolledig opslagincident of een migratiestatus die niet via de ondersteunde methode kan worden gerepareerd.
Voordat je de database als verloren beschouwt, moet je bewijzen dat een bekende goede back-up kan worden hersteld in een schone, compatibele PostgreSQL-omgeving en dat Immich die kan lezen. Als het schone herstel werkt terwijl het huidige cluster steeds dezelfde integriteitsfout vertoont, heb je een veel sterkere reden om de databasestatus te vervangen in plaats van ter plekke verder te repareren.
Repareer lokale, omkeerbare fouten met behoud van onzekere persistente gegevens; bouw alleen opnieuw op wanneer de herstelbron is gecontroleerd en het doel reproduceerbaar is. Pas die grens tussen reparatie en opnieuw opbouwen voor Immich ook toe op de database. ‘Vervanging’ moet betekenen dat je compatibele PostgreSQL-gegevens herstelt vanuit een bekende goede bron, niet dat je van database wisselt omdat een query traag werd.
Valideer de database met lees-, schrijf- en back-upbewerkingen
Of je nu onderhoud hebt uitgevoerd of een schone database hebt hersteld, valideer het resultaat via Immich in plaats van te stoppen zodra PostgreSQL succesvol is gestart. Open oude albums en bestanden, voer zoekopdrachten uit, laad representatieve video's en controleer of gebruikers en instellingen voor delen naar verwachting worden weergegeven.
Voer één veilige nieuwe schrijfactie uit, bijvoorbeeld door een tijdelijk bestand te uploaden, en controleer of het toegankelijk blijft nadat de service normaal opnieuw is gestart. Houd de PostgreSQL- en Immich-logboeken in de gaten op terugkerende integriteits-, migratie-, extensie- of toestemmingsfouten terwijl de lees- en schrijfpaden actief zijn.
Maak tot slot met je gebruikelijke methode een nieuwe databaseback-up en test, indien praktisch, het herstel ervan op een geïsoleerd doel. Het besluit om onderhoud uit te voeren of de database te vervangen is pas definitief wanneer het huidige systeem bruikbaar is en het volgende herstelpunt aantoonbaar gezonder is dan de toestand die tot het incident leidde.
Ondersteuning en tips
Meer om te lezen

Zo houd je pornofilms op je NAS verborgen voor gezinsleden
Houd video's voor volwassenen privé op een NAS voor het hele gezin. Controleer mapmachtigingen, toegang tot Plex- en Jellyfin-bibliotheken, miniaturen, kijkgeschiedenis, gedeelde tv-aanmeldingen en...

Wat je moet controleren voordat je een communitymodel in Transformers laadt
Gebruik de Transformers Jinja-sandboxupdate om de herkomst van modellen, chatsjablonen, externe code, geserialiseerde gewichten en geïsoleerde eerste uitvoeringen te controleren.

Voer Mirage lokaal uit: OCR en objectdetectie vanuit één afbeelding
Probeer het kleine lokale visiemodel van Cactus Compute, test OCR en objectextractie met echte invoer en krijg inzicht in de beperkingen op het gebied...



