Core Web VitalsのTTFBの内訳をServer-Timingで見る方法

​​Core Web Vitals​Chrome,Node.js,Playwright,Server-Timing,web-vitals

HTML の応答に Server-Timing ヘッダーを付けて、データベースの処理やテンプレートの組み立てにかかった時間を書いておくと、ブラウザーの PerformanceNavigationTiming の serverTiming から、その値を読めます。web-vitals の onTTFB で測った TTFB と並べると、TTFB のどこまでがサーバーの処理で、どこからがそれ以外なのかが分かります。検証したページでは、TTFB 384ms のうち 301ms が、データベースの処理(db)でした。

PageSpeed Insights の TTFB や、Lighthouse の「Reduce server response times (TTFB)」で、サーバーの応答が遅いと言われたときに使えます。サーバーのどの処理が遅いのかを、利用者のブラウザーで測った TTFB と一緒に記録できます。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、web-vitals 6.2.3 です。ブラウザーは、Playwright に入っている Chrome for Testing 153 を使いました。サーバーは Node.js の http モジュールで書き、データベースの処理などは setTimeout で待つだけの模擬です。サーバーとブラウザーは同じ VM の中で動かしました。実際のデータベースやフレームワーク、CDN、Firefox と Safari、Chrome DevTools の画面、利用者のデータ(フィールドデータ)では試していません。

TTFB と、Server-Timing が受け持つ範囲

web.dev の TTFB の解説によると、TTFB はリダイレクト、Service Worker の起動、DNS の名前解決、接続と TLS のやり取り、そしてリクエストを送ってから応答の最初の1バイトが届くまでの時間を足したものです。目安は 0.8秒以下で、1.8秒を超えると遅いとされます。TTFB そのものは Core Web Vitals の指標ではありませんが、FCP や LCP は TTFB のあとに来るので、TTFB が遅れると FCP や LCP も遅れます。

最後の「リクエストから最初の1バイトまで」には、サーバーの処理とネットワークの時間がまとめて入っています。ブラウザーの側からは、この2つを分けられません。そこで、サーバーが自分で測った時間を Server-Timing ヘッダーで知らせます。

サーバーで処理ごとの時間を測ってヘッダーに書く

MDN の Server-Timing の説明にあるとおり、1つの値は名前と、省略できる dur(ミリ秒)と desc(説明)でできていて、カンマで区切って並べます。

検証用のサーバーでは、処理を timed という関数で包み、かかった時間をヘッダーの値にしました。データベースは 300ms、テンプレートの組み立ては 60ms 待つだけの模擬です。

js
async function timed(list, name, desc, fn) {
  const t = performance.now();
  const v = await fn();
  list.push(`${name};dur=${(performance.now() - t).toFixed(1)}${desc ? `;desc="${desc}"` : ''}`);
  return v;
}

const st = [];
const start = performance.now();
await timed(st, 'auth', 'session', () => sleep(20));
await timed(st, 'db', 'article query', () => sleep(300));
const html = await timed(st, 'render', 'html', async () => { await sleep(60); return page('記事ページ'); });
st.push(`total;dur=${(performance.now() - start).toFixed(1)}`);
res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'server-timing': st.join(', ') });
res.end(html);

curl で応答のヘッダーを見ると、次のようになりました(date などの行は省きました)。

text
$ curl -s -D - -o /dev/null http://localhost:8080/
HTTP/1.1 200 OK
content-type: text/html; charset=utf-8
cache-control: no-store
server-timing: auth;dur=20.4;desc="session", db;dur=301.3;desc="article query", render;dur=60.9;desc="html", total;dur=382.7
Transfer-Encoding: chunked

最初は desc に「セッション確認」のような日本語を入れましたが、Node.js が TypeError [ERR_INVALID_CHAR]: Invalid character in header content ["server-timing"] を出して止まりました。Node.js の http モジュールでは、ヘッダーの値に日本語を入れられないので、desc は ASCII の文字(英数字や空白など)で書きます。

ブラウザーで serverTiming と TTFB を並べる

ブラウザーでは、performance.getEntriesByType('navigation')[0].serverTiming が、ヘッダーの値を name、duration、description を持つオブジェクトの配列にして返します。web-vitals の attribution 版の onTTFB では、attribution.navigationEntry に今のページの navigation のエントリーが入っていて、型定義の説明にあるとおり、navigationEntry?.serverTiming からも読めます。

Playwright でページを5回ずつ開き、onTTFB の値と serverTiming を記録しました。requestDuration は、web-vitals の TTFB の内訳のうち、リクエストを送ってから最初の1バイトが届くまでの時間です。

ページ TTFB requestDuration total auth db render
ふだん(db は 300ms) 384.4ms 382.9ms 381.6ms 20.4ms 300.8ms 60.4ms
db を 1200ms にした 1283.3ms 1282.4ms 1281.3ms 20.2ms 1200.6ms 60.3ms
キャッシュに当たり db を飛ばした 82.0ms 81.1ms 80.6ms 20.2ms なし 60.3ms

どれも5回の中央値です。同じ VM の中なので、表の3つのページでは、DNS の名前解決や接続の時間(dnsDuration、connectionDuration)はどの回も 1ms 未満で、TTFB のほとんどが requestDuration でした。その requestDuration と Server-Timing の total の差は、中央値で 1.4ms 以下です。TTFB の大半を db が占めていることが、この表から分かります。

キャッシュに当たったページでは、cache;desc="hit" のように dur を付けずに送りました。ブラウザーでは duration が 0 の値として読めました。

サーバーの外で使った時間は、差として出る

サーバーとブラウザーのあいだに、応答を 150ms 遅らせて渡す TCP の中継を置き、遠いサーバーの代わりにしました。同じ処理のページを5回ずつ開いた中央値です。

経路 TTFB requestDuration total requestDuration − total
サーバーに直接 383.2ms 381.9ms 381.1ms 0.8ms
150ms 遅らせる中継を通す 534.1ms 532.3ms 381.2ms 151.3ms

total はどちらも 381ms で、TTFB だけが 151ms 延びました。Server-Timing の値が変わらずに TTFB が延びているときは、サーバーの処理の外(ネットワークや、サーバーの手前にある中継)を調べます。

4つの場合の TTFB の内訳の積み上げ棒グラフ。ふだんは db が大半、db 1200ms では db がほぼ全部、キャッシュに当たると 82ms、中継を通すと total 381ms の外に約150ms がある
TTFB の内訳(5回の中央値)。灰色は Server-Timing の値に入らない時間で、中継の行は TTFB と total の中央値の差

なお、Chrome DevTools Protocol の Network.emulateNetworkConditions で latency を 150 にする方法も試しましたが、localhost のこのページでは TTFB が変わらなかったので、中継を使いました。

利用者のブラウザーで測った値を送る

web.dev の TTFB の改善方法の解説にあるとおり、Server-Timing を付けたページでは Navigation Timing の serverTiming に値が入るので、利用者のブラウザーでも読めます。検証では、その値を onTTFB の中で集め、navigator.sendBeacon で自分のサーバーに送りました。

html
<script src="/wv.js"></script>
<script>
webVitals.onTTFB(({ value, attribution }) => {
  const serverTiming = (attribution.navigationEntry?.serverTiming ?? [])
    .map(({ name, duration, description }) => ({ name, duration, description }));
  navigator.sendBeacon('/collect', JSON.stringify({
    ttfb: Math.round(value),
    requestDuration: Math.round(attribution.requestDuration),
    serverTiming,
  }));
});
</script>

/wv.js は、web-vitals の dist/web-vitals.attribution.iife.js を置いたものです。サーバーの /collect には、次の値が届きました。

text
collect {"ttfb":5,"requestDuration":3,"serverTiming":[{"name":"db","duration":300.5,"description":"article query"},{"name":"render","duration":60.2,"description":""}]}

このページはヘッダーに固定の値を書いただけなので、db が 300.5ms なのに TTFB は 5ms です。次の節で詳しく書きます。

読むときに気をつけること

Server-Timing の値には、サーバーが書いた数字がそのまま入ります。 固定で db;dur=120 を返すページでは、TTFB が 2.3ms でも db は 120 と読めました。処理全体を測った total のような値を1つ入れておくと、TTFB と比べて、おかしな値に気づけます。

同じ固定値のページでは Server-Timing ヘッダーを2行に分けて送りましたが、ブラウザーでは db、render、cdn-cache の3つが1つの配列にまとまって読めました。

画像や API など、ページと別のオリジンから読むリソースの serverTiming は、応答に Timing-Allow-Origin がないと空になります(MDN の serverTiming の説明)。localhost:8080 のページから 127.0.0.1:8081 のスクリプトを読んで確かめた結果です。

別オリジンの応答 serverTiming
Timing-Allow-Origin なし 空の配列
Timing-Allow-Origin: http://localhost:8080 db が 42ms(desc は api)
Timing-Allow-Origin: * db が 42ms(desc は api)

MDN の説明には、ブラウザーによっては HTTPS などの安全なコンテキストでしか読めない、とあります。検証環境の Chrome 153 では、localhost ではないアドレスに http でつないだページ(isSecureContext は false)でも、serverTiming を読めました。

注意

MDN は、Server-Timing がアプリケーションやインフラの内部の情報を見せてしまうことがあると注意しています。テーブル名や内部のサーバー名を name や desc に入れず、どの値を、誰に見せるかを決めてから付けます。

​Posted by 86