# 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](https://github.com/WeblateOrg/weblate/issues).
## 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`](https://docs.weblate.org/hu/weblate-2026.10/admin/install.md#std-setting-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.
#### SEE ALSO
* [A hibakeresési (debug) mód kikapcsolása](https://docs.weblate.org/hu/weblate-2026.10/admin/install.md#production-debug)
* [Adminisztrátorok helyes beállítása](https://docs.weblate.org/hu/weblate-2026.10/admin/install.md#production-admins)
* [Hibajelentések gyűjtése és teljesítmény monitorozása](https://docs.weblate.org/hu/weblate-2026.10/admin/install.md#collecting-errors)
## 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](https://docs.weblate.org/hu/weblate-2026.10/admin/install.md#celery)) á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`](https://docs.weblate.org/hu/weblate-2026.10/admin/install/docker.md#envvar-WEBLATE_LOGLEVEL) értékét.
#### SEE ALSO
A [Mintakonfiguráció](https://docs.weblate.org/hu/weblate-2026.10/admin/sample.md#sample-configuration) rész tartalmazza a [`LOGGING`](https://docs.djangoproject.com/en/stable/ref/settings/#std-setting-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](https://docs.weblate.org/hu/weblate-2026.10/admin/install.md#celery)
* Mi a Celery várólista állapota – ellenőrizhető a [Kezelőfelület](https://docs.weblate.org/hu/weblate-2026.10/admin/admin.md#management-interface) felületen vagy a [`celery_queues`](https://docs.weblate.org/hu/weblate-2026.10/admin/management.md#weblate-admin-celery_queues) paranccsal
* Vannak-e hibák a Celery naplókban – lásd: [Weblate naplók](#weblate-logs)
## 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`](https://docs.djangoproject.com/en/stable/ref/django-admin/#django-admin-sendtestemail) parancsot (részletek: [Kezelőparancsok futtatása](https://docs.weblate.org/hu/weblate-2026.10/admin/management.md#invoke-manage)) vagy a [Kezelőfelület](https://docs.weblate.org/hu/weblate-2026.10/admin/admin.md#management-interface) 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](https://docs.weblate.org/hu/weblate-2026.10/admin/install.md#out-mail)). 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](#debug-tasks).
## 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](https://docs.weblate.org/hu/weblate-2026.10/admin/install.md#collecting-errors).
## 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](https://docs.weblate.org/hu/weblate-2026.10/admin/install.md#collecting-errors) 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](https://docs.weblate.org/hu/weblate-2026.10/admin/install.md#collecting-errors) 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`](https://docs.weblate.org/hu/weblate-2026.10/admin/install.md#std-setting-DEBUG) engedélyezésre került:
```python
LOGGING["loggers"]["django.db.backends"] = {"handlers": ["console"], "level": "DEBUG"}
```