Event logging and telemetry#

JupyterHub can be configured to record structured events from a running server using Jupyter’s Events System. The types of events that JupyterHub emits are defined by JSON schemas listed at the bottom of this page.

How to emit events#

Event logging is handled by its EventLogger object. This leverages Python’s standing logging library to emit, filter, and collect event data.

To begin recording events, you’ll need to set at least one configuration option:

EventLogger.handlers: tells the EventLogger where to route your events. This trait is a list of Python logging handlers that route events to e.g. an event log file.

Here’s a basic example:

import logging

c.EventLogger.handlers = [
    logging.FileHandler('event.log'),
]

The output is a file, "event.log", with events recorded as JSON data.

Event schemas#

JupyterHub server events

Changed in version 5.0: JupyterHub 5.0 changes from the deprecated jupyter-telemetry to jupyter-events.

The main changes are:

EventLog configuration is now called EventLogger
The hub.jupyter.org/server-action schema is now called https://schema.jupyter.org/jupyterhub/events/server-action