Zum Inhalt
flowplanDokumentationCommunityMarketplaceZur Startseite

Speicher und Betrieb

Fehlersuche im Betrieb

Was du prüfst, wenn eine laufende Instanz ohne Fehler neu startet, Litestream Fehler meldet oder zwei Container einen Datenordner teilen – und was in einen Fehlerbericht gehört.

5 Min. Lesezeit

Auf dieser Seite
  1. Neustarts ohne Fehler
  2. In Flowplan
  3. Mit Docker
  4. Litestream
  5. Zwei Container auf einem Datenordner
  6. Was in einen Fehlerbericht gehört

Mehr zum Thema: Betrieb und Fehlersuche · Überwachung und Wartung · Speicher, S3 und Sicherung · Coolify und Reverse Proxy

Probleme beim Einrichten (Anmeldung, Rechte, Proxy) stehen in der Tabelle zur Fehlersuche.

Neustarts ohne Fehler

Flowplan startet neu, im Log steht kein Fehler, und die Leute merken nur eine kurze Unterbrechung. Fang mit Flowplans eigener Aufzeichnung an, frag dann Docker und den Kernel.

In Flowplan

Administration → Überwachung → Neustarts Seit 0.10.0 listet jeden Neustart der letzten 30 Tage mit Grund (sauber beendet, Absturz, vermutlich Speicher voll, ohne Spur beendet), dem Speicher beim letzten Lebenszeichen und, bei einem unerwarteten, den letzten 200 Zeilen des Server- und Litestream-Logs vor dem Ende, mit Als .txt herunterladen. Was die Gründe bedeuten und wo ihre Grenzen liegen, steht unter Neustarts.

Mit Docker

# Warum der Container zuletzt endete und wie oft er neu startete
docker inspect --format 'OOMKilled={{.State.OOMKilled}} ExitCode={{.State.ExitCode}} RestartCount={{.RestartCount}} FinishedAt={{.State.FinishedAt}}' <container>
# Die letzten Healthchecks mit ihrer Ausgabe
docker inspect --format '{{json .State.Health}}' <container>
# Was in den letzten 24 Stunden mit dem Container geschah (die, oom, kill, health_status)
docker events --since 24h --until "$(date +%s)" --filter container=<container>
# Speicher und CPU jetzt, gegen die Grenze
docker stats --no-stream <container>
# Ob der Kernel einen Prozess wegen Speichermangels beendet hat
dmesg -T | grep -i oom
Du siehstBedeutet
OOMKilled=true, ExitCode=137Der Container hat seine eigene Speichergrenze erreicht, der Kernel hat ihn beendet. Grenze erhöhen oder finden, was wächst (unten, Litestream).
ExitCode=137 ohne OOMSIGKILL von außen: docker kill, kill -9 oder ein Stopp, der länger dauerte als die Wartezeit.
ExitCode=143 oder 0 nach docker stop/einem UpdateEin normaler Stopp (SIGTERM).
Health.Status unhealthy, FailingStreak steigt/api/health schlug mehrmals hintereinander fehl; Health.Log enthält die Antworten. Docker allein startet einen ungesunden Container nicht neu, ein Orchestrator vielleicht.
RestartCount steigtDie Neustart-Richtlinie holt den Container zurück; docker events zeigt, wann.
Out of memory: Killed process … (litestream) oder (node) in dmesgDer Kernel hat den Prozess beendet. Memory cgroup out of memory heißt: die Grenze des Containers; eine Zeile ohne cgroup (constraint=CONSTRAINT_NONE) heißt: der ganze Server hatte keinen Speicher mehr.

Der ganze Server hat keinen Speicher mehr. Ohne Speichergrenze am Container wählt der globale OOM-Killer des Kernels den größten Prozess auf dem Server – das kann Litestream sein, der erste Prozess im Container. OOMKilled bleibt dabei false, weil nicht die Grenze des Containers die Ursache war; und hat Docker den Container schon neu gestartet, zeigt docker inspect den neuen, laufenden Container (ExitCode=0), nicht wie der alte endete – das sagen docker events oder der Eintrag unter Neustarts. Flowplan führt den Neustart als „ohne Spur beendet“ oder, wenn beim letzten Lebenszeichen höchstens 5 % des Serverspeichers frei waren, als „vermutlich Speicher voll“. Sicher sagt es nur dmesg. Gib dem Container eine Speichergrenze oder lass dem Server genug Platz für Flowplan, Litestream und alles andere darauf; siehe Dimensionierung.

Litestream

Litestream repliziert die SQLite-Datenbank in den Bucket (nur mit S3 und ohne DATABASE_URL). Seine Zeilen im Log tragen level=…; die gespeicherte Kopie ist /app/data/logs/litestream.log.

Zeile im LogBedeutet
sync error … rename …ltx.tmp …: no such file or directoryZwei Litestream-Prozesse arbeiten auf derselben Datenbank – zwei Container auf einem Volume (unten).
compaction failed … level=1 … file checksum mismatch, alle 30 SekundenEine Änderungsdatei (LTX) von Litestream ist kaputt, lokal oder im Bucket – meist von so einer Überlappung. Die Datenbank selbst ist in Ordnung.

Solange die Zusammenfassung hängt, räumt Litestream seine Änderungsdateien nicht mehr auf: Sie stapeln sich lokal und im Bucket, und der Speicher von Litestream wächst weiter – bis der Kernel es beendet (siehe oben, der ganze Server ohne Speicher). Auch eine Wiederherstellung aus dem Bucket über die kaputte Datei bricht ab.

Flowplan repariert das selbst. Seit 0.10.0 Alle 15 Minuten prüft es den Bucket; eine hängende Replik bringt eine Warnung in Administration → Überwachung, eine Nachricht an die Administratoren und, nach einer geplanten Sicherung, eine Reparatur beim nächsten Neustart (Jetzt neu starten erledigt es sofort). FLOWPLAN_LITESTREAM_AUTOHEAL=off lässt nur die Warnung.

Die Reparatur ist eine Markierungsdatei /app/data/litestream-reset, die der nächste Start liest, bevor Litestream repliziert:

InhaltBewirkt
leer (touch)Setzt nur den lokalen Zustand zurück (.flowplan.sqlite-litestream); Litestream macht vom Bucket aus weiter.
remote als erste Zeile Seit 0.10.0Löscht zusätzlich <Präfix>/db/ im Bucket; Litestream beginnt neu mit einem vollständigen Snapshot. Geschrieben von der Selbstheilung und von Replik jetzt neu aufbauen.

Datenbank, Dateien und Sicherungen bleiben unberührt. Die Schritte, was das Log zeigt und was ohne laufenden Container zu tun ist, stehen unter Litestream-Zustand reparieren.

Zwei Container auf einem Datenordner

Mit SQLite darf auf einem Datenordner nur ein Container laufen. Jeder Container hält eine Sperre auf /app/data/.flowplan.lock Seit 0.10.0; ein zweiter, der sie belegt findet, antwortet trotzdem, startet kein Litestream und schreibt einen Block ins Log:

==========================================================================
Flowplan: ANOTHER CONTAINER IS USING THE DATA FOLDER /app/data.
  It holds /app/data/.flowplan.lock. Two Flowplan containers on one SQLite database must not overlap:
  …
==========================================================================

Administration → Überwachung zeigt auf beiden Containern die Warnung „Ein zweiter Flowplan-Container (Host) nutzt seit Zeit dasselbe Datenverzeichnis …“. Ein paar Sekunden während eines Updates deuten auf ein Ausrollen mit Überlappung; bleibt die Warnung, läuft eine zweite Ressource, Replica oder ein docker run auf demselben Volume. Such den anderen Container (docker ps, der Hostname in der Warnung) und stopp ihn. Wie du ohne Überlappung ausrollst, auch in Coolify, steht unter SQLite ohne Überlappung ausrollen.

Was in einen Fehlerbericht gehört

Eröffne ein Issue (öffnet in neuem Tab) mit:

  • der Versionszeile, der ersten Zeile, die Flowplan ins Log schreibt, z. B. Flowplan 0.10.0 (release, build abc1234, built …, Node.js …) (oder version aus /api/health mit dem Token);
  • bei einem Neustart der .txt des Eintrags aus Administration → Überwachung → Neustarts;
  • der Ausgabe der docker inspect-Zeilen oben und, falls vorhanden, den dmesg-Zeilen um den Zeitpunkt;
  • bei Litestream den ersten Fehlerzeilen im Log und ob S3 und S3_PREFIX gesetzt sind (nicht ihre Werte);
  • wie die Instanz läuft: Docker, Compose, Coolify, Kubernetes; SQLite oder PostgreSQL; Speichergrenze.
Achtung

Nie Geheimnisse posten: keine Schlüssel, Token, Passwörter, .env-Dateien und kein vollständiges docker inspect ohne --format – es listet jede Umgebungsvariable mit ihrem Wert. Flowplan schwärzt seine gespeicherten Log-Dateien (was geschwärzt wird), lies trotzdem jede Zeile, bevor du sie postest; docker logs ist nicht geschwärzt.

War das hilfreich?
JaDanke!
Nein – sag uns, was fehlt

Fehler gefunden oder etwas fehlt?Auf GitHub bearbeiten