Protokolldateien & Fehler melden

Wenn etwas nicht rundläuft, sind die Protokolldateien das, was aus "es ist kaputt" einen behebbaren Bericht macht. Sichern Sie sie zeitnah zum Problem.

Wo die Protokolle liegen

Der schnellste Weg auf jedem Betriebssystem: Öffnen Sie im Dashboard die Einstellungen und klicken Sie im Tab Allgemein unter Diagnose & Support auf Datenordner öffnen. Unter Windows liegen die Protokolle in dessen Unterordner logs, unter macOS im separaten Ordner, der unten aufgeführt ist.

Die Ablageorte selbst:

  • Windows: %ProgramData%\Nexus\logs
  • macOS: ~/Library/Logs/Nexus
  • Linux: Der Dienst protokolliert in das System-Journal; lesen Sie es mit journalctl -u nexus (mit -f verfolgen Sie es live).

Die Hauptdatei ist nexus-service.log. Bei jedem Dienststart wird der vorherige Lauf als nexus-service-<timestamp>.log archiviert (die fünf neuesten bleiben erhalten), sodass der Ordner den aktuellen Lauf plus die jüngste Historie enthält. Unter Windows sammelt derselbe Ordner auch die Protokolle der übrigen Nexus-Komponenten, benannt als nexus-*.log. Die erste Zeile jedes Dienstprotokolls hält die Nexus-Version fest, aus der es stammt.

Das Support-Paket

Das Dashboard kann alles Relevante in ein einziges ZIP packen: Klicken Sie in den Einstellungen unter Diagnose & Support oder oben auf der Seite Systemdiagnose auf Support-Paket exportieren (beide erzeugen dieselbe Datei). Es enthält alle Protokolle, die Protokolle des OpenRGB-Daemons, die Diagnosedaten und eine Kopie Ihrer Einstellungen ohne Zugangsdaten. Dieses Paket an einen Bericht anzuhängen ist besser, als Dateien von Hand zusammenzusuchen.

So melden Sie einen Fehler

Treten Sie unserem Discord bei; dort bekommen Sie am schnellsten Hilfe, und dort werden Fehlerberichte verfolgt. Geben Sie an:

  1. Ihre Nexus-Version. Sie steht in der ersten Zeile von nexus-service.log, die Protokolldatei selbst trägt sie also bereits.
  2. Ihr Betriebssystem (Windows, macOS oder Linux, samt Version).
  3. Was passiert ist und wann: was Sie getan haben, was Sie erwartet hatten, was Sie stattdessen gesehen haben und ungefähr wann es auftrat, damit es sich den Zeitstempeln im Protokoll zuordnen lässt.
  4. Die Protokolldateien oder das Support-Paket, gesichert solange das Problem noch frisch war.

Tipp

Die Protokolle rotieren bei jedem Dienststart, und nur die fünf jüngsten Läufe bleiben erhalten. Wenn Sie zur Umgehung eines Problems neu starten oder neu installieren, kopieren Sie also zuerst den Protokollordner.