Logfiles und Debugging

Message Queue prüfen

Übersetzungsjobs laufen asynchron über die Shopware Message Queue. Der Status jedes Jobs (pending, running, completed, failed) ist unter Inhalte > Übersetzung mit DeepL > Queue sichtbar, inklusive Fehlermeldung bei fehlgeschlagenen Jobs.

Voraussetzung für die Verarbeitung ist ein laufender Worker:

bin/console messenger:consume async

Shopware-Log

Warnungen und Fehler der Übersetzungsdienste werden ins Standard-Shopware-Log geschrieben:

tail -f var/log/dev.log | grep "SATAG Link Translation"

In Produktivumgebungen liegt das Log unter var/log/prod-*.log bzw. entsprechend Ihrer Logging-Konfiguration.

CLI-Kommandos

Snippet-Set übersetzen

php bin/console satag:snippets:translate <source-snippet-set-id> <target-snippet-set-id>

Optionen:

Option	Beschreibung
--glossary <id> / -g <id>	DeepL-Glossar für diese Übersetzung verwenden
--ignore-cache	Cache ignorieren und Neu-Übersetzung erzwingen

Das Kommando reiht die Jobs in die Message Queue ein; die Übersetzung erfolgt asynchron durch den Worker.

Verhalten bei DeepL-Fehlern

Situation	Verhalten
HTTP 429 (Rate-Limit)	Automatischer Retry, bis zu 3 Versuche; die von DeepL mitgelieferte Wartezeit (Retry-After-Header) wird berücksichtigt. Danach schlägt der Job fehl und zeigt die Fehlermeldung in der Queue. Details: FAQ: Fehler 429
Netzwerkfehler	Job schlägt fehl mit Verbindungsfehler in der Fehlermeldung; Retry über die Queue-Ansicht möglich
Falsches Glossar (z.B. Sprachpaar passt nicht)	Job schlägt fehl, die DeepL-Fehlermeldung ist in der Queue sichtbar
Kontingent erschöpft	DeepL-Fehlermeldung in der Queue sichtbar; Kontingent unter Inhalte > Übersetzung mit DeepL > DeepL Usage prüfen