Server-Timing

Die Syntax des Server-Timing-Headers ermöglicht es Ihnen, Metriken auf verschiedene Arten zu kommunizieren: nur der Servermetriken-Name, Metriken mit Wert, Metriken mit Wert und Beschreibung sowie Metriken mit Beschreibung.

Dieser Header kann eine oder mehrere Metriken enthalten, die durch Kommas getrennt sind. Jede Metrik hat einen Namen, eine optionale Dauer und eine optionale Beschreibung. Diese Komponenten werden durch Semikolons getrennt.

Die Komponente für die Dauer besteht aus dem String "dur", gefolgt von "=", gefolgt vom Wert, wie "dur=23.2". Die Komponente für die Beschreibung besteht aus dem String "desc", gefolgt von "=", gefolgt vom Wert, wie "desc=DB lookup".

Die Spezifikation empfiehlt, dass Namen und Beschreibungen so kurz wie möglich gehalten werden sollten (verwenden Sie Abkürzungen und lassen Sie optionale Werte nach Möglichkeit weg), um den HTTP-Overhead zu minimieren.

// Single metric without value
Server-Timing: missedCache

// Single metric with value
Server-Timing: cpu;dur=2.4

// Single metric with description and value
Server-Timing: cache;desc="Cache Read";dur=23.2

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

// Server-Timing as trailer
Trailer: Server-Timing
--- response body ---
Server-Timing: total;dur=123.4

Der Server-Timing-Header kann potenziell sensible Anwendungs- und Infrastrukturdaten preisgeben. Überlegen Sie, welche Metriken wann und an wen auf Serverseite zurückgegeben werden. Zum Beispiel könnten Sie Metriken nur authentifizierten Benutzern anzeigen und der Öffentlichkeit nichts zeigen.

Zusätzlich zur Darstellung von Server-Timing-Header-Metriken in den Entwicklerwerkzeugen des Browsers ermöglicht die PerformanceServerTiming-Schnittstelle Werkzeugen, Metriken automatisch aus JavaScript zu sammeln und zu verarbeiten. Diese Schnittstelle ist auf denselben Ursprung beschränkt, Sie können jedoch den Timing-Allow-Origin-Header verwenden, um die Domänen anzugeben, die auf die Servermetriken zugreifen dürfen. Die Schnittstelle ist nur in sicheren Kontexten (HTTPS) in einigen Browsern verfügbar.

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

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

• PerformanceServerTiming