Query Monitor to wtyczka diagnostyczna dla WordPressa, która pomaga znaleźć wolne zapytania do bazy danych, błędy PHP, problemy z połączeniami API i konflikty między komponentami. Służy administratorom oraz deweloperom do namierzania wąskich gardeł, ale po zakończeniu diagnozy należy ją wyłączyć.
Jak zainstalować Query Monitor?
Wtyczkę zainstalujesz z poziomu standardowego repozytorium WordPressa. Nie wymaga ona osobnej konfiguracji serwera.
- Zaloguj się do kokpitu WordPressa i przejdź do sekcji Wtyczki.
- Kliknij Dodaj nową, a następnie wpisz „Query Monitor” w wyszukiwarce.
- Przy właściwej wtyczce wybierz Zainstaluj.
- Po zakończeniu instalacji kliknij Włącz.
Po aktywacji w pasku administracyjnym pojawią się podstawowe dane dotyczące aktualnie ładowanej strony. Zobaczysz między innymi czas generowania strony, zużycie pamięci, czas zapytań do bazy oraz ich liczbę.
Do czego służy Query Monitor?
Panel wtyczki otwiera się po kliknięciu wskaźnika w górnym pasku WordPressa. Możesz wtedy przejść do szczegółowych informacji o zapytaniach, błędach i żądaniach wykonywanych podczas generowania konkretnego widoku.
Najczęściej przydatne są następujące obszary:
- Overview – podsumowanie czasu ładowania, zużycia pamięci, limitów PHP, zapytań do bazy, żądań HTTP oraz dostępności cache obiektowego.
- Database Queries – lista zapytań SQL, błędów bazy danych, wolnych zapytań i komponentów, które generują ich najwięcej.
- PHP Errors – informacje o ostrzeżeniach, błędach i problemach z wykonywaniem kodu PHP.
- HTTP API Calls – dane o połączeniach z zewnętrznymi serwerami, czasie odpowiedzi i ewentualnych timeoutach.
Overview – szybki obraz kondycji strony
Ta zakładka pomaga ocenić, czy problem dotyczy ogólnego czasu generowania strony, pamięci, bazy danych czy komunikacji z zewnętrzną usługą. Sam wysoki czas ładowania nie wskazuje jeszcze winowajcy, dlatego trzeba zestawić go z liczbą zapytań, czasem ich wykonywania i informacjami o błędach.
Database Queries – gdzie szukać wąskiego gardła?
Sekcja Slow Queries pokazuje zapytania, które trwały najdłużej. Wtyczka podaje ich treść, funkcję inicjującą, komponent oraz czas wykonania. Pojedyncze wolne zapytanie nie zawsze oznacza awarię, ale wiele podobnych zapytań może wyraźnie wydłużyć generowanie strony.
Przejrzyj także Queries by Component. Ta lista jest przydatna wtedy, gdy poszczególne zapytania nie przekraczają progu dla wolnych zapytań, ale konkretna wtyczka lub motyw wykonuje ich bardzo dużo.
PHP Errors i HTTP API Calls
Zakładka PHP Errors może wskazać konflikt wtyczki, niezgodność z wersją PHP albo przestarzały fragment kodu. Jeśli komunikat wskazuje konkretny komponent, zacznij od sprawdzenia jego aktualizacji i zgodności z pozostałą konfiguracją.
W HTTP API Calls szukaj połączeń z długim czasem odpowiedzi i wysokim timeoutem. Niedostępny serwer zewnętrzny, wygasły adres API lub niesprawna integracja mogą blokować część procesu ładowania strony.
Jak diagnozować stronę jako niezalogowany użytkownik?
Domyślnie Query Monitor pokazuje dane administratorowi zalogowanemu do WordPressa. To nie zawsze wystarcza, ponieważ część błędów występuje wyłącznie na froncie, dla niezalogowanych gości.
Otwórz panel Query Monitor, kliknij ikonę koła zębatego i wybierz Set authenticating cookie. Ciasteczko pozwoli narzędziu wyświetlać dane podczas przeglądania strony w trybie gościa. Dzięki temu możesz sprawdzić, jak wygląda ładowanie strony bez elementów dostępnych tylko dla administratora.
Jak reagować na wykryte problemy?
Dane z Query Monitora są wskazówką, a nie automatyczną naprawą. Najpierw ustal komponent odpowiedzialny za problem, potem sprawdź zmianę na kopii strony lub środowisku testowym.
| Problem | Możliwa przyczyna | Rekomendacja |
|---|---|---|
| Slow Query | Nieoptymalne zapytanie, brak indeksu, duża tabela lub wadliwa wtyczka | Sprawdź komponent inicjujący, zapytanie i strukturę bazy. Przy zmianach SQL skorzystaj z pomocy doświadczonego administratora. |
| Duża liczba zapytań | Wtyczka lub motyw wykonuje wiele podobnych operacji | Porównaj wynik po wyłączeniu komponentu na środowisku testowym. Sprawdź jego konfigurację albo poszukaj aktualizacji. |
| Database Error | Błąd składni, konflikt komponentów lub niezgodność wersji | Zapisz komunikat i kod błędu, zaktualizuj komponent oraz sprawdź konflikt z innymi wtyczkami. |
| PHP Error | Niekompatybilny kod, błąd motywu lub niezgodna wersja PHP | Sprawdź plik i linię wskazane w komunikacie. W razie potrzeby przeanalizuj także log debugowania WordPressa. |
| Długi HTTP API Call | Niedostępna usługa zewnętrzna, błędny adres lub zbyt długi timeout | Sprawdź integrację, adres endpointu i aktualność wtyczki. Wyłącz testowo niepotrzebne połączenie. |
Nie zmieniaj od razu konfiguracji bazy ani nie usuwaj danych na produkcji. Gdy problem dotyczy rdzenia WordPressa, struktury tabel lub własnego kodu, bezpieczniej skonsultować zmianę z deweloperem.
Jak bezpiecznie korzystać z Query Monitora?
Query Monitor zbiera szczegółowe dane podczas generowania strony, więc sam zwiększa pracę wykonywaną przez WordPressa i serwer. Skala wpływu zależy od strony, liczby komponentów i rodzaju testu, ale wynik z aktywną wtyczką nie powinien być traktowany jako miarodajny pomiar produkcyjnej wydajności.
Expert Note: Query Monitor jest narzędziem do pracy diagnostycznej, a nie stałym elementem działającej strony.
Po zakończeniu analizy wyłącz wtyczkę, szczególnie na produkcji. Jeśli potrzebujesz kolejnego testu, aktywuj ją tylko na czas konkretnego zadania. W przypadku awarii możesz też połączyć jej dane z logiem generowanym przez WP_DEBUG, ale po zakończeniu diagnostyki wyłącz tryb debugowania i usuń dostęp do szczegółowych komunikatów.
Największą wartość Query Monitor daje wtedy, gdy używasz go do znalezienia konkretnego źródła problemu, a nie do ciągłego monitorowania strony. Sprawdź zapytania, błędy PHP i połączenia API, wprowadź zmianę na środowisku testowym, a następnie wyłącz wtyczkę.
