Logs e como reportar um bug

Quando alguma coisa se comporta mal, são os arquivos de log que transformam "quebrou" em um relato que dá para corrigir. Pegue-os logo depois de o problema acontecer.

Onde os logs ficam

O caminho mais rápido em qualquer sistema: no painel, abra as Configurações e, em Diagnóstico e suporte, na aba Geral, clique em Abrir pasta de dados. No Windows os logs ficam na subpasta logs; no macOS ficam na pasta separada indicada abaixo.

Os locais em si:

• Windows: %ProgramData%\Nexus\logs
• macOS: ~/Library/Logs/Nexus
• Linux: o serviço escreve no journal do sistema; leia-o com journalctl -u nexus (acrescente -f para acompanhar ao vivo).

O arquivo principal é o nexus-service.log. A cada início do serviço, a execução anterior é arquivada como nexus-service-<timestamp>.log (as cinco mais recentes são mantidas), então a pasta guarda a execução atual mais um histórico recente. No Windows, a mesma pasta também reúne os logs dos outros componentes do Nexus, com nomes nexus-*.log. A primeira linha de todo log do serviço registra a versão do Nexus de onde ele veio.

O pacote de suporte

O painel consegue empacotar tudo o que interessa em um único ZIP: clique em Exportar pacote de suporte nas Configurações, em Diagnóstico e suporte, ou no topo da página de Diagnóstico do sistema (os dois geram o mesmo arquivo). Ele contém todos os logs, os logs do daemon OpenRGB, os dados de diagnóstico e uma cópia das suas configurações sem credenciais. Anexar esse pacote a um relato é melhor do que escolher arquivos na mão.

Como reportar

Entre no nosso Discord; é o lugar mais rápido para conseguir ajuda e é onde os relatos de bug são acompanhados. Inclua:

1. Sua versão do Nexus. Ela é registrada na primeira linha do nexus-service.log, então o próprio arquivo de log já a carrega.
2. Seu sistema operacional (Windows, macOS ou Linux, com a versão).
3. O que aconteceu e quando: o que você fez, o que esperava, o que viu no lugar disso e aproximadamente quando ocorreu, para que dê para cruzar com os horários dos logs.
4. Os arquivos de log ou o pacote de suporte, capturados enquanto o problema ainda estava fresco.