Fehler finden und beheben: Logs, Neustart-Schleife und Neu installieren

Meldet ein Container ein Problem, zeigt die Übersicht Ihres Projekts einen Hinweis mit Lösungsschritten (Container-Hosting im Überblick). Die Schritte führen direkt zu den Logs, den Variablen oder dem Verlauf. Dieser Artikel erklärt die Werkzeuge im Einzelnen.

Logs lesen

Öffnen Sie den Container und wechseln Sie in den Reiter Logs. Sie sehen die letzten Ausgaben des Containers, die Ansicht aktualisiert sich automatisch.

• Zeilen - wie viele der letzten Zeilen angezeigt werden.
• Nur Warnungen & Fehler - blendet alle übrigen Zeilen aus. Fehler sind rot, Warnungen gelb hervorgehoben, darüber steht der jüngste Fehler.
• Für Support kopieren - kopiert die angezeigten Zeilen, damit Sie sie in ein Support-Ticket einfügen können.
• Bot-Scan · abgewiesen - Abrufe nach Dateien wie .env oder .git stammen von automatischen Suchprogrammen. Sie sind üblich, werden abgewiesen und sind harmlos.

Die Anwendung antwortet mit Status 500

Zeigt die Prüfkette der Web-Adresse „Antwortet mit Status 500", funktionieren Adresse, Zertifikat und Container - der Fehler liegt in der Anwendung. Häufigste Ursache ist eine abgelehnte Datenbank-Anmeldung, in den Logs etwa „Access denied for user". So gehen Sie vor:

1. Vergleichen Sie Benutzer, Passwort und Host in der Anwendung mit den Angaben im Datenbank-Container (Umgebungsvariablen und Geheimnisse).
2. Beachten Sie: Datenbank-Images übernehmen Zugangsdaten nur beim ersten Start. Ein später geändertes Passwort setzen Sie in der Datenbank selbst, zum Beispiel über die Konsole.
3. Prüfen Sie, ob beide Container in einem gemeinsamen Netz sind (Netze und Firewall).
4. Starten Sie die Anwendung nach der Änderung neu.

Neustart-Schleife

Beendet sich ein Container direkt nach dem Start, startet er immer wieder neu. Der Kundenbereich zeigt dann den Status Neustart-Schleife. Häufige Ursachen:

• Pflichtvariablen oder Zugangsdaten fehlen - viele Datenbank-Images verlangen zum Beispiel ein Root-Passwort.
• Ein eigener Startbefehl ist fehlerhaft.
• Der Container hat zu wenig Arbeitsspeicher.

Die genaue Ursache steht in den Logs, meist in den letzten Zeilen. Mit Stoppen halten Sie den Container jederzeit an, bis Sie die Einstellungen korrigiert haben.

Neu erstellen oder neu installieren?

Beide Aktionen finden Sie in den Einstellungen des Containers ganz unten:

• Neu erstellen lädt das Image erneut und legt den Container mit derselben Konfiguration neu an. Daten in Volumes bleiben erhalten. Das hilft, wenn der Container hängt oder Dateien im Image beschädigt sind.
• Neu installieren löscht alle Daten in den Volumes dieses Containers und richtet ihn wie beim ersten Start neu ein. Vorher legen wir automatisch einen Snapshot der Volumes dieses Containers an, über den Sie zurückkehren können. Zur Bestätigung tippen Sie den Namen des Containers ein und bestätigen mit Ihrer Anmeldung.

Darunter steht Container löschen. Welche Volumes dabei mit gelöscht werden, wählen Sie im Dialog - mehr dazu im Artikel Datenträger und Dateibrowser.

Verlauf der Vorgänge

Im Reiter Verlauf Ihres Projekts steht jeder Vorgang mit Zeitpunkt, Container, Ergebnis und wer ihn ausgelöst hat: Sie, der Support, das System oder das Monitoring. Mit den Filtern Offen und Fehlgeschlagen finden Sie schnell den Schritt, der nicht geklappt hat, samt Begründung.

Konsole im Browser

Mit der Option Konsole öffnen Sie auf der Seite eines Containers im Reiter Konsole eine Befehlszeile direkt im Container. So gehen Sie vor:

1. Klicken Sie auf Konsole starten und bestätigen Sie kurz Ihre Anmeldung, zum Beispiel per Passkey oder zweitem Faktor.
2. Geben Sie Ihre Befehle ein. Sie laufen direkt im Container.
3. Beenden Sie die Sitzung mit Trennen.

Sitzungen enden nach 30 Minuten ohne Eingabe, spätestens nach 4 Stunden. Je Projekt sind drei Sitzungen gleichzeitig möglich, Inhalte werden nicht aufgezeichnet. Änderungen außerhalb von Volumes gehen beim nächsten Neustart verloren.