mirror of
https://github.com/jupyterhub/jupyterhub.git
synced 2025-10-09 11:03:00 +00:00
71 lines
3.4 KiB
Markdown
71 lines
3.4 KiB
Markdown
# Interpreting common log messages
|
|
|
|
In this subsection of the documentation, you will get to understand the meaning of common log messages and how to resolve them. When debugging errors and outages, it is very helpful to look at the logs emitted by JupyterHub.
|
|
|
|
## Failing suspected API request to not-running server
|
|
|
|
### Example
|
|
|
|
When your screen displays the log message as shown below, you need not to get scared.
|
|
|
|
```
|
|
[W 2022-03-10 17:25:19.774 JupyterHub base:1349] Failing suspected API request to not-running server: /hub/user/<user-name>/api/metrics/v1
|
|
```
|
|
|
|
### Cause
|
|
|
|
This likely cause is that the user's server has stopped running but they
|
|
still have a browser tab open. For example, you might have 3 tabs open, and shut
|
|
your server down via one. Or you closed your laptop, your server was
|
|
culled for inactivity, and then you reopen your laptop again! The
|
|
client side code (JupyterLab, Classic Notebook, etc) does not know
|
|
yet that the server is dead, and continues to make some API requests.
|
|
JupyterHub's architecture means that the proxy routes all requests that
|
|
don't go to a running user server to the hub process itself. The hub
|
|
process then explicitly returns a failure response, so the client knows
|
|
that the server is not running anymore. This is used by JupyterLab to
|
|
tell you your server is not running anymore, and offer you the option
|
|
to let you restart it.
|
|
|
|
Most commonly, you'll see this in reference to the `/api/metrics/v1`
|
|
URL, used by [jupyter-resource-usage](https://github.com/jupyter-server/jupyter-resource-usage).
|
|
|
|
### Actions you can take
|
|
|
|
This log message is benign, and there is usually no action for you to take.
|
|
|
|
## JupyterHub Singleuser Version mismatch
|
|
|
|
### Example
|
|
|
|
```
|
|
jupyterhub version 1.5.0 != jupyterhub-singleuser version 1.3.0. This could cause failure to authenticate and result in redirect loops!
|
|
```
|
|
|
|
### Cause
|
|
|
|
JupyterHub requires the `jupyterhub` python package installed inside the image or
|
|
environment the user server starts in. This message indicates that the version of
|
|
the `jupyterhub` package installed inside the user image or environment is not
|
|
the same version as the JupyterHub server itself. This is not necessarily always a
|
|
problem - some version drift is mostly acceptable, and the only two known cases of
|
|
breakage are across the 0.7 and 2.0 version releases. In those cases, issues pop
|
|
up immediately after upgrading your version of JupyterHub, so **always check the JupyterHub
|
|
changelog before upgrading!**. The primary problems this _could_ cause are:
|
|
|
|
1. Infinite redirect loops after the user server starts
|
|
2. Missing expected environment variables in the user server once it starts
|
|
3. Failure for the started user server to authenticate with the JupyterHub server -
|
|
note that this is _not_ the same as _user authentication_ failing!
|
|
|
|
However, for the most part, unless you are seeing these specific issues, the log
|
|
message should be counted as a warning to get the `jupyterhub` package versions
|
|
aligned, rather than as an indicator of an existing problem.
|
|
|
|
### Actions you can take
|
|
|
|
Upgrade the version of the `jupyterhub` package in your user environment or image
|
|
so it matches the version of JupyterHub running your JupyterHub server! If you
|
|
are using the [zero-to-jupyterhub](https://z2jh.jupyter.org) helm chart, you can find the appropriate
|
|
version of the `jupyterhub` package to install in your user image [here](https://jupyterhub.github.io/helm-chart/)
|