Server-Timing

/ A single metric
Server-Timing: <timing-metric>

/ Multiple metrics as a comma-separated list
Server-Timing: <timing-metric>, …, <timing-metricN>

Ein <timing-metric> hat einen Namen und kann eine optionale Dauer und eine optionale Beschreibung enthalten. Zum Beispiel:

/ A metric with a name only
Server-Timing: missedCache

/ A metric with a duration
Server-Timing: cpu;dur=2.4

/ A metric with a description and duration
Server-Timing: cache;desc="Cache Read";dur=23.2

/ Two metrics with duration values
Server-Timing: db;dur=53, app;dur=47.2

<timing-metric>

Eine durch Kommas getrennte Liste von einer oder mehreren Metriken mit folgenden, durch Semikolon getrennten Komponenten:

<name>

Ein Name-Token (keine Leerzeichen oder Sonderzeichen) für die Metrik, der implementierungsspezifisch oder vom Server definiert ist, wie cacheHit.

<duration> Optional

Eine Dauer als die Zeichenkette dur, gefolgt von =, gefolgt von einem Wert wie dur=23.2.

<description> Optional

Eine Beschreibung als die Zeichenkette desc, gefolgt von =, gefolgt von einem Wert als Token oder einem in Anführungszeichen stehenden String, wie desc=prod oder desc="DB lookup".

Namen und Beschreibungen sollten so kurz wie möglich gehalten werden (zum Beispiel Abkürzungen verwenden und optionale Werte weglassen), um den HTTP-Datenaufwand zu minimieren.

Der Server-Timing-Header kann potenziell sensible Anwendungs- und Infrastrukturinformationen preisgeben. Entscheiden Sie basierend auf dem Anwendungsfall, welche Metriken gesendet werden, wann sie gesendet werden und wer sie sehen soll. Zum Beispiel könnten Sie entscheiden, Metriken nur authentifizierten Nutzern anzuzeigen und nichts in öffentlichen Antworten preiszugeben.

Neben der Anzeige von Server-Timing-Header-Metriken in den Entwicklerwerkzeugen des Browsers ermöglicht die PerformanceServerTiming-Schnittstelle es Tools, Metriken automatisch von JavaScript zu sammeln und zu verarbeiten. Diese Schnittstelle ist auf denselben Ursprung beschränkt, aber Sie können den Timing-Allow-Origin-Header verwenden, um die Domänen zu spezifizieren, die Zugriff auf die Server-Metriken haben. Die Schnittstelle ist nur in sicheren Kontexten (HTTPS) in einigen Browsern verfügbar.

Die Komponenten des Server-Timing-Headers spiegeln sich in den PerformanceServerTiming-Eigenschaften wie folgt wider:

• "name" -> PerformanceServerTiming.name
• "dur" -> PerformanceServerTiming.duration
• "desc" -> PerformanceServerTiming.description

Die folgende Antwort enthält eine Metrik custom-metric mit einer Dauer von 123,45 Millisekunden und einer Beschreibung "My custom metric":

Server-Timing: custom-metric;dur=123.45;desc="My custom metric"

In der folgenden Antwort wird der Trailer-Header verwendet, um anzugeben, dass ein Server-Timing-Header nach dem Antwortkörper folgt. Es wird eine Metrik custom-metric mit einer Dauer von 123,4 Millisekunden gesendet.

HTTP/1.1 200 OK
Transfer-Encoding: chunked
Trailer: Server-Timing

--- response body ---
Server-Timing: custom-metric;dur=123.4

• PerformanceServerTiming
• Trailer-Header