bbb-usage collects and shows usage statistics of a BigBlueButton server.
It consists of 2 parts:
- data collector (
collect.php
) - web GUI to show collected statistics (
index.php
)
Data is stored in a mySQL database. bbb-usage uses the BBB API to collect usage data.
- Collect BBB usage statistics
- number of active meetings (rooms)
- number of participants
- number of voice participants (with & without microphone)
- number of video participants
- number of breakout-rooms
- Show live-data and historical data
- Support for unlimited frontends
- Filtering of data
- starting date
- end date
- frontend
- Access protection
You can install bbb-usage on the BBB server or on a different server.
- LINUX Server
- Webserver (eg Apache, NGINX)
- PHP 7.2 (or above)
- mySQL Server
Let's assume /var/www/html/
is the root directory of your webserver:
cd /var/www/html/
git clone https://github.com/glu000/bbb-usage
Creata a new database bbb-usage
and grant access to a user
Copy conf-example.php
to conf.php
and adjust settings
It's recommended to collect data every 5 minutes:
*/5 * * * * cd /var/www/html/bbb-usage && /usr/bin/php /var/www/html/bbb-usage/collect.php
Have a look at bbb-usage-gui.jpg
Feel free to fork the repo an send pull-requests