Go to file
prlanzarin 3c4e3de286 feat: add WebRTC stats information to client logs
We should be able to capture  WebRTC stats in some form for post-processing
so that it helps on debugging support requests (and other use cases, e.g.:
improving field trial analysis on test servers).
Although much of WebRTC stats information can be gathered via server side
components, none have logs as structured for proper post-processing as
the client logs - so we're going the client route for now.

Capture WebRTC stats information for audio and screen sharing via:
  - Audio logCodes: new `stats` extraInfo field
    - `audio_joined`
    - `audio_failure`
    - `sfuaudio_error_retry_through_relay`
    - `sfuaudio_error_try_to_reconnect`
  - Screen share logCodes: new `stats` extraInfo field
    - screenshare_presenter_start_success
    - screenshare_viewer_start_success
    - screenshare_broker_failure

Additionally, add an option to periodically capture WebRTC stats information
for all relevant peers. This is disabled by default since the log can be
verbose (and, consequentially, network taxing when using external
logging targets). It can be enabled via `public.stats.logMediaStats` in
settings.yml. The default interval is 30s. The periodic log format is as
follows:
  - logCode: `mediaStats`
  - extraInfo.stats: an aggregated stats object of all peers (equivalent
    to the `Copy` function in the Connection Status modal).
2024-08-27 14:00:26 -03:00
.github ✏️ Fix typo in docs issue template 2023-11-23 13:07:42 -05:00
akka-bbb-apps fix: Breakout rooms show incorrect presentation filename (#20947) 2024-08-22 13:24:19 -03:00
akka-bbb-fsesl feat(audio): add memberId to VoiceStateEvent when applicable 2024-07-23 09:22:50 -03:00
bbb-common-message fix: Breakout rooms show incorrect presentation filename (#20947) 2024-08-22 13:24:19 -03:00
bbb-common-web fix: Breakout rooms show incorrect presentation filename (#20947) 2024-08-22 13:24:19 -03:00
bbb-export-annotations fix(bbb-export-annotations): Handle text rendering issue (#20857) 2024-08-06 16:21:45 -04:00
bbb-fsesl-client fix(sec): Bump logback-classic 2024-04-17 14:29:18 -04:00
bbb-learning-dashboard build(deps-dev): bump postcss 2024-07-24 22:03:22 +00:00
bbb-libreoffice chore: Upgrade LibreOffice to 7.6.2 2023-11-01 06:50:32 -04:00
bbb-recording-imex fix: bbb-recording-imex/pom.xml to reduce vulnerabilities (#19277) 2023-12-04 13:56:09 -05:00
bbb-voice-conference/config/freeswitch build(freeswitch): load mod_audio_fork by default 2023-04-25 10:05:06 -03:00
bigbluebutton-config chore: Bump release to 2.7.12 2024-08-02 19:31:05 -04:00
bigbluebutton-html5 feat: add WebRTC stats information to client logs 2024-08-27 14:00:26 -03:00
bigbluebutton-tests test: Backport share camera as content test to 2.7 (#20964) 2024-08-21 14:56:39 -03:00
bigbluebutton-web chore(core): upgrade embedded tomcat (#20767) 2024-07-24 15:41:41 -04:00
build Fix: File permissions in packages should not depend on umask of build system 2024-05-28 16:24:27 +02:00
docs docs: Testing plan update (what's new features) (#20913) 2024-08-14 09:50:03 -04:00
labs/stress-testing Removes vertx-akka file 2022-06-30 16:51:23 -03:00
record-and-playback Merge pull request #20420 from paultrudel/video-metadata-fix 2024-06-10 16:59:02 -04:00
.gitignore bbb-presentation-video: Update to 4.0.0-rc.1 2023-03-06 11:57:53 -05:00
.gitlab-ci.yml Merge pull request #17724 from lfzawacki/v2.7.x-release 2023-06-22 05:25:14 -04:00
.nvmrc Add .nvmrc 2018-10-03 13:33:59 -04:00
bbb-etherpad.placeholder.sh chore: Bump Etherpad to 1.9.4 2023-10-30 15:14:50 -04:00
bbb-lti.placeholder.sh build: add placeholder to pull bbb-lti from other repo 2022-02-28 20:29:11 +00:00
bbb-pads.placeholder.sh chore: Bump bbb-pads to 1.5.2 2023-11-06 06:40:42 -05:00
bbb-playback.placeholder.sh chore: Bump bbb-playback to 5.0.2 2023-11-06 07:12:11 -05:00
bbb-presentation-video.placeholder.sh bbb-presentation-video: Update to 4.0.4 2023-10-03 17:02:49 -04:00
bbb-transcription-controller.placeholder.sh feat(transcription): Bump bbb-transcription-controller 2024-04-11 16:39:30 -03:00
bbb-webhooks.placeholder.sh build(bbb-webhooks): v2.6.1 2023-11-09 17:09:44 -03:00
bbb-webrtc-recorder.placeholder.sh build(bbb-webrtc-recorder): v0.7.0 2024-03-14 14:09:29 -03:00
bbb-webrtc-sfu.placeholder.sh build(bbb-webrtc-sfu): v2.14.2 2024-08-21 16:18:16 -03:00
freeswitch.placeholder.sh build(sec): upgrade FreeSWITCH to 1.10.11 +sofia-sip +libks (#19377) 2024-01-02 14:09:50 -05:00
LICENSE Add license file 2020-04-23 13:51:05 -03:00
README.md build: swap bionic with focal 2022-03-14 19:04:23 +00:00
SECURITY.md Update SECURITY.md 2023-09-06 15:37:56 -04:00
transifex.yml fix: Change naming of resulting translated locales file 2022-12-20 13:50:44 -05:00

BigBlueButton

BigBlueButton is an open source web conferencing system.

BigBlueButton supports real-time sharing of audio, video, slides (with whiteboard controls), chat, and the screen. Instructors can engage remote students with polling, emojis, multi-user whiteboard, and breakout rooms.

Presenters can record and playback content for later sharing with others.

We designed BigBlueButton for online learning, (though it can be used for many other applications as well). The educational use cases for BigBlueButton are

  • Online tutoring (one-to-one)
  • Flipped classrooms (recording content ahead of your session)
  • Group collaboration (many-to-many)
  • Online classes (one-to-many)

You can install on a Ubuntu 20.04 64-bit server. We provide bbb-install.sh to let you have a server up and running within 30 minutes (or your money back 😉).

For full technical documentation BigBlueButton -- including architecture, features, API, and GreenLight (the default front-end) -- see https://docs.bigbluebutton.org/.

BigBlueButton and the BigBlueButton Logo are trademarks of BigBlueButton Inc .