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 describes how to use these dashboards for a cluster.
Access Hub Grafana Dashboards¶
The Grafana for each cluster can be accessed at
For example, the Grafana for community hubs running on our GCP project is accessible at
To access the Grafana dashboards you’ll need a username and password.
These can be accessed using
sops (see sops overview for how to set up
sops on your machine).
See Log in to the Grafana dashboard for how to find the credentials information.
Set up Grafana Dashboards for a cluster¶
This guide will walk through the steps required to setup a suite of Grafana dashboards for a cluster.
support chart is a helm chart maintained by the 2i2c Engineers that consists of common tools used to support JupyterHub deployments in the cloud.
These tools are
ingress-nginx, for controlling ingresses and load balancing;
cert-manager, for automatically provisioning TLS certificates from Let’s Encrypt; Prometheus, for scraping and storing metrics from the cluster and hub; and Grafana, for visualising the metrics retreived by Prometheus.
Add the following config as a top-level key to your
*.cluster.yaml file under
GRAFANA_URL should follow the pattern
support: config: grafana: ingress: hosts: - <grafana-domain> tls: - secretName: grafana-tls hosts: - <grafana-domain>
support chart via the
deployer tool to deploy the support chart to the cluster.
See Manually deploy hubs for details on how to setup the tool locally.
python3 deployer deploy-support CLUSTER_NAME
Setting the DNS A record¶
support chart has been successfully deployed, retrieve the external IP address for the
ingress-nginx load balancer.
kubectl --namespace support get svc support-ingress-nginx-controller
Add this external IP address to an A record in NameCheap that matches
GRAFANA_URL that was set in the
Wait a while for the DNS to propagate!
Log in to the Grafana dashboard¶
GRAFANA_URL will present you with a login page.
Here are the credentials for logging in:
password: located in
Setting up Grafana Dashboards¶
Once you have logged into grafana as the admin user, create a new API key. You can do this by selecting the gear icon from the left-hand menu, and then selecting API keys. The key you create needs admin permissions.
Keep this key safe as you won’t be able to retrieve it!
In the future, we should define the scenarios where other engineers need this API key after the initial deployment and decide how to store and share it.
Some default grafana dashboards for JupyterHub can then be deployed using
Create a local clone of the repository
Homebrew is the best option if you’re on MacOS.
The Python package will not suffice here as we directly call the
Follow the instructions in the Deployment section of the README to create the grafana dashboards