Dannex Download Manager
  1. Início
  2. Ajuda
  3. Relatórios de falhas

Relatórios de falhas

Se o Dannex Download Manager fechar inesperadamente ou parar de responder, uma janela de relatório de erro será aberta. Ela mostra o que aconteceu, permite que você leia o relatório completo e pode enviá-lo aos desenvolvedores no GitHub. Cada relatório ajuda a corrigir o problema para todos.

A janela de relatório de falha depois que o DDM parou de responder

O que você vê

  • Dannex Download Manager fechou inesperadamente: o DDM travou ou encontrou um erro interno e fechou.
  • Dannex Download Manager parou de responder: a janela não respondeu por 8 segundos. O DDM ainda está em execução, mas congelado. Encerrar e reiniciar o DDM fecha a cópia congelada e inicia uma nova. Se o DDM responder novamente por conta própria, a janela informará.

Na janela:

  1. O que você estava fazendo quando aconteceu? é opcional. Algumas palavras, como "Abri Adicionar URL", ajudam muito.
  2. O relatório mostra tudo o que seria enviado. Leia-o primeiro, se quiser.
  3. Enviar no GitHub abre o formulário Crash report do GitHub no seu navegador, já preenchido, junto com a pasta que contém o relatório. Arraste o arquivo do relatório para o formulário, verifique-o e envie. Você precisa de uma conta GitHub. Nada é enviado automaticamente.
  4. Se alguém já relatou o mesmo problema, a janela informa (Já relatado como problema #…). Abrir o problema relatado o abre e coloca seu relatório na área de transferência, para que você possa adicioná-lo como um comentário.

Os outros botões copiam o relatório, abrem a pasta ou iniciam o DDM novamente.

O que um relatório contém

  • O que aconteceu: o erro e o local no código do DDM onde ocorreu.
  • A pilha: o local no código do DDM onde travou ou congelou, e o que cada outra parte estava fazendo.
  • Registro recente do DDM: por exemplo, "comando AddUrl" ou "janela aberta: add-url".
  • O sistema: a versão do DDM e como você o instalou, seu sistema operacional e sua versão, o processador, o idioma e o tema, e quantos downloads e filas você tem. São apenas contagens.

Ele não contém:

  • seus endereços de download ou nomes de arquivo;
  • seu nome de usuário, que aparece como ~ nos caminhos das pastas.

Se uma mensagem de erro citar algo que você digitou, esse texto estará no relatório, então leia-o antes de enviar.

O arquivo de dados de falha (.dmp) é um instantâneo do que o DDM estava executando naquele momento. Ele ajuda muito os desenvolvedores, mas pode conter partes do que o DDM tinha na memória, como endereços de download, cookies e senhas salvas. Ele só é anexado quando você marca Anexar também os dados de falha.

Onde os relatórios são mantidos

Na pasta de dados do DDM:

  • crashes\: cada relatório (.txt) e seus dados de erro (.dmp);
  • logs\: o registro do DDM (mdm.log, com os mais antigos como mdm.1.log e assim por diante, 2 MB cada).

A pasta de dados do DDM é %APPDATA%\dannexdownloadmanager no Windows, ~/Library/Application Support/dannexdownloadmanager no macOS e ~/.local/share/dannexdownloadmanager no Linux. No modo portátil, é a pasta data ao lado do programa.

O registro grava o que o DDM faz, então um relatório pode mostrar o que levou a um problema. Para registrar mais detalhes, inicie o DDM com a variável de ambiente MDM_LOG=debug.

Para desenvolvedores

Como funciona: uma segunda cópia do DDM, o monitor, inicia ao lado dele com --crash-monitor. O código de erro reside em crates/crash e crates/app/src/crash.rs.

  • Identificação de problemas. Quando o DDM trava (uma exceção do Windows, um sinal no Linux, uma exceção Mach no macOS), entra em pânico ou congela, ele solicita um despejo ao monitor. Um congelamento é um quadro da janela que está sendo executada por mais de 8 segundos, detectado por um processo de monitoramento que ignora o tempo de inatividade. Ele mede ambas as partes de um quadro: o que o DDM processa (os comandos que chegam, o relógio de downloads, filas e o Agendador), que também é executado minimizado, e o desenho; nunca a espera entre os quadros. O monitor também mede quanto tempo de processador o processo da janela obteve nesse meio tempo, e o relatório indica o que isso significa: ele foi executado o tempo todo (um loop), esperou em um bloqueio ou em E/S (um deadlock), ou mal foi executado em código comum, o que significa que o computador está muito ocupado para executar o DDM ou lento para carregá-lo do disco, provavelmente não sendo um bug do DDM (esses compartilham uma assinatura, freeze while the computer was busy). Quando o processo da janela já está de volta ao loop de eventos no momento em que o despejo é gravado, o congelamento terminou antes do instantâneo, então sua pilha não pode explicá-lo; esses relatórios indicam isso e compartilham a assinatura freeze over before the snapshot. O macOS ainda não mede isso. O monitor então grava um minidump de cada processo de fora, através de minidumper e crash-handler. Um processo travado nunca grava seu próprio despejo, que é como o Firefox, Crashpad e Sentry também fazem.
  • Lendo o dump. O monitor lê o dump com o rust-minidump da Mozilla. Ele usa os símbolos Breakpad da versão quando estão disponíveis. Uma compilação a partir do código-fonte também pode ler as informações de depuração nativas ao lado (seu .pdb, DWARF) quando compilada com --features mdm-crash/native-symbols; o aplicativo distribuído não inclui esse leitor, que ocupa vários MB. A Assinatura do relatório (por exemplo, freeze in dannexdownloadmanager::winui::combo_edit) permanece a mesma nos relatórios de um mesmo problema, e a janela pesquisa problemas existentes por ela.
  • Símbolos. As compilações de lançamento mantêm tabelas de linhas (debug = "line-tables-only"), mas nenhum download inclui as informações de depuração. O CI as transforma em DannexDownloadManager-<version>-symbols-<platform>.zip (tools/installer/symbols.py, usando o dump_syms da Mozilla), publicadas junto aos outros arquivos da versão. A janela de relatório busca o arquivo zip da própria versão quando uma pilha mostra endereços sem símbolos.
  • Um .dmp de um problema:

cargo run -p mdm-crash --bin mdm-symbolicate -- crash.dmp DannexDownloadManager-<version>-symbols-windows-x64.zip

  • Testes. cargo test -p mdm-crash executa congelamentos, pânicos e travamentos reais (examples/crashy.rs) e verifica a assinatura de cada relatório. Para testar no aplicativo, inicie o DDM com MDM_CRASH_TEST=1 e execute dannexdownloadmanager /show crash-test:freeze (um deadlock; ou spin, 12 s de uma thread da janela ocupada, panic, crash, abort). cargo test -p mdm-app --test freeze_report -- --ignored faz isso em uma cópia do aplicativo fora da tela, com a janela visível e minimizada.

Gratuito, de código aberto, sem anúncios, sem período de teste.

Baixar Dannex Download Manager