调试 Weblate

缺陷的症状可以是应用崩溃或行为错误。欢迎您搜集任何这样的问题的信息,并将其提交给 issue tracker

调试模式

打开调试模式将在浏览器中显示例外。这在 web 界面上调试问题非常有用,但不适于生产环境,因为这回导致性能问题,并泄露私有数据。

Weblate 日志

Weblate 可以生成关于后台什么在运行的具体日志。在默认配置中,它使用 syslog,并使日志出现在 /var/log/messages/var/log/syslog 中(依赖于您的 syslog 守护程序配置)。

Celery 进程(请参见 使用 Celery 的后台任务)通常也产生自己的日志。示例的系统范围的设置被记录到 /var/log/celery/ 下的几个日志文件中。

Docker 容器将其输入记入日志(如同 Docker 世界中通常的那样),因此可以使用 docker-compose logs 来查看日志。

参见

配置的例子 包含 LOGGING 配置。

分析应用的崩溃

在应用崩溃的情况下,尽可能多地收集与崩溃有关的信息是非常有用的。最容易的方式是使用第三方服务来实现,这些服务会自动收集这样的信息。可以在 :ref:`collecting-errors`找到如何设置的信息。

无报告的故障

很多任务写在到 Celery 进行后台处理。故障不显示在用户界面上,但出现在 Celery 的日志中。配置 收集错误报告 会帮助您更容易地注意到这样的故障。

性能问题

Weblate 在这样的情形性能很差的情况下,请收集显示问题的相关日志,以及有助于找到从哪里改进代码的任何事物。

在一些请求耗费很长时间没有任何指示的情况下,您会想要安装 dogslow <https://pypi.org/project/dogslow/> 以及 收集错误报告 并在错误收集工具中得到精确定位且具体的追溯。