Skip to main content

Log Collection (diagnostic logs)

Sometimes audio drops mid-meeting, the webcam freezes, or BBB reports "connection lost" - and afterwards it's nearly impossible to reconstruct what went wrong. That's exactly what the log collection plugin is for: from the moment you join, it records technical diagnostic data from your browser in the background. When needed, you download it as a ZIP file and send it to support.

The plugin is purely a diagnostic tool - you won't notice it during the meeting as long as everything works.

Good to know

Nothing is transmitted automatically. The ZIP file is created only on your device and ends up in your download folder. You decide whether to share it with support.

Who can use it?​

Everyone - moderator, participant, or guest. That's intentional: the person with the connection problem usually isn't the moderator. Each person exports only the logs of their own browser - nobody can see other participants' data. The plugin also works in breakout rooms.

Downloading logs​

There are two ways to get the ZIP file:

Option 1: Manually via the options menu​

Available at any time, even if no problem was detected:

  1. Click the three-dot menu in the top right (the same menu as "Leave meeting")
  2. Select Download diagnostic logs (ZIP)
  3. A privacy notice appears listing what the file contains
  4. Confirm with Agree & download

Option 2: Automatic notification panel​

When the plugin detects a connection problem (e.g. an audio drop or WebSocket disconnect), a panel automatically appears in the top right: "Connection problem detected". It has three buttons:

  • Create log file… → opens the privacy notice and then starts the download
  • Dismiss → hides the panel (no new panel for the next 5 minutes)
  • Don't show again → the panel stays hidden for the rest of the session (the menu entry keeps working)

The panel deliberately sits on top of BBB's "connection lost" overlay - so you can still click it even when BBB itself is already blocked.

Don't reload the page!

The diagnostic data lives only in your browser's memory. Reloading the page (F5) deletes everything. If a problem occurs: download the logs first, then reload or rejoin.

What's inside the ZIP file?​

The file is named bbb-client-logs_<date-time>.zip and contains four files (all contents in English):

FileContents
summary.txtHuman-readable summary: capture window, detected disconnects with timestamps. Look here first!
browser-console.logThe technical browser logs of the session, line by line with timestamps
events.ndjsonConnection events (audio drops, network loss, …) as a machine-readable list
session-info.jsonInfo about browser, device, meeting and user identifiers

What gets recorded: the browser console, network events (offline/online), the state of the audio/video connections (WebRTC) and the server connections (WebSockets). The buffers are limited - in very long sessions the oldest entries are dropped (this is noted in the export).

Privacy​

Before every download, the plugin shows a privacy notice that you must actively confirm - no confirmation, no export.

The plugin minimizes data already at capture time:

  • Access data, tokens and passwords are replaced with [redacted]
  • Names and IDs of other participants are pseudonymized ([participant-1], [participant-2], …); you yourself become [self]
  • Chat message fields are removed

Still, the file contains personal data - your own:

  • Your display name and user identifier
  • The meeting name and meeting identifier
  • Browser and device info (user agent, screen resolution, language, time zone)

Pseudonymization also has limits: at the very start of the session (before the participant list is loaded) and for names that BBB logs as free text, real names can occasionally appear in the logs. So treat the file like a document containing personal data: share it only with support, don't post it publicly.

When and how do I use it?​

Typical situations:

  • Your audio drops or keeps reconnecting
  • BBB shows a connection loss notification
  • Webcam or screen sharing freezes or drops
  • The "Connection problem detected" panel appears on its own

What to do:

  1. Don't reload the page!
  2. Download the logs (option 1 or 2 above)
  3. Attach the ZIP file to your support request
  4. Include the approximate time of the problem - it helps enormously when matching against server logs
Tips
  • summary.txt immediately tells you whether the client registered a disconnect - worth a look before writing the ticket.
  • If no file appears after confirming: check whether your browser is blocking downloads (download/popup blocker).
  • The notification panel appears at most once every 30 seconds - a flaky connection won't bombard you with panels.
  • You can also grab the logs preventively at the end of a troublesome session, even if no panel appeared - the menu always works.