Weblate hatalarını ayıklamak#
Hatalar, uygulama çökmelerine veya çeşitli yanlış davranışlara yol açabilir. Böyle bir sorun ile ilgili bilgi toplayabilir ve sorun izleyici üzerine gönderebilirsiniz.
Hata ayıklama kipi#
Hata ayıklama kipinin açılması, özel durumların tarayıcıda görüntülenmesini sağlar. Bu kip, site arayüzündeki sorunları ayıklamak için yararlıdır. Ancak başarımı olumsuz etkilediğinden ve kişisel verileri sızdırabileceğinden üretim ortamı için uygun değildir.
Üretim ortamında, hata raporları ile ilgili e-postaları almak için ADMINS
komutunu kullanın ya da bir üçüncü taraf hizmeti kullanarak hata toplamayı yapılandırın.
Weblate günlükleri#
Weblate, arka planda neler olup bittiği ile ilgili ayrıntılı günlükler tutabilir. Varsayılan yapılandırmada syslog kullanılır ve bu da günlüğün /var/log/messages
veya /var/log/syslog
içinde tutulmasını sağlar (syslog daemon yapılandırmanıza bağlı olarak).
Celery işlemi (bilgi almak için Celery ile arka plan görevlerini kullanmak) genellikle kendi günlüklerini de tutar. Örnek sistem genelindeki kurulumlarda günlükler /var/log/celery/
altındaki birkaç dosyaya kaydedilir.
Docker containers log to their output (as per usual in the Docker world), so
you can look at the logs using docker compose logs
. You can get more
detailed logs by changing WEBLATE_LOGLEVEL
.
Ayrıca bakınız
Örnek yapılandırma içinde LOGGING
yapılandırması bulunur.
Arka plan görevleri yapılamıyor#
Celery işlemleri tarafından arka planda birçok şey yapılır. E-posta gönderme ya da bileşen kaldırma gibi işlemler yapılmıyorsa, bununla ilgili bir sorun olabilir.
Bu durumda şunlar denetlenmelidir:
Celery işleminin çalışıp çalışmadığını denetleyin. Bilgi almak için: ref:celery
Check the Celery queue status, either in Yönetim arayüzü, or using
weblate celery_queues
Hatalar için Celery günlüklerine bakın (bilgi almak için: Weblate günlükleri)
Weblate e-postaları alınamıyor#
Giden e-postanın düzgün çalışıp çalışmadığını sendtestemail
yönetim komutuyla (farklı ortamlarda nasıl çağrılacağı ile ilgili bilgi almak için: Yönetim komutlarını çağırmak) ya da Araçlar sekmesi altındaki Yönetim arayüzü komutuyla doğrulayabilirsiniz.
Bunlar e-postaları doğrudan gönderir. Böylece SMTP yapılandırmanızın doğru olduğunu doğrular (bilgi almak için: Giden e-postayı yapılandırmak). Bununla birlikte, Weblate üzerinden gelen e-postaların çoğu arka planda gönderilir ve Celery ile ilgili bazı sorunlar da olabilir. Hata ayıklama için Arka plan görevleri yapılamıyor bölümüne bakabilirsiniz.
Uygulama çökmelerini incelemek#
Uygulamanın çökmesi durumunda, çökme ile ilgili olabildiğince fazla bilgi toplamak yararlıdır. Bunun için, bu tür bilgileri kendiliğinden toplayabilen üçüncü taraf hizmetleri kullanılabilir. Nasıl ayarlanacağı ile ilgili bilgi almak için Hata raporlarını derlemek.
Sessiz hatalar#
Arka plan işleme için birçok görev Celery üzerine aktarılmıştır. Hatalar kullanıcı arabiriminde görüntülenmez, ancak Celery günlüklerinde görünür. Hata raporlarını derlemek komutunu yapılandırmak, bu tür hataları daha kolay fark etmenizi sağlar.
Başarım sorunları#
Bazı senaryolarda Weblate başarımı kötü oluyorsa, sorunu gösteren günlük kayıtlarını ve kodun nasıl geliştirilebileceğini anlamamıza yardımcı olabilecek her şeyi toplayın.
Bazı isteklerin herhangi bir belirti olmadan çok uzun sürmesi durumunda, Hata raporlarını derlemek ile birlikte dogslow kurmak ve hata toplama aracında kesin ve ayrıntılı geri izlemeler almak isteyebilirsiniz.
Yavaş başarımın veri tabanına bağlı olması durumunda, DEBUG
komutunu etkinleştirdikten sonra aşağıdaki yapılandırmayı kullanarak tüm veri tabanı sorgularının günlüğe kaydedilmesini de sağlayabilirsiniz:
LOGGING["loggers"]["django.db.backends"] = {"handlers": ["console"], "level": "DEBUG"}