Çökme raporları

Mister Download Manager beklenmedik şekilde kapanır veya yanıt vermeyi durdurursa, bir kilitlenme raporu penceresi açılır. Bu pencere ne olduğunu gösterir, tüm raporu okumanızı sağlar ve GitHub'daki geliştiricilere gönderebilir. Her rapor, sorunu herkes için düzeltmeye yardımcı olur.

Ne görüyorsunuz

• Mister Download Manager beklenmedik şekilde kapandı: MDM çöktü veya dahili bir hatayla karşılaşıp kapandı.
• Mister Download Manager yanıt vermeyi durdurdu: penceresi 8 saniye boyunca yanıt vermedi. MDM hala çalışıyor, donmuş durumda. MDM'yi sonlandır ve yeniden başlat donmuş kopyayı kapatır ve yeni bir tane başlatır. MDM kendi kendine tekrar yanıt verirse, pencere bunu belirtir.

Pencerede:

1. Olay olduğunda ne yapıyordunuz? isteğe bağlıdır. "URL Ekle'yi açtım" gibi birkaç kelime çok yardımcı olur.
2. Rapor gönderilecek her şeyi gösterir. İsterseniz önce okuyun.
3. GitHub'a gönder, tarayıcınızda GitHub'ın Kilitlenme raporu formunu, raporu içeren klasörle birlikte önceden doldurulmuş olarak açar. Rapor dosyasını forma sürükleyin, kontrol edin ve gönderin. Bir GitHub hesabınızın olması gerekir. Hiçbir şey kendi kendine gönderilmez.
4. Birisi aynı sorunu zaten bildirdiyse, pencere bunu belirtir (Zaten #… sorunu olarak bildirildi). Bildirilen sorunu aç onu açar ve raporunuzu panoya kopyalar, böylece yorum olarak ekleyebilirsiniz.

Diğer düğmeler raporu kopyalar, klasörünü açar veya MDM'yi tekrar başlatır.

Bir rapor ne içerir

• Ne oldu: hata ve MDM'nin kodunda nerede meydana geldiği.
• Yığın: MDM'nin kodunda nerede çöktüğü veya donduğu ve diğer her bölümünün ne yaptığı.
• MDM'nin son günlüğü: örneğin "komut AddUrl" veya "pencere açıldı: add-url".
• Sistem: MDM'nin sürümü ve nasıl kurduğunuz, işletim sisteminiz ve sürümü, işlemci, dil ve tema ile sahip olduğunuz indirme ve kuyruk sayısı. Bunlar sadece sayılardır.

Şunları içermez:

• indirme adresleriniz veya dosya adlarınız;
• klasör yollarında ~ olarak görünen kullanıcı adınız.

Bir hata mesajı yazdığınız bir şeyi alıntılıyorsa, o metin raporda yer alır, bu yüzden göndermeden önce okuyun.

Kilitlenme veri dosyası (.dmp), MDM'nin o anda ne çalıştırdığının bir anlık görüntüsüdür. Geliştiricilere en çok yardımcı olur, ancak MDM'nin belleğinde bulunan indirme adresleri gibi parçaları içerebilir. Yalnızca Kilitlenme verilerini de ekle seçeneğini işaretlediğinizde eklenir.

Raporlar nerede saklanır

MDM'nin veri klasöründe:

• crashes\: her rapor (.txt) ve kilitlenme verileri (.dmp);
• logs\: MDM'nin günlüğü (mdm.log, eskileri mdm.1.log vb. olarak, her biri 2 MB).

MDM'nin veri klasörü Windows'ta %APPDATA%\misterdownloadmanager, macOS'ta ~/Library/Application Support/misterdownloadmanager ve Linux'ta ~/.local/share/misterdownloadmanager konumundadır. Taşınabilir modda programın yanındaki data klasörüdür.

Günlük, MDM'nin ne yaptığını kaydeder, böylece bir rapor bir soruna neyin yol açtığını gösterebilir. Daha fazla ayrıntı kaydetmek için MDM'yi MDM_LOG=debug ortam değişkeniyle başlatın.

Geliştiriciler için

Nasıl çalışır: MDM'nin ikinci bir kopyası, izleyici, --crash-monitor ile birlikte başlar. Kilitlenme kodu crates/crash ve crates/app/src/crash.rs içinde bulunur.

• Sorunları yakalama. MDM çöktüğünde (bir Windows istisnası, Linux'ta bir sinyal, macOS'ta bir Mach istisnası), paniklediğinde veya donduğunda, izleyiciden bir döküm ister. Donma, uykuya harcanan zamanı göz ardı eden bir izleyici iş parçacığı tarafından görülen, 8 saniyeden fazla çalışan pencerenin bir çerçevesidir. İzleyici daha sonra minidumper ve crash-handler aracılığıyla dışarıdan her iş parçacığının bir minidump'ını yazar. Çöken bir işlem asla kendi dökümünü yazmaz, Firefox, Crashpad ve Sentry de bunu böyle yapar.
• Dökümü okuma. Monitör, Mozilla'nın rust-minidump ile dökümü okur. Sürümün Breakpad sembolleri bulunursa onları kullanır veya kaynaktan derlenmiş bir yapının yanındaki yerel hata ayıklama bilgilerini kullanır. Raporun İmzası (örneğin freeze in misterdownloadmanager::winui::combo_edit) aynı sorunun raporlarında aynı kalır ve pencere, mevcut sorunları bu imza için arar.
• Semboller. Sürüm yapıları satır tablolarını (debug = "line-tables-only") tutar, ancak hiçbir indirme hata ayıklama bilgilerini içermez. CI bunu MisterDownloadManager-<version>-symbols-<platform>.zip'e (tools/installer/symbols.py, Mozilla'nın dump_syms kullanarak) dönüştürür ve sürümün diğer dosyalarının yanında yayınlar. Bir yığın çıplak adresler gösterdiğinde rapor penceresi kendi sürümü için zip dosyasını getirir.
• Bir sorundan .dmp:

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

• Test etme. cargo test -p mdm-crash gerçek bir donma, panik ve çökme (examples/crashy.rs) çalıştırır ve her raporun imzasını kontrol eder. Uygulamada denemek için MDM'yi MDM_CRASH_TEST=1 ile başlatın, ardından misterdownloadmanager /show crash-test:freeze'i (veya panic, crash, abort) çalıştırın.