Application that collect analytics from the BigBlueButton Analytics Callback and put it in a postgresql database for analytics purpose
JWT_SECURITY_SALT=toSetup
JWT Security SaltDATABASE_URL=postgres://...
- The 'BigBlueButton Analytics Callback' https://github.com/bigbluebutton/bigbluebutton/blob/develop/record-and-playback/core/scripts/post_events/post_events_analytics_callback.rb is executed after each conference
- Set the metadata attributes "meta_analytics-callback-url" to the url of this app :
https://bbb-analytics.hosting.com/v1/post_events
- In
/usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties
set thesecuritySalt
to the same value ofJWT_SECURITY_SALT
- Running post_events scripts requires that you enable keepEvents=true in bbb-web's bigbluebutton.properties configuration. Or you can also use the param
'meetingKeepEvents=true' in the "meeting creation" call to enable it.
- You should use an app like Metabase for analytics purpose of the constituted database
- Use the conference id as key, check that two serveur don't generate the same id
Once Postgres is launched, you can start the application with these commands :
» npm install # Récupère les dépendances
» npm run migrate # Applique les migrations
» npm run dev
...
Running on port: 8100
The application will be available on http: // localhost: 8100
(8100 is the default port, you can change it with the env variable PORT
)
- Start the service and initialize the database :
docker-compose up
- disponible sur http://localhost:8100 - To add data to the database (optional):
docker-compose run web npm run seed;
- Run the tests :
docker-compose run web npm test
- Example to develop in a container :
docker run --rm --env-file ../.env.bbbanalytics.dev -v $(pwd):/app -w /app -ti -p 8100 node /bin/bash
((with your environment variables in ../.env.bbbanalytics.dev)
» npm run start
...
Running on port: 8100
» npm run test