File di log e segnalazione di bug

Quando qualcosa non funziona, i file di log sono ciò che trasforma un "si è rotto" in una segnalazione risolvibile. Raccoglili il prima possibile dopo il problema.

Dove si trovano i log

La strada più rapida su qualsiasi sistema operativo: nella dashboard apri Impostazioni e, sotto Diagnostica e supporto nella scheda Generali, fai clic su Apri cartella dati. Su Windows i log sono nella sua sottocartella logs; su macOS stanno nella cartella separata indicata sotto.

I percorsi veri e propri:

  • Windows: %ProgramData%\Nexus\logs
  • macOS: ~/Library/Logs/Nexus
  • Linux: il servizio scrive nel journal di sistema; leggilo con journalctl -u nexus (aggiungi -f per seguirlo in tempo reale).

Il file principale è nexus-service.log. A ogni avvio del servizio l'esecuzione precedente viene archiviata come nexus-service-<timestamp>.log (vengono conservate le cinque più recenti), quindi la cartella contiene l'esecuzione corrente più la cronologia recente. Su Windows la stessa cartella raccoglie anche i log degli altri componenti di Nexus, chiamati nexus-*.log. La prima riga di ogni log del servizio indica la versione di Nexus da cui proviene.

Il pacchetto di assistenza

La dashboard può racchiudere tutto il necessario in un unico file ZIP: fai clic su Esporta pacchetto di supporto in Impostazioni, sotto Diagnostica e supporto, oppure in cima alla pagina Diagnostica di sistema (entrambi producono lo stesso file). Contiene tutti i log, i log del demone OpenRGB, i dati di diagnostica e una copia delle tue impostazioni senza credenziali. Allegare quel pacchetto a una segnalazione è meglio che scegliere i file a mano.

Come segnalare

Entra nel nostro Discord: è il posto più rapido per ricevere aiuto ed è dove vengono tracciate le segnalazioni di bug. Includi:

  1. La tua versione di Nexus. È riportata nella prima riga di nexus-service.log, quindi il file di log stesso la contiene.
  2. Il tuo sistema operativo (Windows, macOS o Linux, con la relativa versione).
  3. Cosa è successo e quando: cosa hai fatto, cosa ti aspettavi, cosa hai visto invece e all'incirca quando è successo, così da poterlo confrontare con i timestamp dei log.
  4. I file di log o il pacchetto di assistenza, raccolti mentre il problema era ancora fresco.

Suggerimento

I log ruotano a ogni avvio del servizio e vengono conservate solo le cinque esecuzioni più recenti: se stai riavviando o reinstallando per aggirare un problema, copia prima la cartella dei log.