Grafana dashboards#

Each 2i2c Hub is set up with a Prometheus server to generate metrics and information about activity on the hub, and each cluster of hubs has a Grafana deployment to ingest and visualize this data.

This section provides information for both engineers and non-engineers about where to find each of 2i2c Grafana deployments, how to get access and what to expect.

Logging in#

Each cluster’s Grafana deployment can be accessed at grafana.<cluster-name>.2i2c.cloud. For example, the Grafana for the community hubs running on our GCP project is accessible at grafana.pilot.2i2c.cloud. Checkout the list of all 2i2c running clusters and their Grafana here.

To access the Grafana dashboards you have two options:

  • Get Viewer access into the Grafana.

    This is the recommended way of accessing grafana if modifying/creating dashboards is not needed. To get access, ask a 2i2c engineer to enable GitHub authentication following Enable GitHub authentication for Grafana for that particular Grafana (if it’s not already) and allow you access.

  • Use a username and password to get Admin access into the Grafana.

    These credentials can be accessed using sops (see {ref tc:secrets:sops for how to set up sops on your machine). See Login to the cluster-specific grafana for how to find the credentials information.

The Central Grafana#

The Grafana deployment in the 2i2c cluster is “the 2i2c central Grafana” because it ingests data from all of the 2i2c clusters. This is useful because it can be used to access information about all the clusters that 2i2c manages from one central place.

The central Grafana is running at https://grafana.pilot.2i2c.cloud and you can use the two authentication mechanisms listed in the Logging in section above to access it.

The dashboards available at https://grafana.pilot.2i2c.cloud/dashboards are the default Grafana dashboards from JupyterHub. The following list provides some information about the structure of the dashboards folder in Grafana, but this info is subject to change based on how upstream repository changes. So more information about the metrics and graphs available can be found at jupyterhub/grafana-dashboards.

The JupyterHub Default Dashboards Grafana folder structure#

Navigating at https://grafana.pilot.2i2c.cloud/dashboards, shows a JupyterHub Default Dashboards where all the dashboards are available, each of the Grafana panels, being grouped in sub-folders (dashboards) based on the component they are monitoring:

  1. Cluster Information

Contains panels with different cluster usage statistics about things like: - nodes - memory - cpu - running users per hub in cluster

  1. Global Usage Dashboard

This dashboard contains information about the weekly active users we get on each of the clusters we manage.

  1. JupyterHub Dashboard

This is the place to find information about the hub usage stats and hub diagnostics, like

  • number of active users

  • user CPU usage distribution

  • user memory usage distribution

  • server start times

  • hub respone latency

There is also a Panel section about Anomalous user pods where pods with high CPU usage or high memory usage are tracked.

  1. NFS and Support Information

This provides info about the NFS usage and monitors things like CPU, memory, disk and network usage of the Prometheus instance.

  1. Usage Dashboard

This has information about the number of users using the cluster over various periods of time.

  1. Usage Report

This provides a report about the memory requests, grouped by username, for notebook nodes and dask-gateway nodes. It also provides a graph that monitors GPU requests per user pod.