HTTP Server-Timing Header

Der HTTP-Header Server-Timing ist ein Response-Header, der Performance-Metriken vom Server an den Client überträgt. Browser und Monitoring-Tools können diese Daten auswerten, um Backend-Operationen wie Datenbankabfragen, Cache-Zugriffe oder API-Aufrufe zu analysieren.

Typ

Response-Header

Syntax

Der Header listet benannte Metriken mit Dauer und optionaler Beschreibung.

http 
Server-Timing: db;dur=53.2, cache;dur=1.3
Server-Timing: api;dur=123.4;desc="External API call"

Direktiven

Die Direktiven definieren Performance-Metriken mit Namen, Dauer und Beschreibung.

name
Eindeutiger Name der Metrik ohne Leerzeichen, z.B. db, cache, api.
dur
Optionale Dauer in Millisekunden als Dezimalzahl mit Punkt als Trennzeichen.
desc
Optionale Beschreibung der Metrik in Anführungszeichen zur Erläuterung der Operation.

Beispiele

Nachfolgend finden Sie praktische Anwendungsbeispiele für den Server-Timing-Header.

Beispiel 1 Datenbank und Cache

http 
HTTP/1.1 200 OK
Server-Timing: db;dur=53.2, cache;dur=1.3, render;dur=12.8
Content-Type: application/json

{"products": [...]}

API-Response zeigt 53.2ms für Datenbankabfrage, 1.3ms für Cache-Lookup und 12.8ms für Template-Rendering.

Beispiel 2 Externe API mit Beschreibung

http 
HTTP/1.1 200 OK
Server-Timing: auth;dur=45.6;desc="OAuth token validation", api;dur=123.4;desc="External payment gateway"
Content-Type: application/json

{"order_id": "ORD-789"}

Payment-API dokumentiert 45.6ms für OAuth-Validierung und 123.4ms für externen Payment-Gateway-Aufruf.

Beispiel 3 Mehrere Backend-Komponenten

http 
HTTP/1.1 200 OK
Server-Timing: db;dur=28.1, redis;dur=2.4, s3;dur=67.3, total;dur=98.2
Content-Type: text/html

<!DOCTYPE html>...

Webserver zeigt detaillierte Aufschlüsselung: 28.1ms Datenbank, 2.4ms Redis-Cache, 67.3ms S3-Zugriff, 98.2ms Gesamtzeit.

Performance-Monitoring Flow

Server-Timing Performance-Monitoring Ablauf

Vorteile für die Systemarchitektur

  • Performance-Transparenz: Entwickler erkennen Backend-Engpässe direkt im Browser-Developer-Tools
  • Distributed Tracing: Metriken können mit Frontend-Performance-Daten korreliert werden
  • Produktions-Monitoring: Real-User-Monitoring erfasst serverseitige Performance-Probleme

Spezifikation

W3C Server Timing Specification https://www.w3.org/TR/server-timing/

Weitere Spezifikationen

Timing-Allow-Origin Header, Priority Header