Registos e reportar um erro

Quando algo se porta mal, são os ficheiros de registo que transformam um "avariou" num relatório que se pode corrigir. Recolha-os perto do momento em que o problema aconteceu.

Onde vivem os registos

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

As localizações em si:

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

O ficheiro principal é o nexus-service.log. Em cada arranque do serviço, a execução anterior é arquivada como nexus-service-<timestamp>.log (guardam-se as cinco mais recentes), por isso a pasta contém a execução atual mais o histórico recente. No Windows, a mesma pasta recolhe também os registos dos outros componentes do Nexus, com o nome nexus-*.log. A primeira linha de cada registo do serviço regista a versão do Nexus de que veio.

O pacote de suporte

O painel consegue empacotar tudo o que é relevante num único ZIP: clique em Exportar pacote de suporte nas Definições, em Diagnóstico e suporte, ou no topo da página Diagnóstico do sistema (ambos produzem o mesmo ficheiro). Contém todos os registos, os registos do daemon OpenRGB, os dados de diagnóstico e uma cópia das suas definições sem credenciais. Anexar esse pacote a um relatório é melhor do que escolher ficheiros à mão.

Como reportar

Junte-se ao nosso Discord; é o sítio mais rápido para obter ajuda e onde os relatórios de erros são acompanhados. Inclua:

  1. A sua versão do Nexus. Está gravada na primeira linha do nexus-service.log, por isso o próprio ficheiro de registo já a leva.
  2. O seu sistema operativo (Windows, macOS ou Linux, e a versão).
  3. O que aconteceu e quando: o que fez, o que esperava, o que viu em vez disso e, aproximadamente, quando ocorreu, para se poder cruzar com as marcas temporais dos registos.
  4. Os ficheiros de registo ou o pacote de suporte, recolhidos enquanto o problema ainda estava fresco.

Dica

Os registos rodam a cada arranque do serviço e só se guardam as cinco execuções mais recentes, por isso, se estiver a reiniciar ou a reinstalar para contornar um problema, copie primeiro a pasta de registos.