Log Collection (Diagnose-Logs)

Manchmal bricht mitten im Meeting das Audio ab, die Webcam friert ein oder BBB meldet „Verbindung verloren" - und hinterher lässt sich kaum nachvollziehen, woran es lag. Genau dafür gibt es das Log-Collection-Plugin: Es zeichnet ab dem Moment deines Beitritts im Hintergrund technische Diagnosedaten deines Browsers auf. Bei Bedarf lädst du sie als ZIP-Datei herunter und schickst sie an den Support.

Das Plugin ist ein reines Diagnose-Werkzeug - im Meeting selbst merkst du nichts davon, solange alles funktioniert.

Wichtig zu wissen

Es wird nichts automatisch übertragen. Die ZIP-Datei wird nur auf deinem Gerät erstellt und landet in deinem Download-Ordner. Du entscheidest, ob du sie an den Support weitergibst.

Wer kann es benutzen?

Alle - egal ob Moderator:in, Teilnehmer:in oder Gast. Das ist Absicht: Die Person mit dem Verbindungsproblem ist meistens nicht die Moderation. Jede Person exportiert dabei ausschließlich die Logs des eigenen Browsers - niemand kann die Daten anderer Teilnehmenden einsehen. Das Plugin funktioniert auch in Breakout-Räumen.

Logs herunterladen

Es gibt zwei Wege zur ZIP-Datei:

Weg 1: Manuell über das Optionen-Menü

Jederzeit möglich, auch wenn gerade kein Problem erkannt wurde:

1. Klick auf das Drei-Punkte-Menü rechts oben (dasselbe Menü wie „Meeting verlassen")
2. Wähle Diagnose-Logs herunterladen (ZIP)
3. Ein Datenschutzhinweis erscheint und listet auf, was die Datei enthält
4. Bestätige mit Einverstanden & herunterladen

Weg 2: Automatisches Hinweis-Fenster

Erkennt das Plugin ein Verbindungsproblem (z. B. Audio-Abbruch, WebSocket-Abbruch), erscheint rechts oben automatisch ein Fenster: „Verbindungsproblem erkannt". Es hat drei Buttons:

• Logdatei erstellen… → öffnet den Datenschutzhinweis und startet danach den Download
• Schließen → blendet das Fenster aus (für die nächsten 5 Minuten erscheint kein neues)
• Nicht mehr anzeigen → das Fenster bleibt für den Rest der Sitzung weg (der Menüeintrag funktioniert weiterhin)

Das Fenster liegt bewusst über dem „Verbindung verloren"-Overlay von BBB - du kannst also auch dann noch klicken, wenn BBB selbst schon blockiert ist.

Seite nicht neu laden!

Die Diagnosedaten liegen nur im Arbeitsspeicher deines Browsers. Ein Neuladen der Seite (F5) löscht alles. Wenn ein Problem auftritt: erst die Logs herunterladen, dann neu laden oder neu beitreten.

Was steckt in der ZIP-Datei?

Die Datei heißt bbb-client-logs_<Datum-Uhrzeit>.zip und enthält vier Dateien (alle Inhalte auf Englisch):

Datei	Inhalt
summary.txt	Menschenlesbare Zusammenfassung: Zeitfenster, erkannte Abbrüche mit Uhrzeit. Zuerst hier reinschauen!
browser-console.log	Die technischen Browser-Logs der Sitzung, Zeile für Zeile mit Zeitstempel
events.ndjson	Verbindungsereignisse (Audio-Abbrüche, Netzwerkverlust, …) als maschinenlesbare Liste
session-info.json	Infos zu Browser, Gerät, Meeting- und Nutzerkennung

Aufgezeichnet werden: die Browser-Konsole, Netzwerkereignisse (offline/online), der Zustand der Audio-/Video-Verbindungen (WebRTC) und der Serververbindungen (WebSockets). Die Puffer sind begrenzt - bei sehr langen Sitzungen fallen die ältesten Einträge weg (das wird im Export vermerkt).

Datenschutz

Vor jedem Download zeigt das Plugin einen Datenschutzhinweis, den du aktiv bestätigen musst - ohne Bestätigung kein Export.

Das Plugin minimiert Daten schon bei der Aufzeichnung:

• Zugangsdaten, Tokens und Passwörter werden durch [redacted] ersetzt
• Namen und IDs anderer Teilnehmer:innen werden pseudonymisiert ([participant-1], [participant-2], …), du selbst wirst zu [self]
• Chat-Nachrichten-Felder werden entfernt

Trotzdem enthält die Datei personenbezogene Daten - deine eigenen:

• Deinen Anzeigenamen und deine Nutzerkennung
• Den Meeting-Namen und die Meeting-Kennung
• Browser- und Geräteinfos (User-Agent, Bildschirmauflösung, Sprache, Zeitzone)

Die Pseudonymisierung hat außerdem Grenzen: Ganz zu Beginn der Sitzung (bevor die Teilnehmerliste geladen ist) und bei Namen, die BBB als Fließtext loggt, können vereinzelt echte Namen in den Logs stehen. Behandle die Datei also wie ein Dokument mit persönlichen Daten: nur an den Support weitergeben, nicht öffentlich teilen.

Wann und wie benutze ich das?

Typische Anlässe:

• Dein Audio bricht ab oder verbindet sich ständig neu
• BBB zeigt „Es wurde ein Verlust Ihrer Verbindung festgestellt"
• Webcam oder Bildschirmfreigabe friert ein oder bricht ab
• Das Fenster „Verbindungsproblem erkannt" erscheint von selbst

So gehst du vor:

1. Seite nicht neu laden!
2. Logs herunterladen (Weg 1 oder Weg 2 oben)
3. Die ZIP-Datei an deine Support-Anfrage anhängen
4. Die ungefähre Uhrzeit des Problems dazuschreiben - das hilft beim Abgleich mit den Server-Logs enorm

Tipps

• In summary.txt steht sofort, ob der Client einen Abbruch registriert hat - ein Blick lohnt sich, bevor du das Ticket schreibst.
• Wenn nach dem Bestätigen keine Datei erscheint: prüfe, ob dein Browser Downloads blockiert (Download-/Popup-Blocker).
• Das Hinweis-Fenster erscheint frühestens alle 30 Sekunden neu - bei einer flackernden Verbindung wirst du also nicht mit Fenstern bombardiert.
• Du kannst die Logs auch prophylaktisch am Ende einer problematischen Sitzung ziehen, selbst wenn kein Fenster erschienen ist - das Menü funktioniert immer.