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 den folgenden, durch Semikolons getrennten Komponenten:

<name>

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

<duration> Optional

Eine Dauer als der String dur, gefolgt von =, gefolgt von einem Wert, wie dur=23.2.

<description> Optional

Eine Beschreibung als der String desc, gefolgt von =, gefolgt von einem Wert als Token oder einem in Anführungszeichen gesetzten 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-Daten-Overhead zu minimieren.

Der Server-Timing-Header kann potenziell sensible Informationen über Anwendung und Infrastruktur preisgeben. Entscheiden Sie, welche Metriken gesendet werden sollen, wann sie gesendet werden sollen und wer sie sehen soll, basierend auf dem Anwendungsfall. Zum Beispiel können Sie entscheiden, Metriken nur authentifizierten Benutzern und nichts bei öffentlichen Antworten zu zeigen.

Neben der Anzeige von Server-Timing-Header-Metriken in den Entwicklerwerkzeugen des Browsers ermöglicht die PerformanceServerTiming-Schnittstelle Werkzeugen das automatische Sammeln und Verarbeiten von Metriken aus JavaScript. Diese Schnittstelle ist auf den gleichen Ursprung beschränkt, aber Sie können den Timing-Allow-Origin-Header verwenden, um die Domänen anzugeben, die auf die Server-Metriken zugreifen dürfen. Die Schnittstelle ist nur in sicheren Kontexten (HTTPS) in einigen Browsern verfügbar.

Die Komponenten des Server-Timing-Headers werden wie folgt den PerformanceServerTiming-Eigenschaften zugeordnet:

• "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 anzuzeigen, dass ein Server-Timing-Header dem Antwortkörper folgt. Eine Metrik custom-metric mit einer Dauer von 123.4 Millisekunden wird gesendet.

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

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

• PerformanceServerTiming
• Trailer-Header