Felsökning av Weblate

Buggar kan uppträda som programkrascher eller olika felaktiga funktioner. Du är välkommen att samla information om sådana problem och skicka in den till issue tracker.

Felsökningsläge

Om du aktiverar felsökningsläget visas undantagen i webbläsaren. Detta är användbart för att felsöka problem i webbgränssnittet, men är inte lämpligt för en produktionsmiljö eftersom det påverkar prestandan och kan leda till läckage av privata data.

I en produktionsmiljö använder du ADMINS för att ta emot e-postmeddelanden med felrapporter, eller konfigurerar felinsamling med hjälp av en tredjepartstjänst.

Se även

• Inaktivera felsökningsläge

• Konfigurera administratörer korrekt

• Insamling av felrapporter och övervakning av prestanda

Weblate-loggar

Weblate kan skapa detaljerade loggar över vad som händer i bakgrunden. I standardkonfigurationen används syslog, vilket gör att loggen visas antingen i /var/log/messages eller /var/log/syslog (beroende på din syslog-daemonkonfiguration).

Celery-processen (se Bakgrundsuppgifter med Celery) genererar vanligtvis också egna loggar. I exemplet loggas systemomfattande inställningar till flera filer under /var/log/celery/.

Docker-containrar loggar till sin utdata (som vanligt i Docker-världen), så du kan titta på loggarna med docker compose logs. Du kan få mer detaljerade loggar genom att ändra WEBLATE_LOGLEVEL.

Se även

Exempel på konfiguration innehåller LOGGING-konfigurationen.

Bearbetar inte bakgrundsuppgifter

Många saker görs i bakgrunden av Celery-arbetare. Om saker som att skicka e-post eller ta bort komponenter inte fungerar kan det finnas ett relaterat problem.

Saker att kontrollera i det fallet:

• Kontrollera att Celery-processen körs, se Bakgrundsuppgifter med Celery

• Kontrollera statusen för Celery-kön, antingen i Hanteringsgränssnitt eller med hjälp av celery_queues

• Leta efter fel i Celery-loggarna (se Weblate-loggar)

Får inte e-post från Weblate

Du kan kontrollera om utgående e-post fungerar korrekt genom att använda sendtestemail-hanteringskommandot (se Använda administrationskommandon för instruktioner om hur du anropar det i olika miljöer) eller genom att använda Hanteringsgränssnitt under fliken Verktyg.

Dessa skickar e-post direkt, så detta verifierar att din SMTP-konfiguration är korrekt (se Konfigurera utgående e-post). De flesta e-postmeddelanden från Weblate skickas dock i bakgrunden och det kan också finnas vissa problem med Celery. Se Bearbetar inte bakgrundsuppgifter för felsökning av detta.

Analysera programkrascher

Om applikationen kraschar är det bra att samla in så mycket information om kraschen som möjligt. Detta kan göras med hjälp av tjänster från tredje part som automatiskt samlar in sådan information. Information om hur du konfigurerar detta finns i Insamling av felrapporter och övervakning av prestanda.

Tysta fel

Många uppgifter överförs till Celery för bakgrundsbehandling. Fel visas inte i användargränssnittet, men visas i Celery-loggarna. Genom att konfigurera Insamling av felrapporter och övervakning av prestanda kan du lättare upptäcka sådana fel.

Prestationsproblem

Om Weblate fungerar dåligt i vissa situationer, samla in relevanta loggar som visar problemet och allt som kan hjälpa till att ta reda på var koden kan förbättras.

Se Insamling av felrapporter och övervakning av prestanda för information om hur du konfigurerar Sentry, som kan ge användbar information om operationer som fungerar dåligt.

Om den långsamma prestandan är kopplad till databasen kan du också aktivera loggning av alla databasfrågor med följande konfiguration efter att ha aktiverat DEBUG:

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