Ladenie Weblate

Chyby sa môžu prejavovať ako pády aplikácie alebo ako rôzne nesprávne správanie. Môžete zbierať informácie o akomkoľvek takomto probléme a odoslať ich do sledovača problémov.

Ladiaci režim

Zapnutie ladiaceho režimu spôsobí, že sa výnimky zobrazia vo webovom prehliadači. Toto je užitočné na ladenie problémov vo webovom rozhraní, ale nie je vhodné pre produkčné prostredie, pretože má dopad na výkon a môže uniknúť súkromné údaje.

V produkčnom prostredí použite ADMINS na prijímanie e-mailov obsahujúcich hlásenia chýb alebo nakonfigurujte zber chýb pomocou služby tretej strany.

Viď aj

Logy Weblate

Weblate môže generovať podrobné logy toho, čo sa deje na pozadí. V predvolenej konfigurácii používa syslog a to spôsobí, že sa log objaví buď v /var/log/messages alebo /var/log/syslog (v závislosti od konfigurácie vášho syslog daemona).

Proces Celery (pozrite Úlohy na pozadí pomocou Celery) zvyčajne tiež produkuje svoje vlastné logy. Príklad systémových nastavení loguje do niekoľkých súborov pod /var/log/celery/.

Docker kontajnery logujú do svojho výstupu (ako je zvykom vo svete Docker), takže sa môžete pozrieť na logy pomocou docker compose logs. Podrobnejšie logy môžete získať zmenou WEBLATE_LOGLEVEL.

Viď aj

Vzorová konfigurácia obsahuje konfiguráciu LOGGING.

Nespracúvajú sa úlohy na pozadí

Mnoho vecí sa robí na pozadí pracovníkmi Celery. Ak veci ako odosielanie e-mailov alebo odstraňovanie komponentov nefungujú, môže ísť o súvisiaci problém.

Veci, ktoré treba v takom prípade skontrolovať:

Neprijímanie e-mailov z Weblate

Môžete overiť, či odchádzajúci e-mail funguje správne, použitím manažérskeho príkazu sendtestemail (pozrite Vyvolávanie manažérskych príkazov pre inštrukcie, ako ho vyvolať v rôznych prostrediach) alebo použitím Rozhranie na správu na karte Nástroje.

Tieto posielajú e-maily priamo, takže to overuje, že vaša konfigurácia SMTP je správna (pozrite Konfigurácia odchádzajúcej pošty). Väčšina e-mailov z Weblate sa však posiela na pozadí a môžu byť zapojené aj nejaké problémy s Celery, pozrite Nespracúvajú sa úlohy na pozadí pre ladenie toho.

Analýza pádov aplikácie

V prípade, že aplikácia spadne, je užitočné zozbierať čo najviac informácií o páde. Toho sa dá dosiahnuť použitím služieb tretej strany, ktoré môžu zbierať takéto informácie automaticky. Informácie o tom, ako to nastaviť, nájdete v Zhromažďovanie hlásení chýb a monitorovanie výkonu.

Tiché zlyhania

Mnohé úlohy sa presúvajú do Celery na spracovanie na pozadí. Zlyhania sa nezobrazujú v používateľskom rozhraní, ale objavia sa v logoch Celery. Nastavenie Zhromažďovanie hlásení chýb a monitorovanie výkonu vám pomôže tieto zlyhania jednoduchšie odhaliť.

Problémy s výkonom

V prípade, že Weblate funguje zle v niektorom scenári, prosím, zozbierajte relevantné logy ukazujúce problém a čokoľvek, čo by mohlo pomôcť zistiť, kde by sa kód mohol zlepšiť.

Pozrite Zhromažďovanie hlásení chýb a monitorovanie výkonu pre informácie o nastavení Sentry, ktoré môže poskytnúť užitočné poznatky o zle fungujúcich operáciách.

V prípade, že pomalý výkon súvisí s databázou, môžete tiež povoliť logovanie všetkých databázových dotazov pomocou nasledujúcej konfigurácie po povolení DEBUG:

LOGGING["loggers"]["django.db.backends"] = {"handlers": ["console"], "level": "DEBUG"}