...

Encabezado «Server-Timing»: cómo interpretar los tiempos de ejecución del backend en el navegador

El Encabezado «Server-Timing» Envía métricas de backend registradas por sí misma mediante una respuesta HTTP. Puedes asignarlas a la solicitud correspondiente en las herramientas de desarrollo del navegador o leerlas a través de la API de rendimiento. Para ello, es necesario que la aplicación u otro componente que envíe la respuesta registre y envíe los valores. El encabezado no es un perfilador automático: solo los límites de medición documentados muestran cuánto tiempo lleva una operación. Las superposiciones, las rutas de red y las respuestas de caché pueden alterar la interpretación.

Lo que revela el «server timing»

Una página lenta puede perder tiempo en el navegador, en la ruta de red o durante el procesamiento en el servidor. El Encabezado «Server-Timing» combina estas perspectivas: transmite los indicadores que un componente del servidor implicado ha registrado por sí mismo, junto con una respuesta HTTP. A continuación, el navegador puede asignarlos a la solicitud correspondiente y mostrarlos.

Para ello, la aplicación debe, por ejemplo, medir la duración de una operación de base de datos e incluir ese valor en el encabezado de la respuesta. Un proxy u otro componente que envíe respuestas también puede aportar métricas. Sin este tipo de instrumentación, el navegador no puede determinar a posteriori cuánto tiempo han durado los distintos pasos del proceso en el servidor.

Por lo tanto, el encabezado es un Formato de transporte, no es un generador automático de perfiles. No determina qué funciones internas se analizan ni el nivel de detalle con el que debe realizar las mediciones una aplicación. Los indicadores que se muestran dependen de lo que el componente responsable registre y envíe a la salida.

Para el Rendimiento del backend Esto resulta útil porque el tramo medido por uno mismo aparece justo al lado de la información sobre la solicitud del navegador. Un valor elevado es, en un primer momento, un punto de partida para seguir investigando, pero aún no constituye una prueba de por qué una página es lenta. Este indicador, por sí solo, no explica ni su causa ni todos los demás factores que influyen en el rendimiento web.

Por lo tanto, para su uso práctico, necesitas tener acceso a la aplicación o a cualquier otro componente que pueda influir en la respuesta. Sin embargo, si ya se proporcionan métricas, puedes analizarlas en el navegador sin necesidad de modificar tú mismo la configuración del servidor. Aun así, deberías aclarar de dónde proceden los valores y qué es lo que realmente incluyen.

Comprender las métricas y la sintaxis de los encabezados

Una respuesta HTTP puede contener una o varias líneas de encabezado «Server Timing». Dentro de cada línea, las métricas se separan mediante comas; cada parámetro va precedido de un punto y coma. Cada métrica debe tener un nombre, mientras que la duración y la descripción son opcionales. La duración indicada figura en el parámetro dur y se expresa en milisegundos.

El siguiente ejemplo muestra una línea de encabezado de respuesta HTTP con dos métricas. Las cifras son arbitrarias y no corresponden a ninguna medición; la línea es simplemente un ejemplo sintáctico y no presupone ninguna aplicación ni configuración de servidor concretas.

Código
Server-Timing: db;dur=42.5;desc="Datenbank", render;dur=18.0

Aquí se refiere a db una métrica con duración y descripción; render tiene una duración, pero no una descripción. Los datos según desc Tienen carácter explicativo. No sustituyen a la documentación sobre cuándo comienza y termina cada medición.

Componentes de una métrica de sincronización del servidor
ComponenteSignificadoEstado de obligaciónEjemplo
NombreSe refiere a la métricaRequeridodb
durDuración en milisegundosOpcionaldur=42,5
descDescripción de la métricaOpcionaldesc="Base de datos"

Un nombre como db por sí solo no revela la Límites de medición ni el método de medición. Podría referirse a una consulta concreta, a varias consultas sumadas o a una sección de la base de datos definida de otra forma. Solo la documentación de la instrumentación permite comprender qué trabajo está realmente incluido en el valor.

Por lo tanto, para que las comparaciones sean significativas, debes anotar el punto inicial y el final de cada métrica y describir si incluye otras operaciones parciales. Si, por ejemplo, el nombre sigue siendo el mismo, pero la aplicación incluye posteriormente consultas adicionales en el cálculo del tiempo, los valores antiguos y los nuevos no son comparables sin más. La sintaxis por sí sola no indica tal cambio.

Delimitar la duración del backend y el tiempo de espera del navegador

El tiempo de espera visible en el navegador y la duración del backend indicada no describen necesariamente el mismo intervalo de tiempo. Una métrica solo puede registrar una parte del proceso seleccionada de forma deliberada, mientras que la vista del navegador muestra otras partes del recorrido de la solicitud y la respuesta. Por lo tanto, unas cifras similares o diferentes no significan automáticamente que ambas mediciones se confirmen o se contradigan entre sí.

Entre el navegador y la aplicación pueden interponerse, por ejemplo, rutas de red y servidores proxy. Asimismo, es posible que las colas o los pasos de trabajo dentro del backend queden fuera de los puntos de medición establecidos. Por lo tanto, si el navegador espera más tiempo del que dura una operación de base de datos notificada, la diferencia no puede atribuirse a una causa concreta basándose únicamente en este indicador.

Por el contrario, las métricas de sincronización del servidor pueden solaparse o estar anidados entre sí. Si una métrica global mide el procesamiento de una consulta, incluida la operación de la base de datos, su duración ya está incluida en el valor total. Si sumas ambas cifras, estás contando esta sección por duplicado; en el caso de operaciones ejecutadas en paralelo, la suma de sus duraciones individuales también puede ser mayor que el tiempo transcurrido.

Por lo tanto, el encabezado no constituye automáticamente un Cascada del procesamiento. Proporciona una serie de indicadores específicos, pero los nombres y las duraciones por sí solos no establecen ni una secuencia temporal ni relaciones entre las distintas fases. Para interpretarlos, debes saber si la instrumentación registra trabajos independientes, anidados o que se ejecutan simultáneamente.

Antes de deducir una optimización, define los límites de medición y las condiciones de la consulta en cuestión. A continuación, repite consultas similares y comprueba si el patrón se repite en las mismas condiciones. De este modo, podrás distinguir mejor un valor atípico aislado de una indicación recurrente, sin atribuir una causa basándote únicamente en la métrica.

Comprobar la respuesta HTML en DevTools

En el caso de una página HTML dinámica, la aplicación puede registrar dos pasos de trabajo independientes: una operación de base de datos y la posterior generación del código HTML. La medición debe configurarse en la aplicación o en cualquier otro componente que genere la respuesta. DevTools muestra los valores proporcionados, pero no calcula por sí mismo los tiempos de ejecución internos.

Define para db el inicio, justo antes de llamar a una operación concreta de la base de datos, y el final, en cuanto el resultado de dicha operación esté disponible en la aplicación. Para render Este periodo comienza justo antes de la generación del código HTML y finaliza en cuanto el código HTML definitivo está listo para la respuesta. Indica si, por ejemplo, se incluye en él la carga de plantillas.

Supongamos que ambos pasos se han completado antes de enviar los encabezados de respuesta: en ese caso, la respuesta podría Server-Timing: db;dur=42.5, render;dur=18.0 incluidos. Las cifras son arbitrarias y no constituyen una medición. Solo los puntos de inicio y fin documentados permiten compararlas de forma significativa para un análisis posterior.

Abre las herramientas de desarrollador de Chrome y la pestaña «Red». Actualiza la página, selecciona la solicitud del documento en la lista de solicitudes y comprueba, en la sección «Encabezados», el encabezado sin procesar recibido. A continuación, en «Timing» puedes ver la representación de los valores de «Server Timing» notificados; la presentación exacta puede variar según el navegador.

Un llamativo Valor individual Es un punto de partida, no una prueba de una causa general. Repite consultas similares y anota, por ejemplo, la página utilizada, el estado de la caché y los cambios realizados en la aplicación. Así podrás detectar mejor si se repite un patrón o si una respuesta concreta se sale de lo habitual.

Consultar los tiempos de la API sin doble recuento

En el caso de una API, la aplicación puede registrar, además de todo el procesamiento, la espera de un servicio externo. Lo decisivo en este caso es la Límite de medición: Si el tiempo total comienza al entrar en el controlador de la API y finaliza cuando su respuesta está lista para ser mostrada, la llamada externa puede estar completamente incluida en él.

En el siguiente ejemplo, elegido libremente, la duración externa comienza justo antes de enviar la solicitud al servicio y finaliza en cuanto la aplicación recibe la respuesta. Los valores sirven únicamente a efectos de cálculo y no constituyen una medición. La tabla describe expresamente intervalos de tiempo superpuestos, no dos paquetes de trabajo independientes.

Ejemplo elegido libremente de métricas de API anidadas
MétricasLímites de medición en el ejemploDuración
Procesamiento totalEntrada en el Handler hasta que la respuesta esté disponible120 ms
Llamada externaDesde el envío de la solicitud hasta que se reciba la respuesta del servicio80 ms

Aunque la suma de 120 ms más 80 ms da como resultado 200 ms, en este caso sería una Doble recuento: Los 80 ms ya están incluidos dentro de los 120 ms. Según los cálculos, quedan 40 ms del intervalo total fuera de la llamada externa. Sin embargo, el encabezado por sí solo no explica qué tarea o tiempo de espera comprende ese intervalo restante.

Ilustración generada por IA de un círculo más pequeño dentro de otro más grande, como símbolo de los tiempos de API anidados
Ilustración generada por IA: La duración de una llamada externa puede estar ya incluida en el tiempo total de procesamiento.

Las dependencias paralelas tampoco se pueden sumar simplemente para obtener un tiempo total transcurrido. Si, por ejemplo, se ejecutan dos llamadas simultáneamente y cada una dura 80 ms, la suma de sus duraciones individuales es de 160 ms, aunque sus intervalos de tiempo puedan solaparse en gran medida. Sin información sobre el inicio y el final, no es posible determinar el grado real de solapamiento a partir de las duraciones por sí solas.

Para determinar qué servicio ha desencadenado qué llamada posterior, el rastreo distribuido complementa los valores de los encabezados. El «server timing» puede vincular duraciones seleccionadas a la respuesta del navegador, pero por sí solo no describe las relaciones causales completas entre los servicios. Al realizar la comparación, asegúrate de que el rastreo y los encabezados se refieran a las mismas operaciones y límites.

Obtener información sobre el tiempo de respuesta del servidor mediante JavaScript

El API de rendimiento permite acceder a los datos de temporización del servidor existentes también mediante programación. Una entrada de navegación describe la carga del documento actual; su propiedad serverTiming contiene las métricas notificadas disponibles para ello. Se trata de una selección diferente a la de una entrada correspondiente a un recurso cargado posteriormente o a una llamada a la API.

Ejecuta el siguiente código JavaScript en la consola del navegador, en la página que quieras analizar. Este código selecciona la primera entrada de navegación disponible y muestra su lista de tiempos de servidor en forma de tabla. El código solo lee los valores ya disponibles: no modifica la configuración del servidor ni realiza ninguna prueba de carga.

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

Si no hay ninguna entrada de navegación o si esta no proporciona métricas accesibles, el ejemplo muestra una lista vacía. Esto no significa ni que la página sea rápida o lenta, ni que el servidor carezca necesariamente de instrumentación. Comprueba primero el encabezado de respuesta y si la entrada seleccionada describe realmente la solicitud deseada.

Para un recurso cargado posteriormente, necesitas, en su lugar, el correspondiente Entrada de recurso. Entre las entradas del tipo resource puedes identificar la solicitud que buscas por el nombre y su serverTiming-Considera esta propiedad. Si accedes repetidamente a la misma dirección, debes prestar atención a qué entrada concreta estás comparando.

En el caso de los recursos que abarcan varios orígenes, la autorización adecuada mediante «Timing-Allow-Origin» también influye en que la API de rendimiento facilite la información temporal. La compatibilidad del navegador y el entorno concreto también pueden afectar al resultado. Por lo tanto, compara una lista vacía con el encabezado sin procesar antes de realizar cambios en la aplicación.

Compartir archivos en Origin e información confidencial

Al acceder a través de la API de rendimiento, el origen de la página que realiza la llamada es determinante. Si un recurso procede de otro origen, su respuesta debe incluir Timing-Allow-Origin Configurar adecuadamente el origen de origen de la llamada para que JavaScript pueda leer la información de tiempos correspondiente, incluida la de «server-timing». Una autorización CORS por sí sola no sustituye a esta autorización adicional.

A Origen concreto limita la autorización al origen indicado. El comodín * Por el contrario, permite, en principio, que todos los orígenes puedan consultar la información de temporización correspondiente a través de la API de rendimiento. Por lo tanto, elige la autorización más restrictiva si solo una aplicación conocida necesita los valores y compruébalos con la respuesta de recursos realmente enviada.

La autorización «Origin» no hace que un encabezado de respuesta sea confidencial. Quien reciba la respuesta HTTP puede, en principio, examinar su contenido. Por lo tanto, no publiques datos de acceso, datos personales ni nombres de host internos en los nombres de métricas y descripciones. Los tiempos de ejecución muy detallados también pueden permitir deducir procesos internos; solo publica valores cuya utilidad y riesgo hayas sopesado conscientemente.

Comprueba además el resultado en los navegadores con los que tu aplicación debe ser compatible: la compatibilidad con determinados detalles y los requisitos de los contextos seguros pueden variar. Para garantizar la seguridad general de las respuestas, además encabezados de seguridad adecuados para servidores web son relevantes; sin embargo, no sustituyen ni la comprobación de la autorización de sincronización ni la decisión sobre qué valores de medición pueden hacerse públicos.

Comprobar los valores que faltan y los efectos de caché

Si la lista con los valores de «Server Timing» está vacía, empieza por la solicitud concreta en la sección de red de DevTools. Comprueba, en «Headers», si la respuesta enviada incluye siquiera un Server-Timing-Qué nombres contiene el encabezado y cuáles aparecen en él. Si falta, analiza la instrumentación y los posibles cambios provocados por componentes intermedios, en lugar de deducir la velocidad a partir de la lista vacía.

Si existe el encabezado sin procesar, comprueba a continuación el Entrada de rendimiento: La entrada de navegación describe la carga del documento, mientras que una llamada a la API u otro recurso requiere una entrada de recurso adecuada. En el caso de los recursos entre dominios, también debes comprobar la autorización mediante Timing-Allow-Origin así como la compatibilidad con el navegador utilizado. Una lista vacía no demuestra por sí sola ni la falta de instrumentación ni que la respuesta sea rápida o lenta.

Incluso un valor ya existente necesita contexto. Una CDN o un proxy pueden aportar sus propias métricas; al mismo tiempo, una respuesta, incluidos los encabezados, puede proceder de una caché. En ese caso, una métrica de origen generada previamente no describe necesariamente el trabajo del servidor de origen para la solicitud actual. Por lo tanto, documenta Estado de la caché y origen independientemente de la duración.

Imagen ilustrativa generada por IA de un cable de red conectado a un conmutador, en primer plano lateral
Imagen ilustrativa generada por IA: entre el navegador y la aplicación pueden existir otros componentes de red.

Comprueba, en la configuración concreta, qué componente establece, transmite o modifica el encabezado y cómo gestiona las respuestas almacenadas en caché. A continuación, compara las solicitudes con el estado conocido de la caché, siempre que tu infraestructura lo permita. Las diferencias entre estas respuestas son indicios útiles, pero, sin conocer los límites de medición correspondientes, no constituyen una prueba de una causa concreta.

Registros, remolques y elección de herramientas

Server-Timing complementa otros métodos de diagnóstico, en lugar de sustituirlos. La elección adecuada depende de si deseas comprender una solicitud concreta del navegador, recopilar valores existentes mediante programación o analizar relaciones entre varios servicios. El siguiente resumen distingue la información que se obtiene de cada uno de ellos de sus requisitos y limitaciones.

Comparación de métodos de diagnóstico para respuestas HTTP
HerramientaConclusiónRequisito previoFrontera
DevToolsComprobar las solicitudes individuales y los horarios comunicadosConsulta del navegador con métricas adecuadasNo se realiza un análisis automático de las causas
API de rendimientoLeer los valores de sincronización existentes mediante JavaScriptEntrada correspondiente y, en su caso, autorización de OriginNo existe un proceso completo que abarque todos los servicios
Registros del servidorAnalizar los tiempos registrados en el servidorFormato de registro adecuado y acceso a los registrosEs necesario comprobar los límites de medición y las unidades
Rastreo distribuidoAnalizar las relaciones entre los servicios implicadosInstrumentación y asignación de las trazasCostes adicionales de funcionamiento e instrumentación

En el caso de un indicador que no se conoce hasta que se ha completado la respuesta, puede ser más adecuado utilizar una entrada de registro que un encabezado de respuesta habitual. NGINX, por ejemplo, registra request_time y upstream_response_time en segundos con una resolución de milisegundos. Por el contrario, Server-Timing utiliza milisegundos: hay que multiplicar el valor en segundos por 1.000. Antes de realizar una comparación, comprueba además cuándo comienza y termina cada medición.

En Transmisión Es posible que, al enviar encabezados normales, aún no se haya determinado la duración total del cuerpo de la respuesta. La especificación permite el uso de «server-timing» también como «HTTP-Trailer». Sin embargo, esta no es una solución universal: la API Fetch no permite acceder a los «trailers», y su visualización en las herramientas de desarrollo debe comprobarse por separado para cada navegador.

Para obtener comparaciones más fiables, repite consultas similares en condiciones documentadas: registra, por ejemplo, el punto final, el estado de la caché y los cambios relevantes en el sistema. Analiza varios valores en lugar de una sola solicitud y investiga más a fondo las diferencias llamativas mediante registros o trazas. De este modo, queda claro qué observación está realmente cubierta por cada medición.

Un entorno de pruebas basado en navegador puede resultar útil a la hora de probar la configuración de las aplicaciones, pero no reproduce automáticamente las rutas de red ni los servicios de servidor que se utilizarán en el futuro. Esto también se aplica a WordPress Playground en el navegador. Además, comprueba las especificaciones relativas a una configuración concreta de alojamiento y backend en un entorno lo más parecido posible al de producción.

Fuentes y estado actual de los conocimientos

Estado de la investigación:

Fecha de la investigación: 13 de noviembre de 2026. La visualización en el navegador y la compatibilidad con determinadas funciones pueden variar; los ejemplos no incluyen mediciones propias.

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/

Artículos de actualidad