...

Server-Timing-header: Sådan forstår du backend-køretider i browseren

Der Server-Timing-header Overfører selvregistrerede backend-nøgletal via et HTTP-svar. Du kan knytte dem til den pågældende forespørgsel i browserens DevTools eller hente dem via Performance API. Forudsætningen er, at applikationen eller en anden komponent, der sender svaret, registrerer og udgiver værdierne. Headeret er ikke en automatisk profiler: Først dokumenterede måleintervaller viser, hvilket arbejde en varighed omfatter. Overlapninger, netværksruter og cache-svar kan ændre fortolkningen.

Hvad server-timing afslører

En langsom side kan miste tid i browseren, på netværksvejen eller under behandlingen på serveren. Den Server-Timing-header forener disse perspektiver: Den overfører nøgletal, som en involveret serverkomponent selv har registreret, sammen med et HTTP-svar. Browseren kan derefter knytte dem til den pågældende forespørgsel og vise dem.

Til dette formål skal applikationen f.eks. måle varigheden af en databaseoperation og skrive værdien i svarheaderen. Også en proxy eller en anden komponent, der genererer svar, kan bidrage med målinger. Uden en sådan instrumentering kan browseren ikke efterfølgende fastslå, hvor lang tid de enkelte serverbaserede trin har taget.

Hovedet er dermed et Transportformat, ingen automatisk profiler. Den fastlægger ikke, hvilke interne funktioner der skal undersøges, eller hvor detaljeret et program skal måle. Hvilke nøgletal der vises, afhænger af, hvad den ansvarlige komponent registrerer og frigiver til visning.

For Backend-ydeevne Det er nyttigt, fordi et selvmålt afsnit vises lige ved siden af oplysningerne om browserforespørgslen. En høj værdi er i første omgang et udgangspunkt for yderligere undersøgelser, men endnu ikke et bevis på, hvorfor en side er langsom. Nøgletallet i sig selv forklarer hverken årsagen hertil eller alle andre faktorer, der påvirker webpræstationen.

Til den praktiske anvendelse skal du derfor have adgang til applikationen eller en anden komponent, der kan påvirke svaret. Hvis der allerede leveres måleværdier, kan du derimod undersøge dem i browseren uden selv at ændre serverkonfigurationen. Også i så fald bør du afklare, hvor værdierne stammer fra, og hvad de rent faktisk omfatter.

Forståelse af målinger og header-syntaks

Et HTTP-svar kan indeholde en eller flere »Server Timing«-headerlinjer. Inden for en linje adskilles de enkelte måleværdier af kommaer; et semikolon indleder hver parameter. Hver måleværdi skal have et navn, mens varighed og beskrivelse er valgfri. En angivet varighed findes i parameteren dur og angives i millisekunder.

Følgende eksempel viser en HTTP-svarheader med to måleværdier. Tallene er vilkårligt valgte og ikke baseret på en faktisk måling; linjen er blot et eksempel på syntaksen og forudsætter ikke nogen bestemt applikation eller serverkonfiguration.

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

Her betegner db en måleenhed med varighed og beskrivelse; render har en varighed, men ingen beskrivelse. Oplysningerne ifølge desc Disse oplysninger tjener til forklaring. De erstatter ikke dokumentation for, hvornår den pågældende måling begynder og slutter.

Komponenter i en server-timing-metrik
BestanddelBetydningStatus for forpligtelserEksempel
NavnAngiver metrikkenPåkrævetdb
durVarighed i millisekunderValgfritdur=42,5
descBeskrivelse af måleparameterenValgfritdesc="Database"

Et navn som db afslører i sig selv hverken Måleområder heller ikke målemetoden. Det kan henvise til en enkelt forespørgsel, flere forespørgsler, der er lagt sammen, eller et anderledes defineret udsnit af databasen. Først når instrumenteringen er dokumenteret, bliver det klart, hvilket arbejde der faktisk er inkluderet i værdien.

For at kunne foretage meningsfulde sammenligninger bør du derfor for hver måleparameter notere start- og slutpunktet og angive, om den omfatter yderligere deloperationer. Hvis navnet f.eks. forbliver det samme, mens applikationen senere medregner yderligere forespørgsler i tidsberegningen, kan gamle og nye værdier ikke uden videre sammenlignes. Syntaksen i sig selv angiver ikke en sådan ændring.

Afgrænse backend-varighed og browser-ventetid

Den ventetid, der vises i browseren, og den rapporterede backend-varighed dækker ikke nødvendigvis over det samme tidsrum. En måling kan kun omfatte et bevidst udvalgt afsnit af behandlingen, mens browserens visning afspejler yderligere dele af forespørgsels- og svarforløbet. Lignende eller forskellige tal betyder derfor ikke automatisk, at de to målinger bekræfter eller modsiger hinanden.

Mellem browseren og applikationen kan der f.eks. være netværksstier og proxyservere. Også køer eller arbejdstrin i backend-systemet kan muligvis ligge uden for de fastlagte målepunkter. Hvis browseren venter længere, end en rapporteret databaseoperation varer, kan forskellen derfor ikke alene tilskrives en bestemt årsag ud fra denne ene nøgletal.

Omvendt kan server-timing-målinger overlappe eller være indlejret i hinanden. Hvis en samlet måling måler behandlingen af en forespørgsel inklusive databaseoperationen, er varigheden heraf allerede medregnet i den samlede værdi. Hvis du lægger begge tal sammen, tæller du dette afsnit dobbelt; ved parallelt udførte operationer kan summen af deres individuelle varigheder også være større end den forløbne tid.

Hovedet udgør derfor ikke automatisk en fuldstændig Vandfald behandlingen. Den videregiver de angivne nøgletal, men navnene og varighederne alene fastlægger hverken en tidsmæssig rækkefølge eller sammenhænge mellem afsnittene. For at kunne fortolke det skal du vide, om instrumenteringen registrerer separate, indbyrdes sammenhængende eller samtidigt foregående arbejdsgange.

Inden du udleder en optimering, skal du fastlægge målegrænserne og betingelserne for den pågældende forespørgsel. Gentag derefter lignende forespørgsler, og kontroller, om mønsteret viser sig under de samme betingelser. På den måde kan du bedre skelne mellem en enkelt afvigende værdi og et tilbagevendende mønster, uden at konkludere, at årsagen udelukkende ligger i målingen.

Kontroller HTML-svaret i DevTools

For en dynamisk HTML-side kan applikationen registrere to separate trin: en databaseoperation og den efterfølgende generering af HTML-koden. Målingen skal konfigureres i applikationen eller en anden komponent, der returnerer et svar. DevTools viser de leverede værdier, men beregner ikke selv de interne køretider.

Definer for db begyndelsen umiddelbart før en bestemt databaseoperation udføres, og slutningen, så snart resultatet heraf foreligger i applikationen. For render Tiden begynder umiddelbart før HTML-genereringen og slutter, så snart den færdige HTML er klar til svaret. Dokumenter, om f.eks. indlæsning af skabeloner er inkluderet heri.

Hvis begge trin er afsluttet, inden svarheaderen sendes, kunne svaret Server-Timing: db;dur=42.5, render;dur=18.0 indeholdt. Tallene er vilkårligt valgt og udgør ikke en måling. Først de dokumenterede start- og slutpunkter gør dem meningsfuldt sammenlignelige i en senere undersøgelse.

Åbn udviklerværktøjerne i Chrome og gå til fanen »Netværk«. Genindlæs siden, vælg dokumentanmodningen i listen over anmodninger, og tjek den modtagne rå header under »Headers«. Under »Timing« kan du derefter se visningen af de rapporterede server-timing-værdier; den nøjagtige visning kan variere afhængigt af browseren.

En iøjnefaldende Individuel værdi er et udgangspunkt, ikke et bevis på en generel årsag. Gentag lignende forespørgsler, og noter blandt andet den anvendte side, cache-status og ændringer i applikationen. På den måde kan du bedre se, om der er et mønster, eller om et enkelt svar afviger fra det normale.

Læs API-tider uden dobbelttælling

I forbindelse med en API kan applikationen ud over selve databehandlingen også registrere ventetiden på en ekstern tjeneste. Det afgørende her er Målegrænse: Hvis den samlede tid begynder, når API-handleren aktiveres, og slutter, når dens svar er klar til udlæsning, kan det eksterne kald være fuldt ud indeholdt heri.

I det følgende, vilkårligt valgte eksempel begynder den eksterne varighed umiddelbart før forespørgslen sendes til tjenesten og slutter, så snart svarets modtages i applikationen. Værdierne er kun til beregningsformål og udgør ikke en måling. Tabellen beskriver udtrykkeligt indlejrede tidsintervaller, ikke to uafhængige arbejdspakker.

Et vilkårligt valgt eksempel på indlejrede API-metrikker
MetrikkerMålegrænser i eksempletVarighed
Samlet forarbejdningIndgang i handleren, indtil svaret foreligger120 ms
Ekstern opkaldIndsendelse af forespørgslen, indtil der foreligger et svar fra tjenesten80 ms

Regnestykket 120 ms plus 80 ms giver ganske vist 200 ms, men her ville det være en Dobbelttælling: De 80 ms ligger allerede inden for de 120 ms. Regnemæssigt forbliver 40 ms af den samlede tidsperiode uden for det eksterne kald. Headeren alene forklarer dog ikke, hvilket arbejde eller hvilken ventetid denne resterende tidsperiode omfatter.

AI-genereret illustration af et mindre cirkelområde inden for et større som symbol på indlejrede API-tider
AI-genereret illustration: Varigheden af et eksternt opkald kan allerede være inkluderet i den samlede behandlingstid.

Heller ikke parallelle afhængigheder kan blot lægges sammen til en samlet forløbet tid. Hvis der f.eks. kører to opkald samtidigt, og de hver varer 80 ms, udgør deres individuelle varigheder tilsammen 160 ms, selvom deres tidsintervaller i vid udstrækning kan overlappe hinanden. Uden oplysninger om start og slutning kan den faktiske grad af overlapning ikke bestemmes ud fra varighederne alene.

For at afklare, hvilken tjeneste der har udløst hvilket yderligere kald, supplerer distribueret sporing header-værdierne. Server-timing kan knytte udvalgte varigheder til browserens svar, men beskriver ikke i sig selv de fuldstændige årsagssammenhænge mellem tjenesterne. Vær opmærksom på, når du sammenligner, at sporingen og header-værdierne henviser til de samme operationer og grænser.

Aflæse server-timing via JavaScript

Die Performance API gør eksisterende server-timing-data også tilgængelige programmatisk. En navigationspost beskriver indlæsningen af det aktuelle dokument; dens egenskab serverTiming indeholder de tilgængelige, indberettede målinger. Dette er et andet udvalg end en post for en efterindlæst ressource eller et API-kald.

Kør følgende JavaScript i browserkonsollen på den side, der skal undersøges. Det vælger den første tilgængelige navigationspost og viser dens server-timing-liste i tabelform. Koden læser kun allerede tilgængelige værdier: Den ændrer ikke serverkonfigurationen og udfører ingen belastningstest.

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

Hvis der ikke findes nogen navigationspost, eller hvis den ikke leverer tilgængelige målinger, viser eksemplet en tom liste. Det betyder hverken, at siden er hurtig eller langsom, eller nødvendigvis, at serveren ikke er instrumenteret. Kontroller først svarheaderen, og om den valgte post rent faktisk beskriver den ønskede forespørgsel.

For en genindlæst ressource skal du i stedet bruge den passende Ressourceoplysning. Blandt posterne af typen resource kan du ud fra navnet identificere den pågældende forespørgsel og dens serverTiming-Egenskab. Når du gentagne gange henter den samme adresse, skal du være opmærksom på, hvilken konkret post du sammenligner.

For ressourcer, der strækker sig på tværs af oprindelser, har den korrekte godkendelse via »Timing-Allow-Origin« desuden indflydelse på, om Performance API stiller tidsoplysningerne til rådighed. Browserstøtte og det pågældende miljø kan også påvirke udskriften. Sammenlign derfor en tom liste med råheaderen, inden du foretager ændringer i applikationen.

Origin-delinger og følsomme oplysninger

Ved adgang via Performance API er oprindelsen for den kaldende side afgørende. Hvis en ressource stammer fra en anden oprindelse, skal dens svar med Timing-Allow-Origin Sørg for at give den kaldende Origin den nødvendige tilladelse, så JavaScript kan læse de relevante timingoplysninger, herunder server-timing. En CORS-tilladelse alene er ikke tilstrækkelig til at erstatte denne yderligere tilladelse.

En konkret oprindelse begrænser frigivelsen til den angivne kilde. Pladsholderen * Derimod tillader det som udgangspunkt alle Origins at se de pågældende timingoplysninger via Performance API. Vælg derfor den snævrere tilladelse, hvis kun et kendt program har brug for værdierne, og kontroller dem i det faktisk leverede ressource-svar.

Origin-feltet gør ikke en svarheader fortrolig. Den, der modtager selve HTTP-svaret, kan i princippet undersøge dets indhold. Du bør derfor hverken offentliggøre adgangsdata, personoplysninger eller interne værtsnavne i metriknavne og beskrivelser. Selv meget detaljerede køretider kan give indblik i interne processer; angiv kun værdier, hvor du bevidst har afvejet fordelene og risiciene.

Kontroller desuden udvurderingen i de browsere, som din applikation skal understøtte: Understøttelsen af enkelte detaljer og krav til sikre kontekster kan variere. For generel sikring af svarene er der desuden egnede sikkerhedsheadere til webservere relevant; de erstatter dog hverken kontrollen af tidsmæssig frigivelse eller beslutningen om, hvilke måleværdier der må offentliggøres.

Kontroller manglende værdier og cache-effekter

Hvis listen med server-timing-værdier er tom, skal du starte med den konkrete forespørgsel i netværkssektionen i DevTools. Kontroller under »Headers«, om det returnerede svar overhovedet indeholder en Server-Timing-Hovedet indeholder, og hvilke navne der står der. Mangler det, skal du undersøge instrumenteringen og eventuelle ændringer forårsaget af mellemliggende komponenter, i stedet for at drage konklusioner om hastigheden ud fra den tomme liste.

Hvis råheaderen findes, skal du derefter kontrollere Præstationsoptegnelse: Navigationsposten beskriver indlæsningen af dokumentet, mens et API-kald eller en anden ressource kræver en passende ressourcepost. Ved ressourcer på tværs af domæner skal du desuden kontrollere, om de er godkendt af Timing-Allow-Origin samt understøttelsen i den anvendte browser. En tom liste beviser i sig selv hverken manglende instrumentering eller et hurtigt eller langsomt svar.

Selv en eksisterende værdi har brug for kontekst. Et CDN eller en proxy kan bidrage med egne målinger; samtidig kan et svar inklusive headere stamme fra en cache. I så fald beskriver en tidligere genereret Origin-måling ikke nødvendigvis Origin-serverens indsats i forbindelse med den aktuelle forespørgsel. Dokumenter derfor Cache-status og oprindelse uafhængigt af varigheden.

AI-genereret symbolbillede af tilsluttede netværkskabler til en switch i et nærbillede set fra siden
AI-genereret illustrativt billede: Der kan være yderligere netværkskomponenter mellem browseren og applikationen.

Undersøg i den konkrete opsætning, hvilken komponent der sætter, videresender eller ændrer headeren, og hvordan den håndterer cachelagrede svar. Sammenlign derefter forespørgsler med kendt cache-status, i det omfang din infrastruktur tillader det. Forskelle mellem disse svar er nyttige indikationer, men uden kendskab til de respektive målegrænser er de endnu ikke bevis for en bestemt årsag.

Logfiler, trailere og valg af værktøj

Server-Timing supplerer andre diagnostiske metoder i stedet for at erstatte dem. Det rette valg afhænger af, om du ønsker at forstå en enkelt browserforespørgsel, indsamle eksisterende værdier programmatisk eller undersøge sammenhænge på tværs af flere tjenester. Den følgende oversigt skelner mellem den respektive viden, der kan opnås, og dens forudsætninger og begrænsninger.

Sammenligning af diagnosemetoder for HTTP-svar
VærktøjIndsigtForudsætningGrænse
DevToolsKontroller individuelle forespørgsler og de indberettede tidspunkterBrowserforespørgsel med relevante målingerIngen automatisk årsagsanalyse
Performance APIHente eksisterende timing-værdier via JavaScriptRelevant indtastning og eventuelt godkendelse af oprindelseIngen fuldstændig tværgående proces
ServerlogfilerAnalyse af tidsdata, der er logget på serversidenPassende logformat og adgang til logfilerMålegrænser og enheder skal kontrolleres
Distribueret sporingUndersøge sammenhængene mellem de involverede tjenesterInstrumentering og tildeling af sporeneEkstra drifts- og instrumenteringsomkostninger

For en nøgletal, der først fastlægges, når svaret er færdigbehandlet, kan en logpost være mere velegnet end en almindelig svarheader. NGINX logger for eksempel request_time og upstream_response_time i sekunder med millisekundopløsning. Server-Timing bruger derimod millisekunder: En værdi i sekunder skal ganges med 1.000. Inden du foretager en sammenligning, skal du desuden kontrollere, hvornår den pågældende måling starter og slutter.

På Streaming Den samlede længde af svarkroppen er muligvis endnu ikke fastlagt, når almindelige headere sendes. Specifikationen tillader også Server-Timing som HTTP-trailer. Dette er dog ikke en universel løsning: Fetch API giver ikke adgang til trailere, og deres visning i udviklerværktøjer skal kontrolleres separat for den pågældende browser.

For at få mere pålidelige sammenligninger skal du gentage ensartede forespørgsler under dokumenterede betingelser: Notér f.eks. slutpunkt, cache-tilstand og relevante ændringer i systemet. Se på flere værdier i stedet for en enkelt forespørgsel, og undersøg markante forskelle nærmere ved hjælp af logfiler eller spor. På den måde forbliver det tydeligt, hvilken observation der faktisk dækkes af hvilken måling.

Et browserbaseret testmiljø kan være en hjælp, når man afprøver applikationsindstillinger, men afspejler ikke automatisk de netværksveje og servertjenester, der vil være til stede i den senere drift. Det gælder også for WordPress Playground i browseren. Du skal desuden teste udsagn om en konkret hosting- og backend-konfiguration i et miljø, der ligger så tæt på produktionsmiljøet som muligt.

Kilder og den aktuelle videnskabelige viden

Status for undersøgelsen:

Oplysningerne er opdateret pr. 13. november 2026. Visningen i browseren og understøttelsen af enkelte funktioner kan variere; eksemplerne indeholder ingen egne målinger.

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/

Aktuelle artikler

AI-genereret illustration af overlappende og indlejrede måleintervaller på mørk baggrund
Administration

Måling af PHP-udførelsestid uafhængigt af netværk og frontend

En PHP-timer, browser-timings og server-timing viser forskellige faser af en anmodning. På den måde kan du sammenligne deres grænser og målrettet indsnævre problemet til enten databasen, netværket eller frontend.