Log-Viewer

Wenn Ihr Server startet, werden Sie zu einem Ladebildschirm weitergeleitet, der den Fortschritt des Startvorgangs anzeigt. Am unteren Rand dieses Bildschirms finden Sie einen Link zu Ihren Server-Logs.

Falls Ihr Server nicht startet oder länger als erwartet benötigt, öffnet ein Klick auf den logs-Link eine Seite mit detaillierten Log-Meldungen Ihres Servers. Diese Logs können Ihnen helfen zu verstehen, was schiefgelaufen ist. Zum Beispiel, ob der Server nicht genügend Arbeitsspeicher hatte, ein Speicherproblem aufgetreten ist oder das ausgewählte Notebook-Image nicht geladen werden konnte.

Die Logs-Seite wird alle 10 Sekunden automatisch aktualisiert, sodass Sie die Browser-Seite nicht manuell aktualisieren müssen.

Verwendung¶

1. Suchen Sie auf dem Ladebildschirm nach der Meldung am unteren Rand: „If you have a problem with your server, you can check your logs for more information."
2. Klicken Sie auf den Link logs. Es öffnet sich eine neue Seite mit den aktuellen Log-inträgen Ihres Server-Pods.
3. Die Logs-Seite wird alle 10 Sekunden automatisch aktualisiert, sodass Sie sie nicht manuell aktualisieren müssen.
4. Die neuesten Logs werden unten angezeigt. Standardmäßig scrollt die Seite automatisch zum neuesten Log-Eintrag.
5. Wenn Sie ältere Logs einsehen möchten, deaktivieren Sie „Auto-scroll to latest log“.
6. Oben auf der Seite finden Sie Ihren Benutzernamen und den Namen des Server-Pods. Bitte geben Sie den Namen des Server-Pods an, wenn Sie sich an den Support wenden.
7. Suchen Sie nach Zeilen, die ERROR, WARNING, Traceback oder No space left on device enthalten. Diese können zur Klärung des Problems beitragen. Einige Warnungen und Meldungen auf Infrastrukturebene dienen lediglich der Information und geben nicht unbedingt Aufschluss über die Ursache des Startfehlers.

Häufige Probleme¶

• Image-Pull-Fehler: Das ausgewählte Notebook-Image konnte nicht heruntergeladen werden. Versuchen Sie es später erneut oder wählen Sie ein anderes Image aus.
• Speicherprobleme: Ihr Home-Verzeichnis ist möglicherweise voll. Wenn Ihr regulärer Server noch startet, löschen oder verschieben Sie Dateien, um Speicherplatz freizugeben. Falls der Server nicht startet, nutzen Sie den Rettungsmodus, um auf Ihr Home-Verzeichnis zuzugreifen und Speicherplatz freizugeben.
• Ressourcenlimits: Der Server konnte aufgrund unzureichender Ressourcen nicht gestartet werden. Falls auf der Spawn-Seite verfügbar, versuchen Sie, weniger CPUs oder weniger Arbeitsspeicher auszuwählen.
• Konflikte mit vom Benutzer installierten Paketen: In Ihrem Home-Verzeichnis installierte Pakete, insbesondere Jupyter-Kernpakete, die mit pip install --user installiert wurden, können die von JupyterHub bereitgestellten Versionen überschreiben und verhindern, dass der Server korrekt gestartet wird. Siehe Fehlerbehebung bei vom Benutzer installierten Jupyter-Paketen. Wenn Sie Ihren regulären Server nicht starten können, verwenden Sie den Rescue Mode, um auf Ihr Home-Verzeichnis zuzugreifen und es zu reparieren.

Wissenswertes¶

• Logs sind für die letzten 50 Minuten verfügbar, auch wenn Ihr Server bereits gestoppt wurde.
• Wenn auf der Logs-Seite die Meldung „No logs found for this pod in the selected time window“ angezeigt wird, ist Ihr Server möglicherweise noch nicht lange genug gelaufen, um Log-Einträge zu erzeugen. Versuchen Sie, ihn erneut zu starten, und überprüfen Sie die Logs nach einigen Sekunden.
• Wenn auf der Logs-Seite die Meldung „Could not query the log backend“ angezeigt wird, ist die Log-Funktion möglicherweise derzeit nicht verfügbar. Dies bedeutet nicht zwangsläufig, dass Ihr Server keine Logs erzeugt hat.
• Falls Sie das Problem nicht selbst beheben können, geben Sie bitte den Namen des Server-Pods und relevante Protokollausgaben an, wenn Sie sich an den Support wenden. So können wir Ihnen schneller helfen. Geben Sie keine Passwörter, Tokens, Cookies oder andere sensible Informationen an.