...

Header Server-Timing: comprendere i tempi di esecuzione del backend nel browser

Il sito Intestazione Server-Timing trasmette gli indicatori di backend acquisiti autonomamente tramite una risposta HTTP. È possibile associarli alla rispettiva richiesta nei DevTools del browser oppure leggerli tramite la Performance API. Il presupposto è che l’applicazione o un altro componente che fornisce la risposta acquisisca e restituisca i valori. L’intestazione non è un profiler automatico: solo i limiti di misurazione documentati indicano la durata di un’operazione. Sovrapposizioni, percorsi di rete e risposte dalla cache possono alterarne l’interpretazione.

Cosa rende visibile il "server timing"

Una pagina lenta può subire ritardi nel browser, durante il percorso di rete o durante l'elaborazione sul server. Il Intestazione Server-Timing unisce questi due punti di vista: trasmette gli indicatori che un componente server coinvolto ha registrato autonomamente, insieme a una risposta HTTP. Il browser può quindi associarli alla rispettiva richiesta e visualizzarli.

A tal fine, ad esempio, l'applicazione deve misurare la durata di un'operazione sul database e inserire il valore nell'intestazione della risposta. Anche un proxy o un altro componente che fornisce la risposta può fornire metriche. Senza una tale strumentazione, il browser non è in grado di determinare a posteriori quanto tempo abbiano richiesto le singole fasi di elaborazione lato server.

L'intestazione è quindi un Formato di trasporto, non è un profiler automatico. Non stabilisce quali funzioni interne debbano essere analizzate né il livello di dettaglio con cui un’applicazione deve effettuare le misurazioni. Gli indicatori visualizzati dipendono da ciò che il componente responsabile rileva e rende disponibile per l’output.

Per il Prestazioni del backend Questo è utile perché una sezione misurata autonomamente viene visualizzata proprio accanto alle informazioni relative alla richiesta del browser. Un valore elevato costituisce innanzitutto un punto di partenza per ulteriori analisi, ma non è ancora una prova del motivo per cui una pagina sia lenta. Questo indicatore, da solo, non spiega né la causa né tutte le altre componenti delle prestazioni web.

Per l'utilizzo pratico, quindi, è necessario avere accesso all'applicazione o a un altro componente in grado di influenzare la risposta. Se invece sono già disponibili delle metriche, è possibile esaminarle nel browser senza dover modificare personalmente la configurazione del server. Anche in questo caso, però, è opportuno chiarire da dove provengano i valori e cosa comprendano effettivamente.

Comprendere le metriche e la sintassi delle intestazioni

Una risposta HTTP può contenere una o più righe di intestazione "Server Timing". All’interno di una riga, le singole metriche sono separate da virgole; ogni parametro è preceduto da un punto e virgola. Ogni metrica deve avere un nome, mentre la durata e la descrizione sono facoltative. La durata riportata è indicata nel parametro dur ed è espresso in millisecondi.

L'esempio seguente mostra una riga di intestazione di risposta HTTP con due metriche. I numeri sono stati scelti a caso e non rappresentano alcuna misurazione; la riga è semplicemente un esempio sintattico e non presuppone alcuna applicazione o configurazione del server specifica.

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

Qui si intende db una metrica con durata e descrizione; render ha una durata, ma nessuna descrizione. Le informazioni secondo desc Hanno scopo illustrativo. Non sostituiscono la documentazione relativa all’ora di inizio e di fine della rispettiva misurazione.

Componenti di una metrica di timing del server
ComponenteSignificatoStato obbligatorioEsempio
NomeIndica la metricaRichiestodb
durDurata in millisecondiOpzionaledur=42,5
descDescrizione della metricaOpzionaledesc="Database"

Un nome come db di per sé non rivela né la Limiti di misura né il metodo di misurazione. Potrebbe riferirsi a una singola interrogazione, a più interrogazioni sommate o a una sezione del database definita in altro modo. Solo la documentazione della strumentazione permette di comprendere quale lavoro sia effettivamente incluso nel valore.

Per effettuare confronti significativi, dovresti quindi registrare per ogni metrica il punto di inizio e quello di fine e specificare se essa include ulteriori operazioni parziali. Se, ad esempio, il nome rimane lo stesso mentre l’applicazione in seguito include nel calcolo ulteriori query, i valori vecchi e quelli nuovi non sono facilmente comparabili. La sintassi da sola non indica una modifica di questo tipo.

Distinguere tra durata del backend e tempo di attesa del browser

Il tempo di attesa visibile nel browser e la durata segnalata dal backend non descrivono necessariamente lo stesso intervallo di tempo. Una metrica può rilevare solo una porzione specificatamente selezionata dell’elaborazione, mentre la visualizzazione del browser riproduce anche altre parti del percorso della richiesta e della risposta. Valori simili o diversi non significano quindi automaticamente che le due misurazioni si confermino o si contraddicano a vicenda.

Tra il browser e l'applicazione possono esserci, ad esempio, percorsi di rete e proxy. Anche le code o le fasi di elaborazione all'interno del backend potrebbero non rientrare nei punti di misurazione impostati. Se il browser attende più a lungo di quanto duri un'operazione sul database segnalata, non è quindi possibile attribuire la differenza a una causa specifica basandosi esclusivamente su questo unico indicatore.

Al contrario, le metriche di timing del server possono sovrapporsi oppure essere annidate l'una nell'altra. Se una metrica complessiva misura l'elaborazione di una richiesta, compresa l'operazione sul database, la durata di quest'ultima è già inclusa nel valore complessivo. Sommando entrambi i valori, si conta due volte questa sezione; nel caso di operazioni eseguite in parallelo, la somma delle loro durate individuali può anche essere superiore al tempo trascorso.

L'intestazione non costituisce quindi automaticamente un testo completo Cascata dell'elaborazione. Esso riporta alcuni indicatori specifici, ma i nomi e le durate di per sé non definiscono né una sequenza temporale né relazioni tra le sezioni. Per l'interpretazione è necessario sapere se la strumentazione rileva attività separate, annidate o in esecuzione simultanea.

Prima di dedurre un'ottimizzazione, definisci i limiti di misurazione e le condizioni della richiesta in esame. Ripeti quindi richieste simili e verifica se lo schema si ripete nelle stesse condizioni. In questo modo potrai distinguere meglio un singolo valore anomalo da un'indicazione ricorrente, senza attribuire una causa solo sulla base della metrica.

Verificare la risposta HTML in DevTools

Per una pagina HTML dinamica, l'applicazione può registrare due fasi distinte: un'operazione sul database e la successiva generazione del codice HTML. La misurazione deve essere configurata nell'applicazione o in un altro componente che fornisce la risposta. DevTools visualizza i valori forniti, ma non calcola autonomamente i tempi di esecuzione interni.

Definisci per db l'inizio immediatamente prima dell'esecuzione di una determinata operazione sul database e la fine non appena il risultato di tale operazione è disponibile nell'applicazione. Per render Il tempo decorre immediatamente prima della generazione dell'HTML e termina non appena l'HTML definitivo è pronto per la risposta. Indica se, ad esempio, in questo lasso di tempo è incluso il caricamento dei modelli.

Supponendo che entrambe le fasi siano state completate prima dell'invio dell'header di risposta: in tal caso, la risposta potrebbe Server-Timing: db;dur=42.5, render;dur=18.0 contenuti. I numeri sono stati scelti a caso e non rappresentano una misurazione. Solo i punti di inizio e di fine documentati li rendono significativamente comparabili per un’analisi successiva.

Apri gli strumenti di sviluppo in Chrome e la scheda Rete. Aggiorna la pagina, seleziona la richiesta del documento nell'elenco delle richieste e controlla l'intestazione grezza ricevuta nella sezione Intestazioni. Nella sezione “Timing” puoi quindi visualizzare i valori di timing del server riportati; la visualizzazione esatta può variare a seconda del browser.

Un vistoso Valore individuale È un punto di partenza, non una prova di una causa generale. Ripeti richieste simili e prendi nota, ad esempio, della pagina utilizzata, dello stato della cache e delle modifiche apportate all'applicazione. In questo modo potrai capire meglio se si ripete uno schema o se una singola risposta è fuori dalla norma.

Leggere i tempi API senza conteggi doppi

Nel caso di un’API, l’applicazione può gestire non solo l’intera elaborazione, ma anche l’attesa di un servizio esterno. In questo contesto, è fondamentale la Limite di rilevabilità: Se il tempo totale inizia all'ingresso nell'handler API e termina quando la sua risposta è pronta per essere visualizzata, la chiamata esterna può essere interamente contenuta al suo interno.

Nell'esempio seguente, scelto a titolo illustrativo, la durata esterna ha inizio immediatamente prima dell'invio della richiesta al servizio e termina non appena la risposta di quest'ultimo è disponibile nell'applicazione. I valori sono puramente indicativi e non rappresentano una misurazione effettiva. La tabella descrive espressamente intervalli di tempo annidati, non due pacchetti di lavoro indipendenti.

Esempio arbitrario di metriche API annidate
MetricheLimiti di misura nell'esempioDurata
Lavorazione complessivaEntrata nell'handler non appena è disponibile la risposta120 ms
Chiamata esternaInvio della richiesta in attesa di risposta da parte del servizio80 ms

Il calcolo di 120 ms più 80 ms dà sì come risultato 200 ms, ma in questo caso sarebbe un Conteggio doppio: Gli 80 ms rientrano già nei 120 ms. A conti fatti, 40 ms dell'intervallo totale rimangono al di fuori della chiamata esterna. Tuttavia, l'intestazione da sola non spiega quale attività o tempo di attesa comprenda questo intervallo rimanente.

Illustrazione generata dall'intelligenza artificiale che raffigura un cerchio più piccolo all'interno di uno più grande, come simbolo dei tempi API annidati
Illustrazione generata dall'IA: la durata di una chiamata esterna può essere già inclusa nel tempo di elaborazione complessivo.

Anche le dipendenze parallele non possono essere semplicemente sommate per ottenere un tempo totale trascorso. Se, ad esempio, due chiamate vengono eseguite contemporaneamente e durano ciascuna 80 ms, le loro durate individuali sommate danno 160 ms, sebbene i loro intervalli di tempo possano sovrapporsi in larga misura. Senza informazioni sull'inizio e sulla fine, non è possibile determinare il grado effettivo di sovrapposizione basandosi esclusivamente sulle durate.

Per determinare quale servizio abbia innescato quale ulteriore chiamata, il tracciamento distribuito integra i valori dell’header. Il Server-Timing può associare tempi selezionati alla risposta del browser, ma di per sé non descrive le relazioni causali complete tra i servizi. Durante il confronto, assicurati che la traccia e l’intestazione si riferiscano alle stesse operazioni e agli stessi limiti.

Leggere i tempi del server tramite JavaScript

Il sito API delle prestazioni rende accessibili anche a livello di programmazione i dati relativi al timing del server già disponibili. Una voce di navigazione descrive il caricamento del documento corrente; la sua proprietà serverTiming contiene le metriche segnalate disponibili a tale scopo. Si tratta di una selezione diversa rispetto a quella di una voce relativa a una risorsa caricata successivamente o a una chiamata API.

Esegui il seguente codice JavaScript nella console del browser sulla pagina da analizzare. Il codice seleziona la prima voce di navigazione presente e ne visualizza l'elenco dei tempi del server sotto forma di tabella. Il codice legge solo i valori già disponibili: non modifica alcuna configurazione del server e non esegue alcun test di carico.

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

Se non è presente alcuna voce di navigazione o se questa non fornisce metriche accessibili, l'esempio mostra un elenco vuoto. Ciò non implica né che la pagina sia veloce o lenta, né necessariamente che il server non disponga di strumenti di monitoraggio. Verifica innanzitutto l'header di risposta e se la voce selezionata descrive effettivamente la richiesta desiderata.

Per una risorsa ricaricata, ti serve invece il corrispondente Scheda delle risorse. Tra le voci di tipo resource puoi identificare la richiesta che stai cercando in base al nome e il suo serverTiming-Considera questa proprietà. In caso di chiamate ripetute allo stesso indirizzo, devi prestare attenzione a quale voce specifica stai confrontando.

Nel caso di risorse che coinvolgono più origini, anche l'autorizzazione appropriata tramite `Timing-Allow-Origin` influisce sulla disponibilità delle informazioni temporali da parte dell'API delle prestazioni. Anche il supporto del browser e l'ambiente specifico possono influire sul risultato. Si consiglia quindi di confrontare un elenco vuoto con l'intestazione grezza prima di apportare modifiche all'applicazione.

Condivisioni su Origin e dati sensibili

Quando si accede tramite la Performance API, l’origine della pagina chiamante è determinante. Se una risorsa proviene da un’altra origine, la sua risposta deve essere Timing-Allow-Origin configurare correttamente l'origine chiamante in modo che JavaScript possa leggere le informazioni di temporizzazione corrispondenti, comprese quelle relative al server. L'autorizzazione CORS da sola non sostituisce questa autorizzazione aggiuntiva.

A origine concreta limita l'autorizzazione alla provenienza specificata. Il carattere jolly * Consente invece, in linea di principio, a tutte le origini di visualizzare le informazioni di temporizzazione in questione tramite l’API delle prestazioni. Scegli quindi l’autorizzazione più restrittiva se solo un’applicazione nota necessita di tali valori e verifica tali valori rispetto alla risposta effettiva fornita dalla risorsa.

L'autorizzazione "Origin" non rende riservata un'intestazione di risposta. Chi riceve la risposta HTTP può, in linea di principio, esaminarne il contenuto. Pertanto, non pubblicare né credenziali di accesso né dati personali, né nomi di host interni nei nomi delle metriche e nelle descrizioni. Anche i tempi di esecuzione dettagliati possono consentire di trarre conclusioni sui processi interni; riporta solo valori di cui hai consapevolmente valutato i vantaggi e i rischi.

Verifica inoltre il funzionamento nei browser che la tua applicazione deve supportare: il supporto di singoli dettagli e i requisiti relativi ai contesti sicuri possono variare. Per garantire la sicurezza generale delle risposte, è inoltre necessario header di sicurezza adeguati per i server web rilevanti; tuttavia, non sostituiscono né la verifica dell’autorizzazione temporale né la decisione su quali valori di misura possano essere resi pubblici.

Verificare la presenza di valori mancanti e gli effetti della cache

Se l'elenco dei valori di Server Timing risulta vuoto, inizia dall'istanza specifica nella sezione "Rete" dei DevTools. Verifica nella sezione "Headers" se la risposta fornita contiene effettivamente un Server-Timing- l'intestazione e quali nomi vi figurano. Se manca, esamina la strumentazione ed eventuali modifiche apportate da componenti intermedi, invece di trarre conclusioni sulla velocità basandoti sull'elenco vuoto.

Se il "Rohheader" è presente, controlla quindi il Voce relativa alle prestazioni: La voce di navigazione descrive il caricamento del documento, mentre una chiamata API o un’altra risorsa richiede una voce di risorsa corrispondente. Nel caso di risorse cross-origin, verifica inoltre l’autorizzazione tramite Timing-Allow-Origin nonché il supporto offerto dal browser utilizzato. Un elenco vuoto di per sé non indica né una mancanza di strumentazione né una risposta veloce o lenta.

Anche un valore già presente necessita di un contesto. Un CDN o un proxy può fornire le proprie metriche; allo stesso tempo, una risposta, insieme alle intestazioni, può provenire da una cache. In tal caso, una metrica Origin generata in precedenza non descrive necessariamente il lavoro svolto dal server Origin per la richiesta corrente. Documenta quindi Stato della cache e provenienza indipendentemente dalla durata.

Immagine simbolica generata dall'IA che mostra un cavo di rete collegato a uno switch, in primo piano laterale
Immagine simbolica generata dall'IA: tra il browser e l'applicazione possono esserci altri componenti di rete.

Verifica, nell'ambito della tua infrastruttura specifica, quale componente imposta, inoltra o modifica l'intestazione e come gestisce le risposte memorizzate nella cache. Confronta quindi le richieste con lo stato noto della cache, nella misura in cui la tua infrastruttura lo consenta. Le differenze tra queste risposte sono indicazioni utili, ma senza conoscere i rispettivi limiti di misurazione non costituiscono ancora una prova di una causa specifica.

Registri, trailer e scelta degli attrezzi

Il Server-Timing integra altri metodi diagnostici, senza sostituirli. La scelta più appropriata dipende dal fatto che tu voglia comprendere una singola richiesta del browser, acquisire valori esistenti a livello di programmazione o analizzare le interrelazioni tra più servizi. La seguente panoramica distingue le rispettive informazioni ottenibili dai relativi prerequisiti e limiti.

Confronto tra i percorsi di diagnostica per le risposte HTTP
StrumentoConoscenzaPrerequisitoConfine
Strumenti di sviluppoVerificare le singole richieste e gli orari segnalatiRichiesta del browser con metriche corrispondentiNessuna analisi automatica delle cause
API delle prestazioniLeggere i valori di temporizzazione esistenti tramite JavaScriptVoce corrispondente e, se del caso, autorizzazione "Origin"Non esiste un flusso di lavoro completo trasversale ai servizi
Log del serverAnalizzare i tempi registrati sul lato serverFormato di log appropriato e accesso ai logÈ necessario verificare i limiti di misura e le unità di misura
Tracciamento distribuitoAnalizzare le interconnessioni tra i servizi coinvoltiStrumentazione e assegnazione delle tracceCosti aggiuntivi di esercizio e strumentazione

Per un indicatore che viene determinato solo al termine della risposta, una voce di log può essere più appropriata rispetto a un’intestazione di risposta standard. NGINX, ad esempio, registra request_time e upstream_response_time in secondi con una risoluzione in millisecondi. Il Server-Timing, invece, utilizza i millisecondi: un valore espresso in secondi deve essere moltiplicato per 1.000. Prima di effettuare un confronto, verifica inoltre quando inizia e quando termina la rispettiva misurazione.

All'indirizzo Streaming è possibile che la durata complessiva del corpo della risposta non sia ancora definita al momento dell'invio delle intestazioni regolari. La specifica consente l'uso del server timing anche come trailer HTTP. Tuttavia, questa non è una soluzione universale: la Fetch API non rende accessibili i trailer e la loro visualizzazione negli strumenti di sviluppo deve essere verificata separatamente per ciascun browser.

Per ottenere confronti più affidabili, ripeti le stesse richieste in condizioni documentate: registra, ad esempio, l’endpoint, lo stato della cache e le modifiche rilevanti apportate al sistema. Prendi in considerazione più valori anziché una singola richiesta e approfondisci le differenze evidenti tramite log o trace. In questo modo rimane chiaro quale osservazione sia effettivamente coperta da quale misurazione.

Un ambiente di test basato su browser può essere utile per sperimentare le impostazioni dell'applicazione, ma non riproduce automaticamente i percorsi di rete e i servizi server che saranno utilizzati in fase operativa. Ciò vale anche per WordPress Playground nel browser. Verifica inoltre le indicazioni relative a una configurazione specifica di hosting e backend in un ambiente il più possibile simile a quello di produzione.

Fonti e stato dell'arte

Stato della ricerca:

Aggiornato al: 13 novembre 2026. La visualizzazione nel browser e il supporto delle singole funzioni possono variare; gli esempi non contengono misurazioni proprie.

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/

Articoli attuali