Git Product home page Git Product logo

bbb-usage's Introduction

bbb-usage

Overview

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.

Features

  • 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

Setup

You can install bbb-usage on the BBB server or on a different server.

Prerequisites

  • LINUX Server
  • Webserver (eg Apache, NGINX)
  • PHP 7.2 (or above)
  • mySQL Server

Installation steps

1. Clone Github Repository to your local machine

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

2. Create mySQL database

Creata a new database bbb-usage and grant access to a user

3. Adopt bbb-usage configuration

Copy conf-example.php to conf.php and adjust settings

4. Add crontab job

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

GUI

Have a look at bbb-usage-gui.jpg

Contribute

Feel free to fork the repo an send pull-requests

bbb-usage's People

Contributors

glu000 avatar

Stargazers

avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar

Watchers

avatar avatar

Forkers

shahidge4 lutice bmtteam astrinux gitisara

bbb-usage's Issues

NOT ISSUE: Get additional information of meeting

Dear developers,
Thank you so much for this useful tool.

It would be useful if I could get also additional information of meeting. Some information is available via getMeetings API call.
How can I get e.g meetingName, createDate, attendees or another info, which are visible from getMeetings API call.

Thanks in advance!

collect.php running error

When I run /usr/bin/php /var/www/html/bbb-usage/collect.php I face this error:

PHP Fatal error: Uncaught Error: Class 'SimpleXMLElement' not found in /var/www/html/bbb-usage/vendor/bigbluebutton/bigbluebutton-api-php/src/BigBlueButton.php:490

Please describe how to solve it!

How to use bbb-usage with multiple BigBlueBotton Servers?

Hello everyone,

we are using bbb-usage with 1 BigBlueButton Server and it works great,

but how we can use more BigBlueButton Servers? Where can we set more BigBlueButtons Servers? (conf.php?)
we've tried many different syntaxes, but unfortunately without success

do you have a little manual/ FAQ for multiple BigBlueButton Servers?

thx

Connection failed: The server requested authentication method unknown to the client

Hello,

I have BBB prod server , so I installed bbb-usage in other server but I have this error :
root@bbb-stats:/var/www/html/bbb-usage# /usr/bin/php /var/www/html/bbb-usage/collect.php
PHP Warning: mysqli::__construct(): The server requested authentication method unknown to the client [caching_sha2_password] in /var/www/html/bbb-usage/collect.php on line 30
PHP Warning: mysqli::__construct(): (HY000/2054): The server requested authentication method unknown to the client in /var/www/html/bbb-usage/collect.php on line 30
Connection failed: The server requested authentication method unknown to the client
and i have this msg in web interface :
Connection failed: The server requested authentication method unknown to the client

any help ?

Thanks!

Hi, thanks for the code

Successfully installed and running for one bbb server , how to add/view same UI for multiple servers..

Thanks

Error

error
Dear i facing issue i have copy conf-example.php as conf.php. and insert valid $bbb_secret

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.