jupyterhub - jupyterhub 的日志在哪里？

Question

重要提示:我通过访问我雇主的 jupyterhub 网站并登录来使用 Jupyter notebooks。我实际上从未运行过 jupyterhub命令行上的命令。

我提前提到这一点是因为我在 jupyterhub 上在线找到的很多信息都假定用户在某个时候运行 jupyterhub命令，但我从不这样做，根据公司 SOP。请在发布答案时牢记这一点。

---

我刚刚发现，经过 小时 的故障排除和挠头，特定的 conda 虚拟环境/内核没有出现在扩展 New 按钮是一个 kernel.json 文件中的 1 个字符拼写错误。

就用户(我)而言，jupyterhub 启动过程顺利。

实际上，这个小错字导致了这个候选内核的整个处理过程悄无声息地中止了。

一个简单的警告就可以节省我数小时的工作时间。

下一个最好的事情是能够检查 jupyterhub 在这种情况下可能产生的任何日志消息。

---

是否 jupyterhub保留日志？

假设第一个问题的答案是"is"，我有几个后续问题:

• 如何查看此日志？
• 有没有办法使此日志(如果存在)尽可能详细？
• 是否可以让日志消息也直接显示在网络界面上？

Answer 1

TL;DR:JupyterHub 不保留日志。日志消息打印到 stdout/stderr 并且必须在一个文件，最好使用重定向。

隐藏在我看到的jupyterhub_config.py文件中:

## DEPRECATED: use output redirection instead, e.g.
#  
#  jupyterhub &>> /var/log/jupyterhub.log
#  Default: ''
# c.JupyterHub.extra_log_file = ''

还要注意这个 GitHub issue comment从 2017 年开始

If you want logging to a file, output redirection is a more robustapproach that works for JupyterHub, as well as every other program:

jupyterhub &>> /var/log/jupyterhub.log This will capture all outputfrom jupyterhub and its subprocesses, including the proxy andsingle-user servers.

Or, if you are using systemd/supervisor/etc. to launch your process,there is always a stdout/stderr capture option, which is the right wayto go.

看起来 Jupyter 只是将其消息打印到 stdout/stderr，管理员有责任将消息保存到日志文件中。

正在关注 this other GitHub issue comment通过修改，我可以在运行 systemd(例如现代 Debian、Ubuntu)的 Linux 系统上启动 JupyterHub，如下所示:

1. 使用以下内容创建文件 /lib/systemd/system/jupyterhub.service:

[Unit]
Description=Jupyterhub

[Service]
User=root
ExecStart=/usr/local/bin/jupyterhub -f /etc/jupyterhub/jupyterhub_config.py

[Install]
WantedBy=multi-user.target

1. 重新加载 systemctl 守护进程，然后您可以像往常一样启动/停止服务:

sudo systemctl daemon-reload
sudo service jupyterhub start

现在获得奖励:您可以使用命令 sudo journalctl -u jupyter 查看 JupyterHub 日志。

由于所有这些魔法都需要 sudo 权限，因此您想与您雇主的 IT 部门/系统管理员交谈以像这样设置 JupyterHub。您的用户必须是 systemd-journal 组的成员才能查看所有日志。