Użycie
UżycieLogi & Powiadomienia

Logi & Powiadomienia

Logi wyświetlają dane związane z wykonaniem każdego query GraphQL, w tym:

  • Nazwa query
  • Zmienne przekazane do query
  • Odpowiedź z wykonania
  • Dodatkowy kontekst (komunikat błędu itp.)

Logi są przechowywane w folderze wp-content/gato-ai-translations-for-polylang/logs.

Logi pomagają nam ustalić, co poszło nie tak, gdy tłumaczenia nie zostały ukończone.

Ustawienia logów

Ustawienia logów można znaleźć w Settings > Plugin Configuration > Logs & Notifications.

Ustawienia Logs & Notifications
Ustawienia Logs & Notifications

W ustawieniach możemy skonfigurować:

  • Włączenie/wyłączenie logowania i powiadomień (domyślnie oba włączone)
  • Poziomy ważności, które będą rejestrowane (domyślnie 🔴 Error i 🟡 Warning)
  • Poziomy ważności, które będą wyzwalać powiadomienie (domyślnie 🔴 Error)

Poziomy ważności logów

Istnieją 4 poziomy ważności:

Poziom ważnościOpis
🔴 ErrorKrytyczne problemy uniemożliwiające ukończenie operacji
Przykład: Brak klucza API
🟡 WarningNiekrytyczne problemy, które mogą wpływać na operację
Przykład: Brak postów do przetłumaczenia
🔵 InfoOgólne informacje o operacji
Przykład: Żądanie wysłane do API
🟢 DebugSzczegółowe informacje do celów debugowania
Przykład: Operacja zakończona pomyślnie

Powiadomienia

Za każdym razem, gdy do logów zostanie dodany wpis (dla dowolnego ze skonfigurowanych poziomów ważności), w menu wtyczki zostanie wyświetlona odznaka powiadomienia (zarówno pod nazwą wtyczki, jak i pod pozycją menu Logs).

Odznaka powiadomienia
Odznaka powiadomienia

Jest to przydatne, aby wiedzieć, że tłumaczenie nie powiodło się, oraz do przeglądania logów w celu ustalenia, na czym polega problem.

Dostęp do logów

Dostęp do logów można uzyskać, klikając Logs w menu wtyczki:

Przeglądanie logów
Przeglądanie logów

Kliknięcie wpisu logu umożliwia wyświetlenie szczegółów tego logu:

Wyświetlanie pojedynczego logu
Wyświetlanie pojedynczego logu

W szczegółach logu kliknięcie przycisku Download spowoduje pobranie pliku logu.

Odwrócona kolejność

Logi mogą być wyświetlane w odwróconej kolejności (najnowsze pierwsze), dzięki czemu można zobaczyć najnowsze wpisy bez przewijania do końca.

Aby to włączyć, aktywuj opcję Reverse log order?.

Włączanie odwróconej kolejności w ustawieniach Logs & Notifications
Włączanie odwróconej kolejności w ustawieniach Logs & Notifications

Queries

W każdym wpisie logu sekcja [Query "..."] wskazuje, które query zostało wykonane:

  • "create-missing-translation-customposts": Query tworzące wpisy tłumaczenia dla custom posts
  • "translate-customposts": Query tłumaczące custom posts
  • "create-missing-translation-media": Query tworzące wpisy tłumaczenia dla elementów multimedialnych
  • "translate-media": Query tłumaczące właściwości mediów
  • Inne

Konserwacja logów

Aby zapobiec nadmiernemu zużyciu miejsca na dysku przez logi, zaleca się ich okresowe czyszczenie.