Skip to content

Getting Started#

First you will need to choose your installation configuration.

Installation Type Matrix#

Recommended installation type Number of BBB servers Existing Prometheus & Grafana services Do you like Docker?
Docker installation (recommended) multiple
All-In-One Monitoring Stack installation 1
Systemd installation (not recommended) multiple

If you choose the Docker or Systemd installation type you will have the choice of choosing between node_exporter (recommended) and Netdata for server resource utilization metrics. The metrics that will be collected from one of these two tools will be used together with BigBlueButton exporter metrics in the Server Instance Grafana dashboards.

node_exporter installation instructions

Netdata installation instructions

Grafana Dashboards#

Once you have the BigBlueButton exporter installed and one of the two resource utilization metric exporters (node_exporter or Netdata), you can import the appropriate Grafana dashboards.

Note

We assume a working Grafana-Prometheus installation. If you used the All-In-One Monitoring Stack installation type you are covered since Grafana, Prometheus and node_exporter come preconfigured.

Login to Grafana and in the left menu click on + icon -> import

In the JSON field copy/paste the contents of your desired dashboard

Dashboard Prerequisites Short description
All Servers dashboard BigBlueButton Exporter BBB metrics for all servers in one dashboard
Server Instance (node_exporter) dashboard BigBlueButton Exporter, node_exporter BBB server details combined with node_exporter resource metrics
Server Instance (netdata) dashboard BigBlueButton Exporter, Netdata BBB server details combined with Netdata resource metrics

Installing Grafana on the BigBlueButton Server#

If you plan to install Grafana on the BigBlueButton host itself, keep in mind that the standard port for Grafana (3000) is also used by the html5-client of BigBlueButton (see /etc/bigbluebutton/nginx/bbb-html5.nginx). In this case you will need to change the Grafana port in /etc/grafana/grafana.ini to something else, e.g. 3001).