Weblate hibakeresés¶
A hibák jelentkezhetnek az alkalmazások összeomlásként vagy egyéb nem várt viselkedésként. Bármilyen ilyen problémáról gyűjtött információt szívesen fogadunk a hibakövető rendszerben.
Hibakeresési mód¶
A hibakeresési mód bekapcsolásával a kivételek megjelennek a böngészőben. Ez hasznos a webes felületen jelentkező hibák diagnosztizálásához, de nem alkalmas éles környezetben való használatra, mert teljesítménybeli hátrányokkal jár, és érzékeny adatokat szivárogtathat ki.
Éles környezetben használja az ADMINS beállítást, hogy e-mailben értesüljön a hibákról vagy konfiguráljon hibagyűjtést külső szolgáltatás segítségével.
Weblate naplók¶
A Weblate részletes naplókat tud készíteni a háttérben zajló folyamatokról. Alapértelmezett beállítások mellett a syslog rendszert használja, így a naplóbejegyzések a /var/log/messages vagy a /var/log/syslog fájlban jelennek meg (a syslog démon konfigurációjától függően).
A Celery folyamat (lásd: Háttérfeladatok Celery használatával) általában saját naplókat is készít. A példa szerinti rendszerszintű beállítás több naplófájlba ír a /var/log/celery/ könyvtár alatt.
A Docker-konténerek a szokásos módon az STDOUT kimenetre naplóznak, így a naplók megtekinthetők a docker compose logs paranccsal. Részletesebb naplókat kaphat, ha módosítja a WEBLATE_LOGLEVEL értékét.
Lásd még
A Mintakonfiguráció rész tartalmazza a LOGGING konfigurációt.
Háttérfeladatok nem futnak¶
Számos művelet a háttérben történik, Celery munkafolyamatok (workers) segítségével. Ha például az e-mailek kiküldése vagy az összetevők eltávolítása nem működik, akkor valószínűleg ezzel kapcsolatos probléma áll fenn.
Ilyen esetben érdemes ellenőrizni a következőket:
Fut-e a Celery folyamat – lásd: Háttérfeladatok Celery használatával
Mi a Celery várólista állapota – ellenőrizhető a Kezelőfelület felületen vagy a
celery_queuesparanccsalVannak-e hibák a Celery naplókban – lásd: Weblate naplók
Nem érkeznek meg az e-mailek a Weblate-től¶
Annak ellenőrzésére, hogy működik-e a kimenő e-mailküldés, használja a sendtestemail parancsot (részletek: Kezelőparancsok futtatása) vagy a Kezelőfelület felület Eszközök fülét.
Ezek az eszközök közvetlenül küldenek e-mailt, így jól ellenőrizhető, hogy megfelelően van-e beállítva az SMTP kapcsolat (lásd: Kimenő e-mailek beállítása). A Weblate e-mailek többsége azonban háttérfolyamatból kerül kiküldésre, így a probléma gyakran a Celery működéséhez köthető. Ennek hibakereséséhez lásd: Háttérfeladatok nem futnak.
Alkalmazások összeomlásának elemzése¶
Ha az alkalmazás összeomlik, érdemes a lehető legtöbb információt összegyűjteni a hibáról. Ebben külső szolgáltatások is segíthetnek, amelyek automatikusan rögzítik az ilyen eseményeket. A beállítás részleteiért lásd: Hibajelentések gyűjtése és teljesítmény monitorozása.
Néma hibák¶
Számos feladat Celery háttérfolyamatban történik, és ezek hibái gyakran nem jelennek meg a felhasználói felületen — csak a Celery naplókban láthatók. A Hibajelentések gyűjtése és teljesítmény monitorozása konfigurálása segít az ilyen hibák időben történő észlelésében.
Teljesítményproblémák¶
Ha a Weblate bizonyos helyzetekben lassan reagál vagy nem megfelelően működik, célszerű naplókat gyűjteni az adott helyzetről, és minden olyan információt, ami segíthet azonosítani a problémát.
A Hibajelentések gyűjtése és teljesítmény monitorozása szakasz bemutatja, hogyan lehet például a Sentry segítségével részletes betekintést nyerni a nem optimálisan működő folyamatokba.
Ha a lassú működés az adatbázissal függ össze, lehetőség van az összes adatbázis-lekérdezés naplózására a következő beállítással, miután a DEBUG engedélyezésre került:
LOGGING["loggers"]["django.db.backends"] = {"handlers": ["console"], "level": "DEBUG"}