Hilfe › Wenn etwas nicht geht › H19

Logs einsammeln und an den Support schicken

Wo BrowserDesk unter Windows, macOS und Linux seine Protokolle ablegt, welche Dateien der Support braucht, welche Sie nie verschicken sollten — und wie Sie alles an info@browserdesk.de schicken.

Vorschau diese Anleitung ist noch nicht am Gerät durchgeklickt. Knopfnamen und Abläufe stammen aus dem Programm, können aber in Einzelheiten abweichen.

Für: Privater Helfer · Person am Gerät · Techniker · Verwalter eines Zugangs · Betreiber eines eigenen Relays · Mitarbeiter im Homeoffice
Gilt für: Free · Cloud · Eigenes Relay
Gesteuertes Gerät: Windows · macOS · Linux
Steuern von: Programm (Windows, macOS, Linux)

Worum es geht

Wenn etwas nicht klappt und keine Seite dieses Handbuchs weiterhilft, braucht der Support die Protokolle (Logs) von BrowserDesk. Darin steht Schritt für Schritt, was das Programm getan hat. Diese Seite sagt, wo die Protokolle je System liegen, welche Dateien Sie schicken — und welche nie.

Das brauchen Sie

Zugriff auf den Rechner, um den es geht. Bei einem Problem beim Verbinden oft beide: das gesteuerte Gerät und den Rechner des Technikers.
Den Zeitpunkt, wann der Fehler auftrat (möglichst minutengenau).
Unter Windows für manche Dateien Administrator-Rechte.

So geht's

1. Der schnelle Weg: aus dem Programm melden

Unter Windows, macOS und Linux: EinstellungenAllgemein → Rückmeldung senden.

Fehler wählen, Titel und Beschreibung ausfüllen.
Diagnose mitsenden anlassen (Fassung, System, Sprache).
Protokollauszug anhängen einschalten — das hängt die letzten Zeilen dieses Programms an. Sie können Rechnernamen und Adressen enthalten.
Senden.

Die Rückmeldung geht an Ihr Relay. Auf browserdesk.de landet sie damit direkt bei uns. Mit eigenem Relay landet sie beim Betreiber Ihres Relays; er kann sie an uns weiterleiten (F9).

Reicht der Auszug nicht, fragt der Support nach den ganzen Dateien — dann Schritt 2.

2. Die Dateien selbst einsammeln

Windows

Was	Ort
Dienst und Aufseher (Anmeldung beim Relay, Sperrbildschirm, Updates)	`C:\ProgramData\BrowserDesk\Logs\` — vor allem `bd-service.log`
Update- und Wiederherstellungs-Protokoll	`C:\ProgramData\BrowserDesk\watchdog.log`
Zustand des Dienstes	`C:\ProgramData\BrowserDesk\health.json`
Ihre Seite als Techniker (Verbindungsaufbau, Abbrüche)	`%LOCALAPPDATA%\BrowserDesk\Logs\betrachter.log`
Netzwerktest	`%LOCALAPPDATA%\BrowserDesk\netzwerk-diagnose.txt` (siehe Schritt 3)

So geht es: Im Explorer den Ort in die Adresszeile tippen, die Dateien markieren, Rechtsklick → „Senden an“ → „ZIP-komprimierter Ordner“.

macOS

Was	Ort
Gerät und Programm (Bild, Anmeldung, Rechte)	`~/Library/Application Support/BrowserDesk/Logs/bdhost.log` (und die Vorgängerdatei `bdhost.log.1`)
Ihre Seite als Techniker	`~/Library/Logs/BrowserDesk/betrachter.log`

Im Finder: „Gehe zu“ → „Gehe zum Ordner …“, den Ort eintragen, Dateien markieren, Rechtsklick → „Komprimieren“.

Linux

Was	Ort
Dienst des Benutzers	`journalctl --user -u browserdesk.service -b > browserdesk.txt`
Dienst am Anmeldebildschirm	`sudo journalctl -u browserdesk-system.service -b > browserdesk-system.txt`
Updates	`/var/log/browserdesk-update.log`
Ihre Seite als Techniker	in der Regel `~/.local/state/browserdesk/logs/betrachter.log`

Die Befehle in einem Terminal ausführen; sie schreiben das Protokoll seit dem letzten Start in eine Datei.

3. Netzwerkproblem? Den Netzwerktest beilegen

EinstellungenNetzwerk → Karte Netzwerktest → Test starten, danach Diagnose exportieren. Das Programm legt den Bericht in die Zwischenablage, speichert ihn und nennt den Ort: „Diagnose in die Zwischenablage kopiert und gespeichert: …“ (H10).

4. Schicken

Eine E-Mail an info@browserdesk.de mit:

den Dateien bzw. der ZIP-Datei,
der Kennung des Geräts (bei einem Verbindungsproblem beider Seiten),
Datum und Uhrzeit des Fehlers,
dem Satz, den Sie gesehen haben, am besten als Bildschirmfoto,
und was Sie davor getan haben.

Daran sehen Sie, dass es geklappt hat

Sie bekommen eine Antwort auf Ihre E-Mail. Bei einer Rückmeldung aus dem Programm zeigt das Fenster Rückmeldung gesendet mit „Danke! Ihre Rückmeldung ist als Nr. … angekommen.“

Gut zu wissen

Die Protokolle können Rechnernamen, Adressen und Kennungen enthalten. Schicken Sie sie nur an den Support.
Zuerst einsammeln, dann reparieren. Die Reparatur (H18) löscht die Protokolle.
bdhost.log und betrachter.log wachsen nicht endlos. Ab einer festen Größe beginnt eine neue Datei, die vorherige bleibt als Vorgänger (… .1) liegen.
Handy, Tablet, Fire TV und Browser: Für die Apps und den Web-Zugriff gibt es noch keinen Weg, Protokolle selbst einzusammeln. Beschreiben Sie den Fall per E-Mail und legen Sie ein Bildschirmfoto bei.
Eigenes Relay: Die Protokolle des Relays selbst sind Sache seines Betreibers.
Die Wissensdatenbank enthält dazu den Artikel Logs einsammeln und einsenden. Sein Befehl (Windows, PowerShell) sammelt alle Protokolle auf einmal in eine ZIP-Datei — nur *.log, *.txt und health.json, ohne die Dateien aus dem Achtung-Kasten.

Wenn es nicht klappt

Sie sehen	Bedeutung und Abhilfe
Der Ordner `C:\ProgramData` ist im Explorer nicht zu sehen	Er ist versteckt. Den Ort trotzdem in die Adresszeile tippen.
Eine Datei lässt sich nicht öffnen oder kopieren	Sie gehört dem Dienst. Explorer bzw. Terminal als Administrator verwenden.
Eine Datei aus der Tabelle fehlt	Der Teil lief auf diesem Rechner nie (zum Beispiel kein Dienst installiert) — einfach weglassen.
Rückmeldung senden meldet eine ältere Fassung	Ihr Relay kennt Rückmeldungen noch nicht. Die Dateien per E-Mail schicken.
Diagnose exportieren tut nichts	Erst Test starten — ohne Testergebnis gibt es nichts zu exportieren.

Passt dazu

← „BrowserDesk startet nicht richtig“ — reparieren und neu installieren „Der Druck kommt nicht an“ oder „nur der zweite Auftrag kam“ →