mirror of
https://gh.wpcy.net/https://github.com/WeblateOrg/weblate.git
synced 2026-05-05 11:21:53 +08:00
4eb4fe6e86
* Spelling: Sentence, to to * Spelling: that * Spelling: Reworked, in * Spelling: remain * Spelling: An, to, a * Spelling: the, for * Spelling: this * Spelling: repository, in * Spelling: list * Spelling: are * Spelling: the * Spelling: no field is defined, are * Spelling: written * Spelling: occurrences * Spelling: the, isolation * Spelling: Grouping * Spelling: will be
60 lines
2 KiB
ReStructuredText
60 lines
2 KiB
ReStructuredText
Debugging Weblate
|
||
=================
|
||
|
||
Bugs can behave as application crashes or as misbehavior.
|
||
You are welcome to collect info on any such issue and submit it to the `issue tracker
|
||
<https://github.com/WeblateOrg/weblate/issues>`_.
|
||
|
||
Debug mode
|
||
----------
|
||
|
||
Turning on debug mode will make the exceptions show in the browser. This is useful to
|
||
debug issues in the web interface, but not suitable for production environment
|
||
as it has performance consequences and might leak private data.
|
||
|
||
.. seealso::
|
||
|
||
:ref:`production-debug`
|
||
|
||
Weblate logs
|
||
------------
|
||
|
||
Weblate can produce detailed logs of what is going in the background. In
|
||
the default configuration it uses syslog and that makes the log appear either in
|
||
:file:`/var/log/messages` or :file:`/var/log/syslog` (depending on your syslog
|
||
daemon configuration).
|
||
|
||
Docker containers log to their output (as usual in the Docker world), so
|
||
you can look at the logs using ``docker-compose logs``.
|
||
|
||
.. seealso::
|
||
|
||
:ref:`sample-configuration` contains :setting:`django:LOGGING` configuration.
|
||
|
||
Analyzing application crashes
|
||
-----------------------------
|
||
|
||
In case the application crashes, it is useful to collect as much info about
|
||
the crash as possible. The easiest way to achieve this is by using third-party
|
||
services which can collect such info automatically. You can find
|
||
info on how to set this up in :ref:`collecting-errors`.
|
||
|
||
Silent failures
|
||
---------------
|
||
|
||
Lots of tasks are offloaded to Celery for background processing.
|
||
Failures are not shown in the user interface, but appear in the Celery
|
||
logs. Configuring :ref:`collecting-errors` helps you to notice such
|
||
failures easier.
|
||
|
||
Performance issues
|
||
------------------
|
||
|
||
In case Weblate performs badly in some situation, please collect the relevant logs
|
||
showing the issue, and anything that might help figuring out where the code might be
|
||
improved.
|
||
|
||
In case some requests take too long without any indication, you might
|
||
want to install `dogslow <https://pypi.org/project/dogslow/>` along with
|
||
:ref:`collecting-errors` and get pinpointed and detailed tracebacks in
|
||
the error collection tool.
|
