Depurar Weblate¶
Los defectos pueden manifestarse como fallos de la aplicación o diversos comportamientos incorrectos. Le invitamos a recopilar información sobre cualquier problema de este tipo y enviarla al seguimiento de incidencia.
Modo de depuración¶
Al activar el modo de depuración, las excepciones se mostrarán en el navegador web. Esto es útil para depurar incidencias en la interfaz web, pero no es adecuado para un entorno de producción, ya que afecta al rendimiento y podría filtrar datos privados.
En un entorno de producción, utilice ADMINS para recibir correos electrónicos que contengan informes de errores o configure la recopilación de errores mediante un servicio de terceros.
Bitácoras de Weblate¶
Weblate puede generar bitácoras detalladas de lo que ocurre en segundo plano. En la configuración predeterminada, utiliza syslog, lo que hace que la bitácora del sistema aparezca en /var/log/messages o /var/log/syslog (según la configuración del demonio de syslog).
El proceso Celery (consulte Tareas en segundo plano con Celery) también suele generar sus propias bitácoras. El ejemplo configura las bitácoras en varios archivos de todo el sistema en /var/log/celery/.
Los contenedores Docker registran su salida (como es habitual en el mundo Docker), por lo que puedes consultar las bitácoras usando docker compose logs. Puedes obtener registros más detallados modificando WEBLATE_LOGLEVEL.
Ver también
Configuración de muestra contiene LOGGING para configuración.
No procesar tareas en segundo plano¶
Los trabajadores de Celery realizan muchas tareas en segundo plano. Si tareas como el envío de correos-e o la eliminación de componentes no funcionan, podría haber una incidencia relacionada.
Elementos que revisar en este caso:
Compruebe que el proceso Celery esté ejecutándose, consulte Tareas en segundo plano con Celery
Verifique el estado de la cola de Celery, ya sea en Interfaz administrativa o usando
celery_queuesBusque errores en las bitácoras de Celery (consulte Bitácoras de Weblate)
No recepciona correos-e desde Weblate¶
Puede verificar si el correo electrónico saliente está funcionando correctamente utilizando el comando de administración sendtestemail (consulte Invocar órdenes de gestión para obtener instrucciones sobre cómo invocarlo en diferentes entornos) o utilizando Interfaz administrativa en la pestaña Herramientas.
Estos envían correos electrónicos directamente, lo que verifica que la configuración de SMTP sea correcta (consulte Configurar el correo electrónico saliente). Sin embargo, la mayoría de los correos electrónicos de Weblate se envían en segundo plano, por lo que también podría haber incidencias con Celery. Consulte No procesar tareas en segundo plano para depurarlo.
Analizar cuelgues de aplicación¶
En caso de fallo de la aplicación, es útil recopilar la mayor cantidad de información posible sobre el fallo. Esto se puede lograr mediante servicios de terceros que recopilan dicha información automáticamente. Puede encontrar información sobre cómo configurar esto en Recopilación de informes de errores y supervisión del rendimiento.
Fallos silenciosos¶
Muchas tareas se transfieren a Celery para su procesamiento en segundo plano. Los fallos no se muestran en la interfaz de usuario, sino en las bitácoras de Celery. Configurar Recopilación de informes de errores y supervisión del rendimiento facilita la detección de estos fallos.
Incidencias de rendimiento¶
En caso que Weblate funcione mal en algún escenario, recopile las bitácoras relevantes que muestren la incidencia y cualquier cosa que pueda ayudar a determinar donde se puede mejorar el código.
Consulte Recopilación de informes de errores y supervisión del rendimiento para obtener información sobre los ajustes de Sentry, que puede proporcionar información útil sobre operaciones con mal rendimiento.
En caso que el rendimiento lento esté relacionado con la base de datos, también puede habilitar el registro de todas las consultas de la base de datos utilizando la siguiente configuración tras habilitar DEBUG:
LOGGING["loggers"]["django.db.backends"] = {"handlers": ["console"], "level": "DEBUG"}