/bigbluebutton_monitoring

Big Blue button monitoring through docker images for a fast install and deployment

Primary LanguageShell

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