Anzeichen dafür, dass eine Immich-Datenbank gewartet oder ersetzt werden muss

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Eine lediglich langsame Immich-Datenbank benötigt möglicherweise routinemäßige PostgreSQL-Wartung oder eine Ressourcenanpassung. Bei wiederholten Integritäts- oder Wiederherstellungsfehlern muss die Datenbank möglicherweise aus einem verifizierten Backup wiederhergestellt oder ersetzt werden.

Verwende „Datenbank neu erstellen“ nicht als allgemeine Lösung für Leistungsprobleme. Unterscheide zunächst zwischen normalem Wachstum, Bloat, veralteten Statistiken, blockierter Wartung und Speicherlatenz einerseits sowie Beschädigung oder einem nicht wiederherstellbaren Clusterzustand andererseits. Sichere vor eingreifenden Arbeiten einen Wiederherstellungspunkt, nimm jeweils nur eine Wartungsänderung vor und greife nur dann auf eine saubere Wiederherstellung zurück, wenn die vorliegenden Hinweise zeigen, dass der aktuellen Datenbank nicht zu trauen ist oder sie sich nicht sicher reparieren lässt.

Leistungsabfall von Integritätsproblemen unterscheiden

Beginne mit dem genauen Symptom: langsame Suchvorgänge, langsame Timeline-Abfragen, eine große Datenbank, hohe Festplattenaktivität, wiederholte PostgreSQL-Fehler, Schleifen bei der Absturzwiederherstellung oder eine Immich-Migration, die nicht abgeschlossen werden kann. Leistungssymptome und Integritätssymptome bergen unterschiedliche Risiken und sollten nicht mit derselben ersten Reparatur angegangen werden.

Vergewissere dich, dass der Host weiterhin über intakten Speicher und genügend freien Speicherplatz verfügt, sich der Arbeitsspeicher normal verhält und kein Immich-Hintergrundauftrag außer Kontrolle geraten ist, bevor du PostgreSQL die Schuld gibst. Ein ausgelastetes oder ausfallendes Laufwerk kann eine intakte Datenbank langsam erscheinen lassen und bei unzuverlässigem Speicher auch tatsächlich Datenbankschäden verursachen.

Sichere Protokolle, Datenbankversion, Erweiterungsversionen, den jüngsten Upgrade-Verlauf und ein Backup oder einen Snapshot, bevor du eingreifende Wartungsarbeiten durchführst. Wenn die einzige Datenbankkopie möglicherweise beschädigt ist, führe keine destruktive Bereinigung durch, nur um zu sehen, ob der Fehler danach verschwindet. Bewahre die Informationen auf, die für eine kontrollierte Entscheidung über die Wiederherstellung nötig sind.

Nach messbaren Anzeichen für Wartungsbedarf suchen

Regelmäßige Wartung ist ein plausibler Ansatz, wenn die Datenbank startet und intern weiterhin nutzbar ist, sich aber die Abfrageleistung oder der Speicherbedarf mit der Zeit verschlechtert. Aussagekräftige Hinweise sind beispielsweise eine zunehmende Zahl veralteter Zeilen, Tabellen oder Indizes, die überproportional wachsen, ein Autovacuum, das nicht mehr hinterherkommt, veraltete Planerstatistiken oder lang laufende Wartungsarbeiten, die durch andere Sitzungen blockiert werden.

Tote Tupel, Aufblähung, Druck durch das Einfrieren von Transaktions-IDs, blockiertes VACUUM und eine unzureichende Häufigkeit von VACUUM können sich auf die Wartung und Abfrageleistung von PostgreSQL auswirken. Nutzen Sie VACUUM-Signale auf Tabellenebene über einen längeren Zeitraum, statt allein aus einer großen Datenbankdatei zu schließen, dass die Datenbank ersetzt werden muss.

Wenn Statistiken auf eine bestimmte Tabelle oder einen Index hindeuten, wählen Sie für diesen Befund die am wenigsten invasive, unterstützte Wartungsmaßnahme und messen Sie anschließend erneut. Greifen Sie nicht sofort zu VACUUM FULL, umfassenden REINDEX-Vorgängen oder willkürlichen Autovacuum-Einstellungen für den gesamten Cluster. Diese Maßnahmen können Sperren, I/O-Last oder zusätzlichen Speicherbedarf verursachen und beheben möglicherweise nicht den tatsächlichen Engpass.

Prüfen, ob Aufblähung oder Indexwachstum mit dem langsamen Vorgang zusammenhängt

Vergleichen Sie die an langsamen Immich-Vorgängen beteiligten Objekte mit der Größe von Tabellen und Indizes, der Änderungshäufigkeit von Zeilen und dem Abfrageverhalten. Aufblähung ist relevant, wenn sie den Aufwand für das Auffinden nützlicher Zeilen erhöht oder Indizes weniger effektiv macht. Die Datenbank kann aber auch einfach deshalb groß sein, weil die Bibliothek und die Metadaten umfangreich sind.

Die Aufblähung von Tabellen und Indizes sollte getrennt bewertet werden, da übermäßige Aufblähung den Abfrageaufwand erhöhen kann, ohne auf eine Beschädigung der Datenbank hinzudeuten. Nutzen Sie Messungen der PostgreSQL-Aufblähung, um ein beobachtetes Objekt gezielt zu prüfen, und aktualisieren Sie bei Bedarf die Planerstatistiken, statt die Gesamtgröße der Datenbank als Diagnose zu betrachten.

Führen Sie nach der Wartung dieselbe Immich-Aktion, die zuvor langsam war, erneut aus und vergleichen Sie sowohl die für Benutzer wahrnehmbare Latenz als auch das Verhalten von Datenbank und Speicher. Verbessert sich der Vorgang nicht, setzen Sie die vorherige Optimierung nach Möglichkeit zurück und untersuchen Sie Speicher, Abfragemuster, Hintergrundaufgaben oder Ursachen auf Anwendungsebene, statt weitere Datenbankänderungen vorzunehmen.

Single board computer zimaboard2

Auf Wiederherstellung oder Ersatz umsteigen, wenn die Integrität ungewiss ist

Ein Austausch ist gerechtfertigt, wenn es Belege dafür gibt, dass dem aktuellen PostgreSQL-Zustand nicht vertraut werden kann oder er sich nicht sicher wiederherstellen lässt, nicht allein wegen seines Alters. Beispiele sind wiederholt auftretende Seiten- oder Prüfsummenbeschädigungen, Start- oder Wiederherstellungsfehler, die trotz intaktem Speicher bestehen bleiben, ein beschädigter Cluster nach einem unvollständigen Speicherereignis oder ein Migrationszustand, der sich nicht über den unterstützten Weg reparieren lässt.

Bevor Sie die Datenbank als verloren betrachten, weisen Sie nach, dass sich eine bekanntermaßen intakte Sicherung in einer sauberen, kompatiblen PostgreSQL-Umgebung wiederherstellen lässt und Immich sie lesen kann. Wenn die saubere Wiederherstellung funktioniert, während der aktuelle Cluster denselben Integritätsfehler wiederholt, haben Sie eine deutlich bessere Grundlage dafür, den Datenbankzustand zu ersetzen, statt weiter an Ort und Stelle zu reparieren.

Reparieren Sie lokale, reversible Fehler und erhalten Sie dabei unsichere persistente Daten. Setzen Sie das System nur dann neu auf, wenn die Wiederherstellungsquelle überprüft wurde und das Ziel reproduzierbar ist. Wenden Sie diese Abgrenzung zwischen Reparatur und Neuaufsetzen von Immich auch auf die Datenbank an. „Austausch“ sollte bedeuten, einen kompatiblen PostgreSQL-Zustand aus einer bekanntermaßen intakten Quelle wiederherzustellen, und nicht, die Datenbank zu wechseln, weil eine Abfrage langsam geworden ist.

Datenbank anhand von Lese-, Schreib- und Sicherungsvorgängen überprüfen

Unabhängig davon, ob Sie Wartungsarbeiten durchgeführt oder eine saubere Datenbank wiederhergestellt haben: Überprüfen Sie das Ergebnis in Immich, statt es bei einem erfolgreichen PostgreSQL-Start zu belassen. Öffnen Sie alte Alben und Assets, führen Sie Suchvorgänge aus, laden Sie repräsentative Videos und prüfen Sie, ob Benutzer und Freigaben wie erwartet angezeigt werden.

Führen Sie einen sicheren neuen Schreibvorgang aus, beispielsweise indem Sie ein entbehrliches Asset hochladen, und bestätigen Sie, dass es nach einem normalen Neustart des Dienstes weiterhin zugänglich ist. Überwachen Sie die PostgreSQL- und Immich-Protokolle auf wiederkehrende Integritäts-, Migrations-, Erweiterungs- oder Berechtigungsfehler, während Lese- und Schreibvorgänge aktiv sind.

Erstellen Sie abschließend mit Ihrer üblichen Methode eine aktuelle Datenbanksicherung und testen Sie nach Möglichkeit die Wiederherstellung auf einem isolierten Zielsystem. Die Wartungs- oder Austauschentscheidung ist erst dann abgeschlossen, wenn das aktuelle System nutzbar ist und der nächste Wiederherstellungspunkt nachweislich in einem besseren Zustand ist als der Zustand, der den Vorfall ausgelöst hat.

Support und Tipps

Mehr zum Lesen

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.