Debugging Weblate¶
Els errors poden comportar-se com a fallades d’aplicacions o com a mal comportament. Us convidem a recollir informació sobre qualsevol problema d’aquest tipus i enviar-lo al seguidor de problemes.
Mode de depuració¶
Si activeu el mode de depuració, les excepcions es mostraran al navegador web. Això és útil per depurar problemes a la interfície web, però no és adequat per a un entorn de producció perquè té conseqüències de rendiment i pot filtrar dades privades.
En un entorn de producció, utilitzeu ADMINS per rebre correus electrònics que continguin informes d’errors o configureu la recollida d’errors mitjançant un servei de tercers.
Registres del lloc web¶
Weblate pot produir registres detallats del que està passant en segon pla. A la configuració predeterminada, utilitza syslog i això fa que el registre aparegui a /var/log/messages o /var/log/syslog (segons la configuració del vostre dimoni de syslog).
The Celery process (see Tasques de fons amb api) usually produces its own logs as well.
The example system-wide setups logs to several files under /var/log/celery/.
Els contenidors Docker es registren a la seva sortida (com és habitual al món Docker), de manera que podeu consultar els registres mitjançant docker compose logs. Podeu obtenir registres més detallats canviant WEBLATE_LOGLEVEL.
Vegeu també
Exemple de configuració conté la configuració LOGGING.
No es processen tasques en segon pla¶
Moltes coses les fan en segon pla els treballadors de l’api. Si coses com l’enviament de correus electrònics o l’eliminació de components no funcionen, pot ser que hi hagi un problema relacionat.
Things to check in that case:
Check that the Celery process is running, see Tasques de fons amb api
Comproveu l’estat de la cua d’api, ja sigui a Interfície de gestió o utilitzant
celery_queuesBusqueu errors als registres de Celery (vegeu Registres del lloc web)
No rebre correus electrònics de Weblate¶
Podeu verificar si el correu electrònic de sortida funciona correctament utilitzant l’ordre de gestió sendtestemail (vegeu Invocació d’ordres de gestió per obtenir instruccions sobre com invocar-lo en diferents entorns) o utilitzant Interfície de gestió a la pestanya Tools.
Aquests envien correus electrònics directament, de manera que això verifica que la vostra configuració SMTP sigui correcta (vegeu Configuració del correu electrònic de sortida). Tanmateix, la majoria dels correus electrònics de Weblate s’envien en segon pla i també hi pot haver alguns problemes amb Celery, si us plau, vegeu No es processen tasques en segon pla per depurar-ho.
Anàlisi de fallades d’aplicacions¶
En cas que l’aplicació es bloquegi, és útil recollir la màxima informació possible sobre el bloqueig. Això es pot aconseguir mitjançant l’ús de serveis de tercers que poden recopilar aquesta informació automàticament. Podeu trobar informació sobre com configurar-ho a Recollida d’informes d’errors i seguiment del rendiment.
Falles silencioses¶
Es descarreguen moltes tasques a Celery per al processament en segon pla. Els errors no es mostren a la interfície d’usuari, però apareixen als registres de Celery. Configurar Recollida d’informes d’errors i seguiment del rendiment us ajuda a detectar aquests errors més fàcilment.
Problemes de rendiment¶
En cas que Weblate funcioni malament en algun escenari, si us plau, recull els registres pertinents que mostren el problema i qualsevol cosa que pugui ajudar a esbrinar on es pot millorar el codi.
Vegeu Recollida d’informes d’errors i seguiment del rendiment per obtenir informació sobre com configurar Sentry, que pot proporcionar informació útil sobre les operacions que es fan malament.
En cas que el rendiment lent estigui vinculat a la base de dades, també podeu habilitar el registre de totes les consultes de la base de dades mitjançant la configuració següent després d’habilitar DEBUG:
LOGGING["loggers"]["django.db.backends"] = {"handlers": ["console"], "level": "DEBUG"}