Freedomification Plugins Log Viewer PRO — Dokumentacja

13. Rozwiązywanie problemów / workflow

Ta końcowa sekcja zawiera praktyczne kroki dla najczęstszych sytuacji, na które może trafić użytkownik PRO. To bardziej szybki workflow niż rozdział oparty o screenshoty, bo troubleshooting zwykle polega na wybraniu właściwego sprawdzenia we właściwej kolejności.

Zalecany workflow troubleshooting

1. Zacznij od konkretnego logu. Otwórz problematyczny log w Log Viewer i sprawdź, czy nadal istnieje, jest czytelny i pokazuje nową treść.
2. Zrób mały test. Wywołaj jedną znaną akcję na stronie, a potem użyj Refresh, Auto-refresh, Live Tail albo Diff, aby zobaczyć, czy pojawia się nowa linia.
3. Sprawdź Log Inspector. Użyj Full info, aby potwierdzić status logu, safe path, rozmiar, udział w Log Hub, udział w Reports, alerty i diagnostykę.
4. Sprawdź powiązany moduł. Jeśli problem dotyczy Reports, sprawdź filtry Reports. Jeśli alertów, sprawdź Email Alerts i Webhooks. Jeśli czyszczenia, sprawdź Maintenance targets.
5. Zmieniaj jedną rzecz naraz. Podczas debugowania unikaj zmiany wielu ustawień jednocześnie.
6. Eksportuj ustawienia przed większymi zmianami. Użyj Export przed testowaniem importu, rollbacku, polityk maintenance albo zmian ścieżek security.

Log się nie pojawia

• Sprawdź, czy log został dodany do Log Viewer.
• Sprawdź, czy nie ukrywają go filtry, paginacja albo widoczność archived/removed.
• Upewnij się, że plik nadal istnieje i WordPress może go odczytać.
• Sprawdź, czy format ścieżki jest dozwolony przy obecnych ustawieniach bezpieczeństwa.

Log pojawia się w jednym module PRO, ale nie w innym

• Pamiętaj, że Log Viewer jest główną listą, natomiast udział w Log Hub, Reports i Maintenance jest konfigurowany osobno.
• Jeśli kolejność wygląda inaczej między Log Viewer i Log Hub, upewnij się, że te same logi zostały rzeczywiście dodane do Log Hub. Log Hub zachowuje kolejność Log Viewer dla uczestniczących logów; logi niewysłane lub niedodane do Log Hub nie będą tam widoczne.
• Użyj Inspector, aby sprawdzić udział wybranego logu w Log Hub, Reports, politykach Maintenance oraz innych workflow PRO.
• Cele Maintenance mogą pozostać zapisane po usunięciu logu z głównej listy Log Viewer.
• Reports zależy od zebranych danych raportowych oraz skonfigurowanej widoczności, filtrów i zakresu czasu, dlatego nie jest bezpośrednią kopią Log Viewer ani Log Hub.

Live Tail nie pokazuje nowych wpisów

• Upewnij się, że log faktycznie otrzymuje nowe linie.
• Zatrzymaj Auto-refresh przed uruchomieniem Live Tail.
• Wyłącz Diff mode, jeśli Live Tail nie powinien działać razem z nim.
• Odśwież stronę i uruchom Live Tail ponownie.
• Sprawdź capabilities i diagnostics w Log Inspector.

Auto-refresh się nie aktualizuje

• Sprawdź, czy Auto-refresh jest włączony dla wybranego logu.
• Sprawdź interwał i limit linii.
• Upewnij się, że plik logu naprawdę się zmienia.
• Sprawdź, czy serwer nadal może odczytać plik.

Diff / Show only new lines jest pusty

• Najpierw ustaw baseline, a potem wywołaj akcję, którą chcesz przetestować.
• Kliknij Refresh po wywołaniu akcji.
• Pamiętaj, że Diff pokazuje nowe linie po baseline, a nie starszą historię.
• Jeśli log został obrócony, skrócony albo wyczyszczony, ustaw nowy baseline.

Find / search nie znajduje oczekiwanego tekstu

• Sprawdź, czy tekst znajduje się w aktualnie załadowanym oknie logu.
• Spróbuj wyłączyć Match case albo Whole word.
• Sprawdź wykluczenia typu ((word)), jeśli linie są ukryte.
• Najpierw użyj prostszego zapytania, a dopiero potem dodaj składnię typu word1||word2.

Wpisy znikają z Log Hub albo wyników jest mniej niż oczekiwano

• Sprawdź Log Hub display time window w PRO Settings. Mniejsze okno ukrywa starsze wpisy z timestampem z bieżącego widoku Log Hub.
• Sprawdź limity tail/lines Log Hub. Log Hub analizuje aktualnie załadowany tail, a nie pełną historyczną bazę danych.
• Sprawdź filtry, np. tylko critical/error, tylko warning, tylko custom albo hide-noise.
• Sprawdź ignore rules i wyciszone logi.
• Użyj Reports, jeśli potrzebujesz danych historycznych starszych niż bieżące okno Log Hub.

Log Hub pokazuje zbyt dużo szumu

• Dodawaj do Log Hub tylko użyteczne logi.
• Użyj ignore rules dla powtarzalnych fraz o małej wartości.
• Użyj report include/exclude phrases, aby kontrolować, co ma być liczone.
• Wycisz albo usuń z Log Hub logi, które nie są przydatne do monitoringu.

Reports są puste albo niepełne

• Sprawdź, czy log uczestniczy w Reports.
• Sprawdź wybrany zakres dat i filtry.
• Poczekaj, aż zostanie zebrana wystarczająca aktywność.
• Sprawdź, czy frazy nie są wykluczone albo czy log nie jest archived/removed.

Alerty email nie dochodzą

• Sprawdź, czy globalne alerty email są włączone.
• Sprawdź adres odbiorcy i szablon wiadomości.
• Upewnij się, że frazy alertów są skonfigurowane dla właściwego logu.
• Sprawdź cooldown i dedupe settings.
• Użyj Send test alert.
• Upewnij się, że poczta WordPress działa; dla pewnej dostarczalności użyj SMTP albo usługi transactional email.

Webhooki nie dochodzą

• Sprawdź, czy webhook delivery jest włączone.
• Sprawdź Webhook URL i używaj HTTPS, jeśli to możliwe.
• Upewnij się, że endpoint przyjmuje żądania JSON.
• Sprawdź timeout i payload limits.
• Jeśli używasz HMAC, sprawdź, czy system odbierający weryfikuje ten sam sekret.

Maintenance się nie uruchamia

• Sprawdź, czy funkcje maintenance są włączone.
• Sprawdź, czy log jest enrolled jako maintenance target.
• Sprawdź, czy scheduled maintenance jest włączone i czy działa WP-Cron.
• Sprawdź próg rozmiaru i czy log go przekroczył.
• Użyj budgeted manual run do kontrolowanego testu.

Import ustawień albo rollback wygląda niepoprawnie

• Wyeksportuj aktualne ustawienia przed importem.
• Używaj tylko pliku JSON wyeksportowanego z pluginu.
• Po imporcie sprawdź Email Alerts, Webhooks, Security paths i Maintenance przed testowaniem akcji live.
• Rollback przywraca najnowszą kopię sprzed importu, a nie pełny backup strony.