bigbluebutton_monitoring

This repository comes from the main project /ZeitounCorp/load-balancer/monitoring

PORTS REQUIRED TO BE "OPEN"

• 5556 in order to serve the Dashboard
• 9688 in order for prometheus to scrape the big blue button api
• 9100 in order for prometheus to scrape the instance's ressource usgae

How to install | Update ?

• Auto-Update script for Docker

  • curl -o- https://raw.githubusercontent.com/ZeitounCorp/bigbluebutton_monitoring/main/scripts/update_docker.sh | bash

• Auto-Install script for Docker-Compose

  • curl -o- https://raw.githubusercontent.com/ZeitounCorp/bigbluebutton_monitoring/main/scripts/install_docker_compose.sh | bash

• Install the monitoring system

  • cd ~ && git clone https://github.com/ZeitounCorp/bigbluebutton_monitoring.git
  • Next you need to cd ~/bigbluebutton_monitoring/bbb-exporter/
  • Get your BBB secret by running: sudo bbb-conf --secret
  • Then replace API_BASE_URL and API_SECRET in ./bbb_exporter_secrets.env with the data received from --secret ⚠️ Don't forget to append /api/ to the URL returned from --secret ⚠️
  • Replace GF_SERVER_ROOT_URL value in ./docker-compose.yaml by https://YOUR_HOSTNAME/monitoring
  • Run sudo docker-compose up -d
  • Then you need to configure NginX:
    • cd /etc/bigbluebutton/nginx/
    • sudo nano ./monitoring.nginx
    • Copy/Paste the following:

    # BigBlueButton monitoring
    location /monitoring/ {
      proxy_pass http://127.0.0.1:5556/;
      include proxy_params;
    }
    

    • Save and Exit
    • Test NginX with sudo nginx -t
    • If no error then, execute sudo systemctl daemon-reload
    • Execute sudo systemctl reload nginx

If everything was done correctly, you should now be able to access Grafana @ https://YOUR_HOSTNAME/monitoring

Next Steps

• Concerning configuring Grafana follow the guide I've written: Configuring Grafana