...

Nagłówek Server-Timing: jak zrozumieć czasy wykonania backendu w przeglądarce

Der Nagłówek Server-Timing Przesyła samodzielnie zebrane wskaźniki backendowe w odpowiedzi HTTP. Można je przypisać do danego żądania w narzędziach programistycznych przeglądarki (DevTools) lub odczytać za pomocą interfejsu API wydajności. Warunkiem jest, aby aplikacja lub inny komponent generujący odpowiedź rejestrował i wysyłał te wartości. Nagłówek nie jest automatycznym narzędziem do profilowania: dopiero udokumentowane granice pomiarowe wskazują, jaką pracę obejmuje dany czas trwania. Nakładanie się operacji, ścieżki sieciowe i odpowiedzi z pamięci podręcznej mogą wpływać na interpretację wyników.

Co pokazuje funkcja „Server Timing”

Powolna strona może powodować straty czasu w przeglądarce, podczas przesyłania danych przez sieć lub podczas przetwarzania na serwerze. Strona Nagłówek Server-Timing łączy te podejścia: przesyła wskaźniki, które sam zarejestrował jeden z zaangażowanych komponentów serwera, wraz z odpowiedzią HTTP. Przeglądarka może następnie przyporządkować je do odpowiedniego żądania i wyświetlić.

W tym celu aplikacja musi na przykład zmierzyć czas trwania operacji na bazie danych i umieścić tę wartość w nagłówku odpowiedzi. Również serwer proxy lub inny komponent generujący odpowiedź może dostarczać dane metryczne. Bez takiej instrumentacji przeglądarka nie jest w stanie ustalić a posteriori, ile czasu zajęły poszczególne etapy przetwarzania po stronie serwera.

Nagłówek jest zatem Format transportowy, nie jest to automatyczny profiler. Nie określa on, które funkcje wewnętrzne mają być analizowane ani jak szczegółowo aplikacja musi przeprowadzać pomiary. To, jakie wskaźniki są wyświetlane, zależy od tego, co rejestruje i udostępnia do wyświetlenia odpowiedni komponent.

Dla Wydajność zaplecza Jest to pomocne, ponieważ samodzielnie zmierzony fragment wyświetla się bezpośrednio obok informacji dotyczących żądania przeglądarki. Wysoka wartość stanowi na razie punkt wyjścia do dalszych badań, ale nie jest jeszcze dowodem na to, dlaczego strona działa wolno. Sam ten wskaźnik nie wyjaśnia ani przyczyny, ani wszystkich pozostałych czynników wpływających na wydajność strony.

W praktyce potrzebujesz więc dostępu do aplikacji lub innego elementu, który może wpływać na wynik. Jeśli natomiast w zestawie znajdują się już wskaźniki, możesz je przeanalizować w przeglądarce bez konieczności samodzielnej zmiany konfiguracji serwera. Nawet w takim przypadku warto sprawdzić, skąd pochodzą te wartości i co faktycznie obejmują.

Zrozumienie wskaźników i składni nagłówków

Odpowiedź HTTP może zawierać jedną lub więcej linii nagłówka „Server Timing”. W obrębie jednej linii poszczególne wskaźniki są oddzielone przecinkami; każdy parametr poprzedzony jest średnikiem. Każdy wskaźnik musi mieć nazwę, natomiast czas trwania i opis są opcjonalne. Zgłoszony czas trwania znajduje się w parametrze dur i jest podawana w milisekundach.

Poniższy przykład przedstawia wiersz nagłówka odpowiedzi HTTP zawierający dwie metryki. Liczby zostały wybrane dowolnie i nie stanowią rzeczywistych pomiarów; wiersz ten jest jedynie przykładem składniowym i nie odnosi się do żadnej konkretnej aplikacji ani konfiguracji serwera.

Kod
Server-Timing: db;dur=42.5;desc="Datenbank", render;dur=18.0

W tym przypadku oznacza to db wskaźnik zawierający czas trwania i opis; render ma czas trwania, ale nie ma opisu. Dane zgodnie z desc Mają one charakter wyjaśniający. Nie zastępują one dokumentacji określającej, kiedy dany pomiar się rozpoczyna i kończy.

Elementy składowe wskaźnika synchronizacji serwera
SkładnikZnaczenieStatus obowiązkuPrzykład
NazwaOkreśla metrykęWymaganedb
durCzas trwania w milisekundachOpcjonalniedur=42,5
descOpis wskaźnikaOpcjonalniedesc="Baza danych"

Imię takie jak db samo w sobie nie zdradza ani Zakresy pomiarowe ani metoda pomiaru. Może on odnosić się do pojedynczego zapytania, kilku zsumowanych zapytań lub inaczej zdefiniowanego fragmentu bazy danych. Dopiero dokumentacja instrumentacji pozwala zrozumieć, jaka praca faktycznie jest uwzględniona w wartości.

Aby porównania były miarodajne, należy zatem dla każdego wskaźnika odnotować punkt początkowy i końcowy oraz opisać, czy obejmuje on dalsze operacje cząstkowe. Jeśli na przykład nazwa pozostaje taka sama, a aplikacja uwzględnia później dodatkowe zapytania w obliczeniach czasowych, stare i nowe wartości nie są łatwo porównywalne. Sama składnia nie wskazuje na taką zmianę.

Rozróżnienie między czasem działania serwera a czasem oczekiwania przeglądarki

Czas oczekiwania widoczny w przeglądarce i zgłoszony czas trwania operacji po stronie serwera niekoniecznie odnoszą się do tego samego przedziału czasowego. Dany wskaźnik może obejmować jedynie świadomie wybrany fragment procesu przetwarzania, podczas gdy widok w przeglądarce przedstawia również inne części ścieżki żądania i odpowiedzi. Podobne lub różne wartości nie oznaczają zatem automatycznie, że oba pomiary potwierdzają się nawzajem lub są ze sobą sprzeczne.

Pomiędzy przeglądarką a aplikacją mogą znajdować się na przykład ścieżki sieciowe i serwery proxy. Również kolejki lub etapy przetwarzania w ramach zaplecza mogą pozostawać poza ustalonymi punktami pomiarowymi. Jeśli przeglądarka czeka dłużej niż trwa zgłoszona operacja na bazie danych, nie można zatem przypisać tej różnicy wyłącznie do konkretnej przyczyny na podstawie tego jednego wskaźnika.

Z drugiej strony wskaźniki pomiaru wydajności serwera mogą nakładać się lub mogą być ze sobą powiązane. Jeśli ogólny wskaźnik mierzy przetwarzanie zapytania wraz z operacją na bazie danych, to czas trwania tej operacji jest już uwzględniony w wartości ogólnej. Dodając obie liczby, zliczasz ten fragment dwukrotnie; w przypadku operacji wykonywanych równolegle suma ich indywidualnych czasów trwania może być większa niż czas, który upłynął.

Nagłówek nie stanowi zatem automatycznie kompletnego Wodospad przetwarzania. Przedstawia on określone wskaźniki, ale same nazwy i czasy trwania nie określają ani kolejności czasowej, ani powiązań między poszczególnymi etapami. Aby dokonać interpretacji, musisz wiedzieć, czy system monitorowania rejestruje prace oddzielne, nakładające się na siebie czy przebiegające równocześnie.

Zanim wyciągniesz wnioski dotyczące optymalizacji, określ zakres pomiaru i warunki analizowanego zapytania. Następnie powtórz podobne zapytania i sprawdź, czy ten sam wzorzec pojawia się w tych samych warunkach. W ten sposób łatwiej odróżnisz pojedynczą wartościową od powtarzającego się sygnału, nie wyciągając wniosków o przyczynie wyłącznie na podstawie samej metryki.

Sprawdź odpowiedź HTML w DevTools

W przypadku dynamicznej strony HTML aplikacja może rejestrować dwa odrębne etapy: operację na bazie danych oraz późniejsze generowanie kodu HTML. Pomiar musi zostać skonfigurowany w aplikacji lub innym komponencie generującym odpowiedź. DevTools wyświetla dostarczone wartości, ale nie oblicza samodzielnie wewnętrznych czasów wykonania.

Zdefiniuj dla db początek bezpośrednio przed wywołaniem określonej operacji na bazie danych, a koniec – gdy tylko jej wynik zostanie odnotowany w aplikacji. Dla render Czas ten rozpoczyna się bezpośrednio przed utworzeniem kodu HTML i kończy się, gdy gotowy kod HTML jest już dostępny w odpowiedzi. Należy odnotować, czy obejmuje to na przykład ładowanie szablonów.

Załóżmy, że oba kroki zostały zakończone przed wysłaniem nagłówków odpowiedzi: wówczas odpowiedź mogłaby Server-Timing: db;dur=42.5, render;dur=18.0 zawarte. Liczby te zostały wybrane dowolnie i nie stanowią wyników pomiarów. Dopiero udokumentowane punkty początkowe i końcowe sprawiają, że można je w sensowny sposób porównać w ramach późniejszej analizy.

Otwórz w przeglądarce Chrome narzędzia programistyczne i zakładkę „Sieć”. Odśwież stronę, wybierz z listy żądań żądanie dokumentu i sprawdź w sekcji „Nagłówki” otrzymany surowy nagłówek. W sekcji „Timing” możesz następnie wyświetlić zgłoszone wartości czasowe serwera; dokładny wygląd może się różnić w zależności od przeglądarki.

Przyciągający uwagę Wartość indywidualna To tylko punkt wyjścia, a nie dowód na istnienie ogólnej przyczyny. Powtórz podobne zapytania i zanotuj np. odwiedzoną stronę, stan pamięci podręcznej oraz zmiany wprowadzone w aplikacji. Dzięki temu łatwiej będzie Ci rozpoznać, czy powtarza się jakiś wzorzec, czy też pojedyncza odpowiedź odbiega od normy.

Odczytanie czasów API bez podwójnego zliczania

W przypadku interfejsu API aplikacja może rejestrować nie tylko cały proces przetwarzania, ale także czas oczekiwania na usługę zewnętrzną. Kluczowe znaczenie ma przy tym Granica pomiarowa: Jeśli czas całkowity rozpoczyna się w momencie wejścia do procedury obsługi API, a kończy się, gdy jej odpowiedź jest gotowa do wyświetlenia, zewnętrzne wywołanie może być w całości zawarte w tej procedurze.

W poniższym, dowolnie wybranym przykładzie czas trwania operacji zewnętrznej rozpoczyna się tuż przed wysłaniem żądania do serwisu, a kończy się w momencie otrzymania odpowiedzi w aplikacji. Podane wartości służą wyłącznie do celów obliczeniowych i nie stanowią pomiaru. Tabela wyraźnie opisuje zagnieżdżone przedziały czasowe, a nie dwa niezależne pakiety prac.

Dowolnie wybrany przykład zagnieżdżonych metryk API
MetrykiZakresy pomiarowe w przykładzieCzas trwania
Całkowite przetworzenieWejście do procedury obsługi, dopóki odpowiedź nie będzie gotowa120 ms
Wywołanie zewnętrzneOd wysłania zapytania do otrzymania odpowiedzi od serwisu80 ms

Obliczenie 120 ms plus 80 ms daje wprawdzie 200 ms, ale w tym przypadku byłoby to Podwójne liczenie: Te 80 ms mieści się już w przedziale 120 ms. Z matematycznego punktu widzenia 40 ms z całkowitego przedziału pozostaje poza wywołaniem zewnętrznym. Sam nagłówek nie wyjaśnia jednak, jakie czynności lub czas oczekiwania obejmuje ten pozostały przedział.

Ilustracja wygenerowana przez sztuczną inteligencję, przedstawiająca mniejszy okrąg wewnątrz większego, symbolizująca zagnieżdżone czasy API
Ilustracja wygenerowana przez sztuczną inteligencję: Czas trwania wywołania zewnętrznego może być już uwzględniony w całkowitym czasie przetwarzania.

Również zależności równoległe nie da się po prostu zsumować w celu uzyskania całkowitego czasu, który upłynął. Jeśli na przykład dwa wywołania przebiegają jednocześnie i każde z nich trwa 80 ms, to ich indywidualne czasy trwania sumują się do 160 ms, mimo że ich przedziały czasowe mogą się w znacznym stopniu nakładać. Bez informacji o początku i końcu rzeczywistego stopnia nakładania się nie da się określić wyłącznie na podstawie samych czasów trwania.

Aby odpowiedzieć na pytanie, która usługa wywołała kolejne wywołanie, rozproszone śledzenie uzupełnia wartości nagłówków. Funkcja Server-Timing może powiązać wybrane czasy trwania z odpowiedzią przeglądarki, ale sama w sobie nie opisuje pełnych związków przyczynowych między usługami. Podczas porównywania należy zwrócić uwagę, aby ślad i nagłówek odnosiły się do tych samych operacji i granic.

Odczytywanie czasu serwera za pomocą JavaScript

Die Interfejs API wydajności udostępnia istniejące dane dotyczące czasu działania serwera również programowo. Wpis nawigacyjny opisuje ładowanie bieżącego dokumentu; jego właściwość serverTiming zawiera zgłoszone wskaźniki dostępne w tym celu. Jest to inny zestaw niż w przypadku wpisu dotyczącego zasobu załadowanego później lub wywołania API.

Uruchom poniższy kod JavaScript w konsoli przeglądarki na stronie, którą chcesz zbadać. Kod ten wybiera pierwszą dostępną pozycję nawigacyjną i wyświetla jej listę czasów serwera w formie tabeli. Kod odczytuje wyłącznie już dostępne wartości: nie zmienia konfiguracji serwera ani nie przeprowadza testu obciążeniowego.

Kod
const navigation = performance.getEntriesByType("navigation")[0];
console.table(navigation?.serverTiming ?? []);

Jeśli nie ma wpisu nawigacyjnego lub nie udostępnia on żadnych wskaźników, przykład wyświetla pustą listę. Nie oznacza to jednak ani tego, że strona działa szybko lub wolno, ani też, że serwer nie jest wyposażony w narzędzia do monitorowania. Najpierw sprawdź nagłówek odpowiedzi oraz to, czy wybrany wpis rzeczywiście odpowiada na żądane zapytanie.

W przypadku zasobu załadowanego później potrzebujesz zamiast tego odpowiedniego Wpis dotyczący zasobów. Wśród wpisów typu resource czy na podstawie nazwy możesz zidentyfikować szukane zapytanie i jego serverTiming-Sprawdź właściwość. W przypadku wielokrotnego wywoływania tego samego adresu musisz zwrócić uwagę, który konkretny wpis porównujesz.

W przypadku zasobów pochodzących z różnych źródeł na udostępnienie informacji o czasie przez Performance API ma dodatkowo wpływ odpowiednie zezwolenie ustawione za pomocą atrybutu `Timing-Allow-Origin`. Na wynik mogą również wpływać obsługa przeglądarki oraz konkretne środowisko. Dlatego przed wprowadzeniem zmian w aplikacji porównaj pustą listę z surowym nagłówkiem.

Udostępnianie treści w serwisie Origin i dane wrażliwe

W przypadku dostępu za pośrednictwem interfejsu API Performance decydujące znaczenie ma pochodzenie strony wywołującej. Jeśli zasób pochodzi z innego źródła, jego odpowiedź musi zawierać Timing-Allow-Origin odpowiednio zezwolić na dostęp do serwera pochodzenia, aby JavaScript mógł odczytać odpowiednie informacje o czasie, w tym dane dotyczące czasu serwera. Samo zezwolenie CORS nie zastępuje tego dodatkowego zezwolenia.

A konkretne źródło ogranicza udostępnianie do wskazanego źródła. Symbol zastępczy * Z kolei zasadniczo zezwala wszystkim źródłom (Origins) na wgląd w te informacje dotyczące czasu za pośrednictwem interfejsu API wydajności. Wybierz zatem węższe uprawnienie, jeśli tylko jedna znana aplikacja potrzebuje tych wartości, i sprawdź je na podstawie faktycznie dostarczonej odpowiedzi dotyczącej zasobów.

Ujawnienie pola „Origin” nie powoduje, że nagłówek odpowiedzi staje się poufny. Każdy, kto otrzyma samą odpowiedź HTTP, może zasadniczo sprawdzić jej treść. Dlatego nie należy publikować danych dostępowych, danych osobowych ani wewnętrznych nazw hostów w nazwach wskaźników i opisach. Również bardzo szczegółowe dane dotyczące czasu wykonania mogą pozwolić na wyciąganie wniosków na temat wewnętrznych procesów; podawaj wyłącznie te wartości, których korzyści i ryzyko świadomie rozważyłeś.

Sprawdź również działanie funkcji analizy w przeglądarkach, które ma obsługiwać Twoja aplikacja: obsługa poszczególnych szczegółów oraz wymagania dotyczące bezpiecznych kontekstów mogą się różnić. Aby zapewnić ogólne zabezpieczenie odpowiedzi, należy dodatkowo odpowiednie nagłówki zabezpieczające dla serwerów WWW istotne; nie zastępują one jednak ani weryfikacji zezwolenia na synchronizację, ani decyzji o tym, które wartości pomiarowe mogą zostać upublicznione.

Sprawdź brakujące wartości i efekty pamięci podręcznej

Jeśli lista wartości Server Timing jest pusta, zacznij od konkretnego żądania w sekcji sieciowej DevTools. Sprawdź w sekcji „Headers”, czy wysłana odpowiedź w ogóle zawiera Server-Timing-Header i jakie nazwy się w nim znajdują. Jeśli go brakuje, sprawdź instrumentację i ewentualne zmiany spowodowane przez elementy pośredniczące, zamiast wyciągać wnioski na temat prędkości na podstawie pustej listy.

Jeśli nagłówek surowy jest dostępny, sprawdź następnie Wpis dotyczący wydajności: Wpis nawigacyjny opisuje ładowanie dokumentu, podczas gdy wywołanie API lub innego zasobu wymaga odpowiedniego wpisu zasobu. W przypadku zasobów międzydomenowych należy dodatkowo sprawdzić, czy zostały one udostępnione przez Timing-Allow-Origin a także obsługa przez używaną przeglądarkę. Pusta lista sama w sobie nie świadczy ani o braku instrumentacji, ani o szybkiej lub powolnej odpowiedzi.

Nawet istniejąca wartość wymaga kontekstu. Sieć CDN lub serwer proxy mogą dostarczać własne metryki; jednocześnie odpowiedź wraz z nagłówkami może pochodzić z pamięci podręcznej. W takim przypadku wcześniej wygenerowana metryka serwera źródłowego niekoniecznie odzwierciedla pracę serwera źródłowego w odniesieniu do bieżącego żądania. Dlatego należy udokumentować Stan pamięci podręcznej i pochodzenie niezależnie od czasu trwania.

Wygenerowany przez sztuczną inteligencję obraz symboliczny przedstawiający podłączony kabel sieciowy do przełącznika – zbliżenie z boku
Ilustracja wygenerowana przez sztuczną inteligencję: Pomiędzy przeglądarką a aplikacją mogą znajdować się dodatkowe elementy sieciowe.

Sprawdź w konkretnej konfiguracji, który komponent ustawia nagłówek, przekazuje go dalej lub modyfikuje oraz w jaki sposób radzi sobie z odpowiedziami z pamięci podręcznej. Następnie porównaj żądania ze znanym stanem pamięci podręcznej, o ile pozwala na to Twoja infrastruktura. Różnice między tymi odpowiedziami stanowią przydatne wskazówki, ale bez znajomości odpowiednich granic pomiarowych nie są jeszcze dowodem na konkretną przyczynę.

Dzienniki, zwiastuny i dobór narzędzi

Server-Timing stanowi uzupełnienie innych metod diagnostycznych, a nie ich zamiennik. Wybór odpowiedniej metody zależy od tego, czy chcesz zrozumieć pojedyncze żądanie przeglądarki, programowo zebrać istniejące wartości, czy też zbadać zależności między wieloma usługami. Poniższy przegląd przedstawia poszczególne korzyści wynikające z tych metod wraz z ich warunkami i ograniczeniami.

Porównanie ścieżek diagnostycznych dla odpowiedzi HTTP
NarzędzieWniosekWarunek wstępnyGranica
DevToolsSprawdź poszczególne zapytania i zgłoszone terminyZapytanie przeglądarki z odpowiednimi wskaźnikamiBrak automatycznej analizy przyczyn
Interfejs API wydajnościOdczytanie istniejących wartości synchronizacji za pomocą JavaScriptOdpowiedni wpis i, w razie potrzeby, zatwierdzenie przez OriginBrak kompletnego, międzywydziałowego procesu
Dzienniki serweraAnaliza czasów zarejestrowanych po stronie serweraOdpowiedni format logów i dostęp do logówNależy sprawdzić zakresy pomiarowe i jednostki miary
Śledzenie rozproszoneZbadanie powiązań między zaangażowanymi służbamiOznakowanie i przypisanie śladówDodatkowe nakłady związane z eksploatacją i oprzyrządowaniem

W przypadku wskaźnika, którego wartość jest znana dopiero po zakończeniu odpowiedzi, wpis w dzienniku może być bardziej odpowiedni niż standardowy nagłówek odpowiedzi. Na przykład NGINX rejestruje request_time oraz upstream_response_time w sekundach z rozdzielczością w milisekundach. Natomiast funkcja Server-Timing wykorzystuje milisekundy: wartość w sekundach należy pomnożyć przez 1 000. Przed porównaniem należy dodatkowo sprawdzić, kiedy dany pomiar się zaczyna i kończy.

Na stronie Streaming W przypadku wysyłania standardowych nagłówków całkowity czas trwania treści odpowiedzi może nie być jeszcze ustalony. Specyfikacja dopuszcza również stosowanie Server-Timing jako nagłówka HTTP-Trailer. Nie jest to jednak rozwiązanie uniwersalne: interfejs API Fetch nie udostępnia nagłówków Trailer, a ich wyświetlanie w narzędziach programistycznych należy sprawdzić osobno dla każdej przeglądarki.

Aby uzyskać bardziej miarodajne porównania, powtórz podobne zapytania w udokumentowanych warunkach: odnotuj na przykład punkt końcowy, stan pamięci podręcznej oraz istotne zmiany w systemie. Analizuj kilka wartości zamiast pojedynczego zapytania i dokładniej badaj rzucające się w oczy różnice na podstawie logów lub śladów. Dzięki temu będzie jasne, które obserwacje faktycznie obejmuje dany pomiar.

Środowisko testowe oparte na przeglądarce może pomóc w wypróbowywaniu ustawień aplikacji, ale nie odzwierciedla automatycznie ścieżek sieciowych i usług serwerowych, które będą wykorzystywane podczas późniejszego użytkowania. Dotyczy to również WordPress Playground w przeglądarce. Informacje dotyczące konkretnej konfiguracji hostingu i zaplecza należy dodatkowo zweryfikować w środowisku jak najbardziej zbliżonym do produkcyjnego.

Źródła i aktualny stan wiedzy

Stan badań:

Stan badań: 13 listopada 2026 r. Wygląd w przeglądarce i obsługa poszczególnych funkcji mogą się różnić; przykłady nie zawierają własnych pomiarów.

https://www.w3.org/TR/server-timing/

https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming/serverTiming

https://developer.chrome.com/docs/devtools/network?hl=en

https://developer.chrome.com/docs/devtools/performance/reference/

https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Timing-Allow-Origin

https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Server-Timing

https://docs.nginx.com/nginx/admin-guide/monitoring/logging/

Artykuły bieżące

Ilustracja wygenerowana przez sztuczną inteligencję przedstawiająca formularz odpowiedzi z bocznym zakładką i geometrycznymi oznaczeniami dla podanych wskaźników
Serwer WWW Plesk

Nagłówek Server-Timing: jak zrozumieć czasy wykonania backendu w przeglądarce

Nagłówek Server-Timing udostępnia w narzędziach programistycznych przeglądarki wskaźniki wydajności zaplecza zebrane samodzielnie. Dowiedz się, jak sprawdzać granice pomiaru, odczytywać wartości za pomocą JavaScript oraz prawidłowo interpretować efekty związane z pamięcią podręczną i źródłem.