De Server-Timing-header stuurt zelf geregistreerde backend-statistieken door via een HTTP-antwoord. Je kunt deze toewijzen aan de betreffende verzoek in de DevTools van de browser of ze uitlezen via de Performance API. Voorwaarde is dat de applicatie of een ander component dat een antwoord geeft, de waarden registreert en weergeeft. De header is geen automatische profiler: pas gedocumenteerde meetgrenzen laten zien hoeveel werk een duur omvat. Overlappingen, netwerkpaden en cache-antwoorden kunnen de interpretatie beïnvloeden.
Wat server-timing zichtbaar maakt
Een trage pagina kan tijd verliezen in de browser, tijdens de overdracht via het netwerk of bij de verwerking op de server. De Server-Timing-header verbindt deze perspectieven: het verzendt statistische gegevens die een betrokken servercomponent zelf heeft geregistreerd, samen met een HTTP-antwoord. De browser kan deze vervolgens aan het betreffende verzoek koppelen en weergeven.
Hiervoor moet de applicatie bijvoorbeeld de duur van een databasebewerking meten en de waarde in de antwoordheader vermelden. Ook een proxy of een ander onderdeel dat een antwoord genereert, kan statistieken aanleveren. Zonder een dergelijke instrumentatie kan de browser achteraf niet vaststellen hoe lang afzonderlijke stappen aan de serverzijde hebben geduurd.
De header is dus een Transportformaat, geen automatische profiler. Hij bepaalt niet welke interne functies worden onderzocht of hoe gedetailleerd een toepassing moet meten. Welke statistieken worden weergegeven, hangt af van wat de betreffende component registreert en vrijgeeft voor weergave.
Voor de Backend-prestaties Dat is nuttig, omdat een zelf gemeten segment direct naast de informatie over de browserverzoek zichtbaar wordt. Een hoge waarde is in eerste instantie een aanknopingspunt voor verder onderzoek, maar nog geen bewijs voor de reden waarom een pagina traag is. Deze indicator alleen verklaart noch de oorzaak, noch alle andere aspecten van de webprestaties.
Voor het praktische gebruik heb je daarom toegang nodig tot de applicatie of een ander onderdeel dat het resultaat kan beïnvloeden. Als er al statistieken worden meegeleverd, kun je die daarentegen in de browser bekijken zonder zelf de serverconfiguratie te wijzigen. Ook dan moet je nagaan waar de waarden vandaan komen en wat ze precies inhouden.
Inzicht krijgen in statistieken en de syntaxis van headers
Een HTTP-antwoord kan één of meerdere Server-Timing-headerregels bevatten. Binnen een regel worden de afzonderlijke statistieken door komma’s gescheiden; een puntkomma luidt telkens een parameter in. Elke statistiek moet een naam hebben, terwijl de duur en de beschrijving optioneel zijn. Een gerapporteerde duur staat in de parameter dur en wordt uitgedrukt in milliseconden.
Het volgende voorbeeld toont een HTTP-antwoordheaderregel met twee statistieken. De getallen zijn willekeurig gekozen en vormen geen meting; de regel is slechts een voorbeeld van de syntaxis en veronderstelt geen specifieke toepassing of serverconfiguratie.
Hier wordt bedoeld db een statistiek met duur en beschrijving; render heeft een duur, maar geen beschrijving. De gegevens volgens desc dienen ter verduidelijking. Ze vormen geen vervanging voor documentatie waarin staat wanneer de betreffende meting begint en eindigt.
| onderdeel | Dat betekent | Verplichte status | Voorbeeld |
|---|---|---|---|
| Naam | Geeft de metriek aan | Vereist | db |
| dur | Duur in milliseconden | Optioneel | dur=42,5 |
| desc | Beschrijving van de maatstaf | Optioneel | desc="Database" |
Een naam als db geeft op zichzelf nog geen aanwijzing voor de Meetbereik noch de meetmethode. Het zou kunnen verwijzen naar een enkele query, meerdere bij elkaar opgetelde queries of een anders gedefinieerd deel van de database. Pas uit de documentatie van de instrumentatie blijkt welk werk daadwerkelijk in de waarde is vervat.
Voor zinvolle vergelijkingen moet je daarom voor elke metriek het begin- en eindpunt vastleggen en aangeven of deze verdere deelbewerkingen omvat. Als bijvoorbeeld de naam hetzelfde blijft, terwijl de toepassing later extra zoekopdrachten in de tijd meerekent, zijn oude en nieuwe waarden niet zonder meer vergelijkbaar. De syntaxis alleen wijst niet op een dergelijke wijziging.
De backend-duur en de wachttijd van de browser afbakenen
De wachttijd die in de browser wordt weergegeven en een gerapporteerde backend-duur verwijzen niet noodzakelijkerwijs naar dezelfde tijdsperiode. Een statistiek kan slechts een bewust gekozen deel van de verwerking weergeven, terwijl de weergave in de browser ook andere delen van het verzoek- en antwoordtraject weergeeft. Vergelijkbare of verschillende cijfers betekenen daarom niet automatisch dat beide metingen elkaar bevestigen of tegenspreken.
Tussen de browser en de applicatie kunnen bijvoorbeeld netwerkpaden en proxyservers liggen. Ook wachtrijen of werkstappen binnen de backend vallen mogelijk buiten de ingestelde meetpunten. Als de browser langer wacht dan een gerapporteerde databasebewerking duurt, kan het verschil daarom niet uitsluitend aan de hand van deze ene indicator aan een specifieke oorzaak worden toegeschreven.
Omgekeerd kunnen server-timing-statistieken overlappen of in elkaar verweven zijn. Als een totale metriek de verwerking van een verzoek meet, inclusief de databasebewerking, is de duur daarvan al in de totale waarde meegenomen. Als je beide getallen bij elkaar optelt, tel je dit onderdeel dubbel; bij parallel uitgevoerde bewerkingen kan de som van hun afzonderlijke duur ook groter zijn dan de verstreken tijd.
De header vormt daarom niet automatisch een volledige Waterval de verwerking. Het geeft bepaalde kengetallen weer, maar de namen en duur alleen geven noch een chronologische volgorde, noch verbanden tussen de fasen aan. Voor de interpretatie moet je weten of de instrumentatie afzonderlijke, in elkaar verweven of gelijktijdig lopende werkzaamheden registreert.
Voordat je een optimalisatie afleidt, moet je de meetgrenzen en voorwaarden van de betreffende aanvraag vastleggen. Herhaal vervolgens vergelijkbare aanvragen en controleer of het patroon zich onder dezelfde omstandigheden voordoet. Zo kun je een opvallende afwijkende waarde beter onderscheiden van een terugkerend patroon, zonder op basis van de statistiek alleen al een oorzaak te stellen.
HTML-antwoord controleren in DevTools
Voor een dynamische HTML-pagina kan de toepassing twee afzonderlijke stappen registreren: een databasebewerking en het daaropvolgende genereren van de HTML. De meting moet in de toepassing of een andere component die een antwoord retourneert, worden ingesteld. DevTools geeft de geleverde waarden weer, maar berekent de interne looptijden niet zelf.
Definieer voor db het begin, vlak voordat een bepaalde databasebewerking wordt gestart, en het einde, zodra het resultaat daarvan in de toepassing beschikbaar is. Voor render De tijd begint direct vóór het genereren van de HTML en eindigt zodra de voltooide HTML voor het antwoord beschikbaar is. Leg vast of daarin bijvoorbeeld het laden van sjablonen is meegerekend.
Stel dat beide stappen zijn voltooid voordat de antwoordheader wordt verzonden: dan zou het antwoord Server-Timing: db;dur=42.5, render;dur=18.0 bevat. De cijfers zijn willekeurig gekozen en vormen geen meting. Pas de gedocumenteerde begin- en eindpunten maken ze zinvol vergelijkbaar voor een later onderzoek.
Open in Chrome de ontwikkelaarstools en ga naar het tabblad ‘Netwerk’. Laad de pagina opnieuw, selecteer in de lijst met verzoeken het documentverzoek en bekijk onder ‘Headers’ de ontvangen ruwe header. Onder ‘Timing’ kun je vervolgens de weergave van de gerapporteerde server-timingwaarden bekijken; de exacte weergave kan per browser verschillen.
Een opvallende Individuele waarde is een aanknopingspunt, geen bewijs voor een algemene oorzaak. Herhaal vergelijkbare verzoeken en noteer bijvoorbeeld de gebruikte pagina, de cache-status en wijzigingen in de applicatie. Zo kun je beter vaststellen of er een patroon terugkomt of dat een enkel antwoord afwijkt van de norm.
API-tijden lezen zonder dubbeltellingen
Bij een API kan de applicatie naast de volledige verwerking ook het wachten op een externe dienst vastleggen. Doorslaggevend daarbij is de Meetgrens: Als de totale tijd begint bij het binnengaan van de API-handler en eindigt wanneer het antwoord daarvan klaar is om te worden weergegeven, kan de externe aanroep volledig daarin zijn opgenomen.
In het volgende willekeurig gekozen voorbeeld begint de externe duur direct vóór het verzenden van het verzoek naar de dienst en eindigt deze zodra het antwoord daarvan in de applicatie beschikbaar is. De waarden dienen uitsluitend ter illustratie en zijn geen metingen. De tabel beschrijft uitdrukkelijk in elkaar verweven tijdsperioden, niet twee onafhankelijke werkpakketten.
| Metriek | Meetbereiken in het voorbeeld | Duur |
|---|---|---|
| Totale verwerking | Toegang tot de handler totdat er een antwoord beschikbaar is | 120 ms |
| Externe aanroep | Verzending van de aanvraag totdat er een antwoord van de dienst is ontvangen | 80 ms |
De berekening van 120 ms plus 80 ms levert weliswaar 200 ms op, maar zou hier een Dubbel tellen: Die 80 ms vallen al binnen de 120 ms. Rekenkundig blijft er 40 ms van de totale tijd buiten de externe aanroep over. De header alleen geeft echter geen uitleg over welke bewerkingen of wachttijd deze resterende tijd omvat.
Ook parallelle afhankelijkheden kunnen niet zomaar worden opgeteld tot een totale verstreken tijd. Als er bijvoorbeeld twee aanroepen tegelijkertijd worden uitgevoerd en deze elk 80 ms duren, bedraagt de som van hun individuele duur 160 ms, hoewel hun tijdsduur elkaar grotendeels kan overlappen. Zonder informatie over het begin en het einde kan de daadwerkelijke mate van overlapping niet worden bepaald op basis van de duur alleen.
Om te bepalen welke dienst welke volgende aanroep heeft geactiveerd, vult gedistribueerde tracing de headerwaarden aan. Server-timing kan geselecteerde tijdsduur aan het browserantwoord koppelen, maar beschrijft op zichzelf niet de volledige causale verbanden tussen diensten. Let er bij het vergelijken op dat ‘trace’ en ‘header’ dezelfde bewerkingen en grenzen bedoelen.
Server-timing uitlezen via JavaScript
De Performance API maakt bestaande server-timing-gegevens ook programmatisch toegankelijk. Een navigatie-item beschrijft het laden van het huidige document; de eigenschap ervan serverTiming bevat de daarvoor beschikbare gerapporteerde statistieken. Dit is een andere selectie dan een vermelding voor een achteraf geladen bron of een API-aanroep.
Voer de volgende JavaScript-code uit in de browserconsole op de te onderzoeken pagina. Deze selecteert het eerste beschikbare navigatie-item en geeft de bijbehorende server-timing-lijst in tabelvorm weer. De code leest alleen reeds beschikbare waarden: hij wijzigt geen serverconfiguratie en voert geen belastingstest uit.
Als er geen navigatie-item aanwezig is of als dit geen toegankelijke statistieken oplevert, toont het voorbeeld een lege lijst. Hieruit kan noch worden afgeleid dat de pagina snel of traag is, noch dat de server geen instrumentatie heeft. Controleer eerst de responsheader en of het geselecteerde item daadwerkelijk het gewenste verzoek beschrijft.
Voor een opnieuw geladen bron heb je in plaats daarvan de juiste Vermelding van bronnen. Onder de vermeldingen van het type resource kun je aan de hand van de naam het gezochte verzoek identificeren en de serverTiming-Eigenschap bekijken. Als je hetzelfde adres meerdere keren oproept, moet je letten op welke specifieke vermelding je vergelijkt.
Bij bronnen die meerdere origins overschrijden, is bovendien de juiste instelling van `Timing-Allow-Origin` van invloed op de vraag of de Performance API de tijdinformatie beschikbaar stelt. Ook browserondersteuning en de betreffende omgeving kunnen de uitvoer beïnvloeden. Vergelijk daarom een lege lijst met de ruwe header voordat je wijzigingen aanbrengt in de toepassing.
Origin-toegangsrechten en gevoelige gegevens
Bij toegang via de Performance API is de origin van de aanroepende pagina bepalend. Als een bron afkomstig is van een andere origin, moet het antwoord daarvan worden verwerkt met Timing-Allow-Origin de aanroepende Origin op de juiste manier toestaan, zodat JavaScript de betreffende timinginformatie, inclusief server-timing, kan uitlezen. Een CORS-toestemming alleen is geen vervanging voor deze aanvullende toestemming.
A concrete oorsprong beperkt de vrijgave tot de opgegeven herkomst. De plaatshouder * In principe staat het daarentegen alle Origins toe om de betreffende timinginformatie via de Performance API in te zien. Kies daarom voor de beperktere toegang als slechts één bekende toepassing de waarden nodig heeft, en controleer deze aan de hand van het daadwerkelijk geleverde antwoord over de resources.
Het Origin-veld maakt een antwoordheader niet vertrouwelijk. Wie het HTTP-antwoord zelf ontvangt, kan de inhoud ervan in principe onderzoeken. Maak daarom geen toegangsgegevens, persoonsgegevens of interne hostnamen openbaar in metrieknamen en beschrijvingen. Ook zeer gedetailleerde looptijden kunnen aanwijzingen geven over interne processen; geef alleen waarden weer waarvan je het nut en het risico bewust tegen elkaar hebt afgewogen.
Controleer de weergave ook in de browsers die je applicatie moet ondersteunen: de ondersteuning van bepaalde details en vereisten voor beveiligde contexten kan variëren. Voor de algemene beveiliging van antwoorden zijn bovendien geschikte beveiligingsheaders voor webservers relevant; ze vervangen echter noch de controle van de timingvrijgave, noch de beslissing welke meetwaarden openbaar mogen worden gemaakt.
Controleer op ontbrekende waarden en cache-effecten
Als de lijst met server-timing-waarden leeg blijft, begin dan bij het specifieke verzoek in het netwerkgedeelte van DevTools. Controleer onder ‘Headers’ of het geleverde antwoord überhaupt een Server-Timing-Header bevat en welke namen daarin staan. Als deze ontbreekt, onderzoek dan de instrumentatie en mogelijke wijzigingen door tussenliggende componenten, in plaats van conclusies te trekken over de snelheid op basis van de lege lijst.
Als de raw-header aanwezig is, controleer dan vervolgens de Prestatievermelding: Het navigatie-item beschrijft het laden van het document, terwijl een API-aanroep of een andere bron een bijbehorend bronitem vereist. Bij bronnen die afkomstig zijn van verschillende origins, controleer je bovendien of er toestemming is verleend door Timing-Allow-Origin en de ondersteuning in de gebruikte browser. Een lege lijst wijst op zichzelf noch op ontbrekende instrumentatie, noch op een snelle of trage reactie.
Zelfs een bestaande waarde heeft context nodig. Een CDN of proxy kan eigen statistieken bijdragen; tegelijkertijd kan een antwoord, inclusief headers, afkomstig zijn uit een cache. In dat geval geeft een eerder gegenereerde Origin-statistiek niet per se een beeld van de inspanningen van de Origin-server voor het huidige verzoek. Documenteer daarom Cache-status en herkomst los van de duur.
Controleer aan de hand van de concrete opbouw welke component de header instelt, doorgeeft of wijzigt, en hoe deze omgaat met in de cache opgeslagen antwoorden. Vergelijk vervolgens verzoeken met een bekende cache-status, voor zover je infrastructuur dat toelaat. Verschillen tussen deze antwoorden zijn nuttige aanwijzingen, maar zonder kennis van de betreffende meetgrenzen nog geen bewijs voor een bepaalde oorzaak.
Logboeken, trailers en gereedschapkeuze
Server-Timing vormt een aanvulling op andere diagnosemethoden, in plaats van deze te vervangen. De juiste keuze hangt af van of je een afzonderlijk browserverzoek wilt begrijpen, bestaande waarden programmatisch wilt vastleggen of verbanden tussen meerdere diensten wilt onderzoeken. In het volgende overzicht worden de respectievelijke inzichten gescheiden van de vereisten en beperkingen ervan.
| Gereedschap | Inzicht | Voorwaarde | Grens |
|---|---|---|---|
| DevTools | Afzonderlijke aanvragen en opgegeven tijden controleren | Browservraag met relevante statistieken | Geen automatische oorzaakanalyse |
| Performance API | Bestaande timingwaarden uitlezen via JavaScript | Juiste vermelding en, indien van toepassing, goedkeuring van de bron | Geen volledig dienstoverschrijdend proces |
| Serverlogs | De aan de serverzijde geregistreerde tijden analyseren | Geschikte logboekindeling en toegang tot logboeken | De meetbereiken en eenheden moeten worden gecontroleerd |
| Gedistribueerde tracering | De verbanden tussen de betrokken diensten onderzoeken | Instrumentatie en toewijzing van de traces | Extra kosten voor exploitatie en instrumentatie |
Voor een statistiek die pas na voltooiing van het antwoord vaststaat, kan een logboekvermelding geschikter zijn dan een reguliere antwoordheader. NGINX registreert bijvoorbeeld request_time en upstream_response_time in seconden met een resolutie van milliseconden. Server-Timing werkt daarentegen met milliseconden: een waarde in seconden moet met 1.000 worden vermenigvuldigd. Voordat je een vergelijking maakt, controleer je bovendien wanneer de betreffende meting begint en eindigt.
Op Streaming Bij het verzenden van reguliere headers is de totale lengte van het antwoordbericht mogelijk nog niet bekend. De specificatie staat Server-Timing ook toe als HTTP-trailer. Dit is echter geen universele oplossing: de Fetch API biedt geen toegang tot trailers, en de weergave ervan in ontwikkelaarstools moet per browser afzonderlijk worden gecontroleerd.
Voor betrouwbaardere vergelijkingen herhaal je soortgelijke verzoeken onder gedocumenteerde omstandigheden: leg bijvoorbeeld het eindpunt, de cachetoestand en relevante wijzigingen in het systeem vast. Bekijk meerdere waarden in plaats van één enkel verzoek en onderzoek opvallende verschillen verder aan de hand van logs of traces. Zo blijft zichtbaar welke waarneming daadwerkelijk door welke meting wordt gedekt.
Een browsergebaseerde testomgeving kan helpen bij het uitproberen van applicatie-instellingen, maar geeft niet automatisch een getrouwe weergave van de netwerkpaden en serverservices die later in de praktijk zullen worden gebruikt. Dit geldt ook voor WordPress Playground in de browser. Uitspraken over een specifieke hosting- en backend-configuratie controleer je bovendien in een omgeving die zo dicht mogelijk bij de productieomgeving ligt.
Bronnen en stand van zaken op vakgebied
Stand van het onderzoek:
Stand van zaken: 13 november 2026. De weergave in de browser en de ondersteuning van bepaalde functies kunnen variëren; de voorbeelden bevatten geen eigen metingen.
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/




