Синтаксис заголовка Server-Timing позволяет передавать метрики различными способами: только имя метрики сервера, метрика со значением, метрика со значением и описанием, метрика с описанием.

Спецификация рекомендует, чтобы имена и описания были максимально короткими (использовать аббревиатуры и опускать необязательные значения, где возможно), чтобы минимизировать издержки HTTP.

// 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

Заголовок Server-Timing может раскрывать потенциально конфиденциальную информацию об приложении и инфраструктуре. Следует контролировать, какие метрики возвращаются, когда и кому на стороне сервера. Например, метрики могут отображаться только авторизованным пользователям, а не всем.

Помимо отображения метрик заголовка Server-Timing в инструментах разработчика браузера, интерфейс PerformanceServerTiming позволяет инструментам автоматически собирать и обрабатывать метрики из JavaScript. Этот интерфейс ограничен одной областью происхождения, но вы можете использовать заголовок Timing-Allow-Origin, чтобы указать домены, которым разрешено получать доступ к метрикам сервера. В некоторых браузерах интерфейс доступен только в защищенных контекстах (HTTPS).

• PerformanceServerTiming