diff --git a/docs/source/admin/log-messages.md b/docs/source/admin/log-messages.md index 1970ad8d..cda307df 100644 --- a/docs/source/admin/log-messages.md +++ b/docs/source/admin/log-messages.md @@ -8,19 +8,20 @@ log messages, what they mean and what are the most common causes that generated ### Example -Your log might display lines that seem cryptic +Your logs might be littered with lines that look scary ``` [W 2022-03-10 17:25:19.774 JupyterHub base:1349] Failing suspected API request to not-running server: /hub/user//api/metrics/v1 ``` -### Most likely cause +### Cause -The possible reason may be 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 you shut +This likely means 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 you shut the server down via one. -The other possible reason could be that you closed your laptop and the server was culled for inactivity, then reopened the laptop! +Another possible reason could be that you closed your laptop and the server was culled for inactivity, then reopened the laptop! However, the client-side code (JupyterLab, Classic Notebook, etc) doesn't interpret the shut-down server 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