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 deixar de responder, abre-se uma janela de relatório de erros. Mostra o que aconteceu, permite ler o relatório completo e pode enviá-lo aos programadores no GitHub. Cada relatório ajuda a corrigir o problema para todos.

A janela de relatório de falhas depois de o DDM parar de responder

O que vê

  • Dannex Download Manager fechou inesperadamente: o DDM falhou ou encontrou um erro interno e fechou.
  • Dannex Download Manager deixou de responder: a sua janela não respondeu durante 8 segundos. O DDM ainda está a ser executado, congelado. Terminar e reiniciar o DDM fecha a cópia congelada e inicia uma nova. Se o DDM voltar a responder sozinho, a janela indica-o.

Na janela:

  1. O que estava a fazer 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, juntamente com a pasta que contém o relatório. Arraste o ficheiro do relatório para o formulário, verifique-o e envie. Precisa de uma conta GitHub. Nada é enviado automaticamente.
  4. Se alguém já reportou o mesmo problema, a janela indica-o (Já reportado como problema #…). Abrir o problema reportado abre-o e coloca o seu relatório na área de transferência, para que possa adicioná-lo como um comentário.

Os outros botões copiam o relatório, abrem a sua 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 falhou ou congelou, e o que todas as outras partes estavam a fazer.
  • Registo recente do DDM: por exemplo "comando AddUrl" ou "janela aberta: add-url".
  • O sistema: a versão do DDM e como o instalou, o seu sistema operativo e a sua versão, o processador, o idioma e o tema, e quantos downloads e filas tem. São apenas contagens.

Não contém o seguinte:

  • os seus endereços de download ou nomes de ficheiro;
  • o seu nome de utilizador, que aparece como ~ nos caminhos das pastas.

Se uma mensagem de erro citar algo que digitou, esse texto está no relatório, por isso leia-o antes de enviar.

O ficheiro de dados de falha (.dmp) é um instantâneo do que o DDM estava a executar naquele momento. Ajuda mais os programadores, mas pode conter partes do que o DDM tinha em memória, como endereços de download, cookies e palavras-passe guardadas. É anexado apenas quando marca Também anexar os dados de falha.

Onde os relatórios são guardados

Na pasta de dados do DDM:

  • crashes\: cada relatório (.txt) e os seus dados de falha (.dmp);
  • logs\: o registo 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 registo grava o que o DDM faz, para que um relatório possa mostrar o que levou a um problema. Para registar mais detalhes, inicie o DDM com a variável de ambiente MDM_LOG=debug.

Para programadores

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

  • Deteção de problemas. Quando o DDM falha (uma exceção do Windows, um sinal no Linux, uma exceção Mach no macOS), entra em pânico ou congela, pede um despejo ao monitor. Um congelamento é um fotograma da janela a correr por mais de 8 s, detetado por um processo de monitorização que ignora o tempo de inatividade. Cronometra ambas as partes de um fotograma: o que o DDM gere (os comandos que chegam, o relógio das transferências, filas e o Agendador), que também funciona minimizado, e o desenho; nunca a espera entre fotogramas. O processo de monitorização também mede quanto tempo de processador o processo da janela obteve entretanto, e o relatório indica o que isso significa: funcionou o tempo todo (um ciclo), esperou num bloqueio ou em E/S (um impasse), ou mal funcionou em código comum, o que significa que o computador está demasiado ocupado para executar o DDM ou lento a carregá-lo do disco, muito provavelmente não sendo um erro do DDM (estes partilham uma assinatura, freeze while the computer was busy). Se o processo da janela já tiver regressado ao ciclo de eventos no momento em que o despejo é escrito, o congelamento terminou antes do instantâneo, pelo que a sua pilha não o consegue explicar; esses relatórios indicam-no e partilham a assinatura freeze over before the snapshot. O macOS ainda não o mede. O monitor escreve então um minidespejo de cada processo a partir do exterior, através de minidumper e crash-handler. Um processo com falha nunca escreve o seu próprio despejo, que é como o Firefox, o Crashpad e o Sentry também o fazem.
  • Ler o ficheiro de descarga. O monitor lê o ficheiro de descarga com o rust-minidump da Mozilla. Utiliza os símbolos Breakpad da versão quando estes estão disponíveis. Uma compilação a partir do código-fonte também pode ler as informações de depuração nativas que a acompanham (o seu .pdb, DWARF) quando é compilada com --features mdm-crash/native-symbols; a aplicação distribuída não inclui esse leitor, que ocupa vários MB. A Assinatura do relatório (por exemplo, freeze in dannexdownloadmanager::winui::combo_edit) mantém-se igual em todos os relatórios do mesmo problema, e a janela procura problemas existentes com essa assinatura.
  • Símbolos. As compilações de lançamento mantêm as tabelas de linhas (debug = "line-tables-only"), mas nenhuma transferência inclui as informações de depuração. O CI converte-as em DannexDownloadManager-<version>-symbols-<platform>.zip (tools/installer/symbols.py, usando o dump_syms da Mozilla), publicados junto dos restantes ficheiros da versão. A janela do relatório obtém o ficheiro zip da sua própria versão quando uma pilha apresenta apenas endereços.
  • Um .dmp de um problema:

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

  • Testar. cargo test -p mdm-crash provoca um bloqueio, um pânico e uma falha reais (examples/crashy.rs) e verifica a assinatura de cada relatório. Para experimentar na aplicação, inicie o DDM com MDM_CRASH_TEST=1 e, em seguida, execute dannexdownloadmanager /show crash-test:freeze (um impasse; ou spin, 12 s de atividade intensa na linha de execução da janela, panic, crash, abort). cargo test -p mdm-app --test freeze_report -- --ignored faz isso numa cópia da aplicação, fora do ecrã, com a janela visível e minimizada.

Gratuito, de código aberto, sem anúncios, sem período de avaliação.

Transferir Dannex Download Manager