Weblate debuggen

Bugs kunnen zich gedragen als een crash van de toepassing of als zich op verschillende manieren misdragen. U wordt uitgenodigd om informatie over elk dergelijk probleem te verzamelen en het in te dienen bij het volgsysteem voor problemen.

Foutopsporingsmodus

Inschakelen van de modus Debuggen zal de uitzonderingen weergeven in de webbrowser. Dat is nuttig om problemen te debuggen in de webinterface, maar is niet geschikt voor een productieomgeving, omdat het consequenties voor de prestaties heeft en persoonlijke gegevens kan lekken.

Gebruik, in een productieomgeving, ADMINS om e-mails te ontvangen die foutberichten bevatten, of configureer het verzamelen van fouten met een service van een derde partij.

Zie ook

Modus Debug uitschakelen, Juist geconfigureerde beheerders, Foutrapporten verzamelen en prestaties monitoren

Logs van Weblate

Weblate kan gedetailleerde logs produceren over wat er op de achtergrond gebeurt. In de standaard configuratie gebruikt het syslog en dat laat het log verschijnen in ofwel /var/log/messages of /var/log/syslog (afhankelijk van de configuratie van uw syslog daemon).

Het proces van Celery (bekijk Achtergrondtaken met Celery) produceert gewoonlijk ook zijn eigen logs. De systeembrede voorbeeldopstellingen loggen naar de verscheidene bestanden onder /var/log/celery/.

Docker containers loggen naar hun uitvoer (zoals gebruikelijk is in de wereld van Docker), dus u kunt de logs bekijken met docker compose logs. U kunt meer gedetailleerde logs verkrijgen door WEBLATE_LOGLEVEL te wijzigen.

Zie ook

Voorbeeld configuratie bevat LOGGING configuratie.

Niet verwerken van taken op de achtergrond

Veel dingen worden op de achtergrond uitgevoerd door werkers van Celery. Als dingen zoals het versturen van e-mails of het verwijderen van ene onderdeel niet werken, zou er een gerelateerd probleem kunnen zijn.

Dingen om in dat geval te controleren:

Geen e-mails ontvangen van Weblate

U kunt verifiëren of de uitgaande mail correct werkt met de beheersopdracht sendtestemail (bekijk Opdrachten voor beheer uitvoeren voor instructies over hoe het op de verschillende omgevingen aan te roepen) of met Beheerinterface onder de tab Gereedschap.

Deze verzenden e-mails direct, verifieer dus dat uw configuratie van SMTP correct is (bekijk Configureren van uitgaande e-mail). De meeste e-mails van Weblate worden echter op de achtergrond verzonden en er zouden ook problemen met Celery betrokken kunnen zijn, bekijk Niet verwerken van taken op de achtergrond voor het debuggen daarvan.

Analyseren van crashes van de toepassing

In het geval de toepassing crasht, is het nuttig zoveel mogelijk informatie over de crash te verzamelen als mogelijk is. Dat kan worden bereikt door services van derde partijen te gebruiken die dergelijke informatie automatisch kunnen verzamelen. U kunt informatie over het instellen hiervan terugvinden in Foutrapporten verzamelen en prestaties monitoren.

Stille mislukkingen

Veel taken worden uitbesteed aan Celery voor verwerken op de achtergrond. Mislukkingen worden niet weergegeven in de gebruikersinterface, maar verschijnen in de logs van Celery. Configureren van Foutrapporten verzamelen en prestaties monitoren helpt u dergelijke mislukkingen gemakkelijker op te merken.

Problemen met prestaties

In het geval Weblate zich slechts gedraagt in bepaalde scenario’s, verzamel dan de relevante logs die het probleem weergeven en alles wat zou kunnen helpen vast te stellen waar de code misschien zou kunnen worden verbeterd.

Bekijk Foutrapporten verzamelen en prestaties monitoren voor informatie over het instellen van Sentry, dat nuttig inzicht kan verschaffen over slecht uitgevoerde bewerkingen.

In het geval de trage prestaties zijn gekoppeld aan de database, kunt u ook het loggen van alle databasequery’s inschakelen met de volgende configuratie na het inschakelen van DEBUG:

LOGGING["loggers"]["django.db.backends"] = {"handlers": ["console"], "level": "DEBUG"}