...

Server-Timingヘッダー:ブラウザにおけるバックエンドの実行時間を理解する

仝 Server-Timingヘッダー 自身で収集したバックエンドの指標をHTTPレスポンスで送信します。これらの指標は、ブラウザのDevToolsで各リクエストに紐付けて確認したり、Performance APIを介して読み取ったりできます。ただし、これにはアプリケーションまたはその他の応答を返すコンポーネントが、これらの値を収集して出力していることが前提となります。 このヘッダーは自動プロファイラではありません。事前に文書化された測定基準があって初めて、その所要時間がどのような処理を含んでいるかがわかります。処理の重複、ネットワーク経路、キャッシュ応答などが、解釈に影響を与える可能性があります。

サーバー・タイミングが明らかにすること

ページの読み込みが遅い場合、ブラウザ内、ネットワーク経路、あるいはサーバーでの処理のいずれかで時間が失われる可能性があります。その Server-Timingヘッダー これらの視点を結びつける:関与するサーバーコンポーネントが自ら収集した指標を、HTTPレスポンスとともに送信する。これにより、ブラウザはそれらを対応するリクエストに紐付けて表示することができる。

そのためには、例えばアプリケーションがデータベース操作の所要時間を計測し、その値をレスポンスヘッダーに書き込む必要があります。プロキシやその他のレスポンスを返すコンポーネントも、メトリクスを提供することができます。このような計測機能がない場合、ブラウザは後から個々のサーバー側の処理ステップにどれだけの時間がかかったかを特定することができません。

したがって、ヘッダーは 転送形式、自動プロファイラではありません。どの内部関数を調査するか、あるいはアプリケーションがどの程度の詳細さで測定を行うべきかを指定するものではありません。どの指標が表示されるかは、担当するコンポーネントが何を収集し、出力として公開するかによって決まります。

については バックエンドのパフォーマンス これは、自分で測定したセクションがブラウザのリクエストに関する情報のすぐ隣に表示されるため、役立ちます。高い数値は、まずはさらなる調査の糸口にはなりますが、ページが遅い理由を証明するものではありません。この指標だけでは、その原因も、ウェブパフォーマンスの他の要素もすべて説明できるわけではありません。

したがって、実際に利用するには、そのアプリケーション、あるいは結果に影響を与える可能性のある他のコンポーネントへのアクセス権が必要となります。一方、メトリクスがすでに提供されている場合は、サーバーの設定を変更することなく、ブラウザ上でそれらを確認することができます。その場合でも、値の出典や、実際に何が含まれているのかを明確にしておく必要があります。

メトリクスとヘッダー構文を理解する

HTTPレスポンスには、1つまたは複数の「Server-Timing」ヘッダー行が含まれることがあります。1行内では、各メトリクスはコンマで区切られ、各パラメータはセミコロンで始まります。各メトリクスには名前が必要ですが、期間と説明は任意です。報告される期間は、パラメータ dur また、ミリ秒単位で表されます。

以下の例は、2つのメトリクスを含むHTTPレスポンスヘッダー行を示しています。数値は任意に設定されたものであり、実際の測定値ではありません。この行はあくまで構文の例であり、特定のアプリケーションやサーバー構成を前提としたものではありません。

コード
Server-Timing: db;dur=42.5;desc="Datenbank", render;dur=18.0

ここでは、 db 期間と説明を含むメトリクス; render 期間はあるが、説明はない。以下の情報によると desc これらは説明を目的としています。これらは、各測定の開始時刻および終了時刻に関する記録に代わるものではありません。

サーバー・タイミング指標の構成要素
構成要素意味義務ステータス例
名称このメトリクスを指す必須db
dur所要時間(ミリ秒)オプションdur=42.5
desc指標の説明オプションdesc="データベース"

「~のような」という名前 db それ自体では、 測定範囲 測定方法についても同様である。それは、単一のクエリ、複数のクエリの合計、あるいは別の方法で定義されたデータベースのセクションを指す可能性がある。計測方法に関するドキュメントがあって初めて、その値に実際にどのような作業が含まれているのかが理解できる。

したがって、有意義な比較を行うためには、各メトリクスについて開始点と終了点を記録し、そこにさらなる部分操作が含まれているかどうかを記述する必要があります。例えば、名称は変わらないものの、後でアプリケーションが追加のクエリを計算時間に含めるようになった場合、新旧の値をそのまま比較することはできません。 構文だけでは、そのような変更は示されません。

バックエンド処理時間とブラウザの待機時間を区別する

ブラウザに表示される待機時間と、報告されるバックエンド処理時間は、必ずしも同じ時間間隔を表すとは限りません。 あるメトリクスは、意図的に選択された処理の一部のみを計測している可能性がある一方で、ブラウザの表示にはリクエストとレスポンスの経路の他の部分も反映されている場合があります。したがって、数値が類似していても異なっていても、必ずしも両方の測定結果が互いに裏付け合っている、あるいは矛盾しているとは限りません。

ブラウザとアプリケーションの間には、ネットワーク経路やプロキシなどが介在している場合があります。また、バックエンド内のキューや処理ステップも、設定された測定ポイントの範囲外となる可能性があります。そのため、ブラウザの待機時間が報告されたデータベース操作の所要時間よりも長かった場合、その差をこの指標だけに基づいて特定の原因に帰属させることはできません。

逆に、サーバー・タイミング・メトリクスは 重なる あるいは、互いにネストされている場合もあります。データベース操作を含むリクエストの処理時間を測定する総合メトリクスがある場合、その所要時間はすでに総合値に含まれています。両方の数値を足し合わせると、このセクションが二重にカウントされてしまいます。また、並列で実行される操作の場合、個々の所要時間の合計が経過時間よりも長くなることもあります。

したがって、ヘッダーは自動的に完全な 滝 処理について。この資料には指定された指標が記載されているが、名称や期間だけでは、時系列や各セクション間の関係は特定できない。解釈にあたっては、計測対象が個別の作業、入れ子状の作業、あるいは同時に実行される作業のいずれかを記録しているかを把握する必要がある。

最適化策を導き出す前に、対象となるクエリの測定範囲と条件を明確にしておきましょう。その後、同様のクエリを繰り返し実行し、同じ条件下で同じパターンが現れるかどうかを確認します。そうすることで、指標だけに基づいて原因を断定することなく、単発の異常値と繰り返し現れる傾向を明確に区別することができます。

DevToolsでHTMLのレスポンスを確認する

動的なHTMLページの場合、アプリケーションは2つの別々の処理ステップ(データベース操作と、それに続くHTMLの生成)を記録できます。測定は、アプリケーションまたはその他の応答を返すコンポーネントで設定する必要があります。DevToolsは返された値を表示しますが、内部の実行時間は独自に測定しません。

について定義する db 特定のデータベース操作が呼び出される直前の時点を「開始」とし、その結果がアプリケーションで取得された時点を「終了」とする。 render この時間は、HTMLの生成直前から始まり、応答用のHTMLが完成して利用可能になった時点で終了します。例えば、テンプレートの読み込みがこの期間に含まれるかどうかを明記してください。

仮に、応答ヘッダーを送信する前に両方のステップが完了しているとすると、その場合、応答は Server-Timing: db;dur=42.5, render;dur=18.0 が含まれている。これらの数値は任意に設定されたものであり、測定値ではない。記録された開始点と終了点があって初めて、後日の分析において有意義な比較が可能となる。

Chromeで開発者ツールを開き、「ネットワーク」タブを選択します。ページを再読み込みし、リクエスト一覧から「ドキュメントリクエスト」を選択して、「ヘッダー」セクションで受信した生のヘッダーを確認してください。 「Timing」では、報告されたサーバータイミング値の表示を確認できます。具体的な表示形式はブラウザによって異なる場合があります。

目を引く 個々の価値 これは手がかりであり、一般的な原因を証明するものではありません。同様のリクエストを繰り返して実行し、アクセスしたページ、キャッシュの状態、アプリケーションへの変更点などを記録しておきましょう。そうすることで、パターンが繰り返されているのか、それとも個別のレスポンスが例外的なものなのかを、より的確に把握できるようになります。

重複カウントなしでAPIのアクセス時間を読み取る

API では、アプリケーションは処理全体だけでなく、外部サービスからの応答を待つ時間も捕捉することができます。その際、重要なのは 測定限界: 総時間がAPIハンドラの呼び出し開始時に始まり、その応答が出力可能になった時点で終了する場合、外部からの呼び出しは完全にその中に含まれることになる。

以下の任意の例では、外部処理時間はサービスへのリクエスト送信の直前に始まり、アプリケーションでその応答が受信された時点で終了します。これらの値はあくまで計算用のものであり、実際の測定値ではありません。この表は、2つの独立した作業パッケージではなく、明確にネストされた時間枠を表しています。

ネストされたAPIメトリクスの例(任意に選んだもの)
指標例における測定範囲期間
全体的な処理応答が準備できるまでハンドラーに入る120ミリ秒
外部呼び出し問い合わせの送信から、サービス側からの回答が届くまで80ミリ秒

120 ms に 80 ms を足すと確かに 200 ms になりますが、ここでは ダブルカウント: 80 msはすでに120 msの範囲内に収まっている。計算上、外部呼び出し以外の範囲には40 msが残っている。しかし、ヘッダーだけでは、この残りの期間にどのような処理や待機時間が含まれているのかは説明できない。

大きな円の中に小さな円が描かれた、入れ子状になったAPIの時間を象徴するAI生成のイラスト
AI生成のイラスト:外部呼び出しにかかる時間は、すでに全体の処理時間に含まれている場合があります。

並列の依存関係であっても、単に経過した合計時間を足し合わせることはできません。 たとえば、2つの呼び出しが同時に実行され、それぞれ80 msかかるとすると、その個々の所要時間の合計は160 msになりますが、それらの時間範囲は大部分が重複している可能性があります。開始時刻と終了時刻に関する情報がない限り、所要時間だけからは実際の重複度を特定することはできません。

どのサービスがどの次の呼び出しをトリガーしたかという点について、分散トレースはヘッダー値に情報を追加します。サーバータイミングは、選択された所要時間をブラウザの応答に関連付けることはできますが、それ自体ではサービス間の完全な因果関係を記述するものではありません。 比較を行う際は、トレースとヘッダーが同じ操作や境界を指していることを確認してください。

JavaScript によるサーバータイミングの読み取り

仝 パフォーマンスAPI 既存のサーバー・タイミング・データをプログラムからも利用できるようにします。ナビゲーション・エントリは、現在のドキュメントの読み込み状況を記述しており、そのプロパティ serverTiming そこには、その目的で利用可能な報告済みメトリクスが含まれています。これは、後読み込みされたリソースやAPI呼び出しのエントリとは異なる選択です。

調査対象のページのブラウザコンソールで、以下のJavaScriptを実行してください。このコードは、存在するナビゲーション項目の中から最初のものを選択し、そのサーバータイミングリストを表形式で出力します。このコードは、すでに存在する値を読み取るだけであり、サーバーの設定を変更したり、負荷テストを実行したりすることはありません。

コード
const navigation = performance.getEntriesByType("navigation")[0];
console.table(navigation?.serverTiming ?? []);

ナビゲーションエントリが存在しない場合、またはそこから取得可能なメトリクスが提供されない場合、この例では空のリストが表示されます。しかし、それだけでそのページが高速であるとか低速であるとか、あるいはサーバーに計測機能が備わっていないとは限りません。まずはレスポンスヘッダーを確認し、選択したエントリが実際に目的のリクエストを表しているかどうかを確認してください。

再読み込みされたリソースの場合は、代わりに適切な リソースエントリ. タイプが resource その名前から、探しているリクエストを特定し、その serverTiming-プロパティを確認する。同じアドレスを繰り返し呼び出す場合は、具体的にどのエントリを比較しているかに注意する必要がある。

オリジンをまたがるリソースの場合、Timing-Allow-Origin による適切な許可設定も、Performance API が時間情報を提供するかどうかに影響します。また、ブラウザの対応状況や実行環境によっても出力結果が左右される可能性があります。そのため、アプリケーションに変更を加える前に、空のリストと生のヘッダーを比較してください。

Originの共有設定と機密情報

Performance API 経由でアクセスする場合、呼び出し元のページのオリジンが重要となります。リソースが別のオリジンに由来する場合、そのレスポンスは Timing-Allow-Origin 呼び出し元のオリジンを適切に許可し、JavaScriptがサーバータイミングを含む適切なタイミング情報を読み取れるようにする必要があります。CORSによる許可だけでは、この追加の許可を代替することはできません。

A 具体的な起源 指定された送信元にのみ公開を制限します。プレースホルダー * 一方、原則としてすべてのオリジンが、Performance API を通じて当該のタイミング情報を参照できるようにしています。したがって、既知のアプリケーションが1つだけその値を必要とする場合は、より制限の厳しいアクセス許可を選択し、実際に返されたリソースレスポンスで値を確認してください。

Originヘッダーを公開しても、レスポンスヘッダーの機密性は保たれません。HTTPレスポンス自体を受け取った者は、原則としてその内容を調査することができます。したがって、メトリクスの名前や説明文には、アクセス情報や個人情報、内部ホスト名を記載しないでください。 また、きめ細かな実行時間データからも内部の処理プロセスが推測される可能性があります。その有用性とリスクを十分に検討した上で、適切な値のみを公開するようにしてください。

また、アプリケーションが対応すべきブラウザでも評価結果を確認してください。個々の詳細機能やセキュアコンテキストに関する要件は、ブラウザによって異なる場合があります。回答の一般的なセキュリティ確保のためには、さらに Webサーバーに適したセキュリティヘッダー 関連性はあるが、タイミングの承認に関する審査や、どの測定値を公開してよいかという決定に代わるものではない。

欠落値とキャッシュの影響を確認する

サーバータイミング値のリストが空の場合は、DevToolsのネットワークセクションで具体的なリクエストから確認してください。「ヘッダー」で、返ってきたレスポンスにそもそも Server-Timing-ヘッダーが含まれているか、またそこにどのような名前が記載されているか。もしそれが欠落している場合は、空のリストから速度を推測するのではなく、計測設定や、中間コンポーネントによる変更の可能性を調査してください。

Rohheader が存在する場合は、次に パフォーマンスのエントリ: ナビゲーションエントリはドキュメントの読み込みについて記述していますが、API呼び出しやその他のリソースについては、対応するリソースエントリが必要となります。また、クロスオリジンリソースについては、以下の条件による許可も確認する必要があります。 Timing-Allow-Origin また、使用しているブラウザでの対応状況も確認してください。リストが空であることは、それ自体では計測機能の欠如や、応答が速いか遅いかを示すものではありません。

既存の値であっても、文脈が必要です。CDN やプロキシが独自のメトリクスを提供する場合もありますし、同時に、ヘッダーを含むレスポンスがキャッシュから取得されることもあります。その場合、以前に生成されたオリジン・メトリクスは、必ずしも現在のリクエストに対するオリジン・サーバーの処理状況を反映しているとは限りません。したがって、以下を文書化してください。 キャッシュの状態と出典 期間とは別に。

スイッチに接続されたネットワークケーブルの横からのクローズアップをAIが生成したイメージ画像
AI生成のイメージ図:ブラウザとアプリケーションの間には、さらに他のネットワークコンポーネントが存在する場合があります。

具体的な構成を確認し、どのコンポーネントがヘッダーを設定・転送・変更しているか、またキャッシュされたレスポンスをどのように処理しているかを調べます。 その後、インフラストラクチャが許す範囲で、既知のキャッシュ状態を持つリクエストを比較してください。これらのレスポンス間の相違点は有用な手がかりとなりますが、それぞれの測定限界を把握していない限り、特定の原因を証明するものではありません。

ログ、予告編、ツールの選択

Server-Timingは、他の診断手法に取って代わるのではなく、それらを補完するものです。どの手法を選ぶべきかは、個々のブラウザリクエストを理解したいのか、既存の値をプログラムで取得したいのか、あるいは複数のサービスにまたがる関連性を調査したいのかによって異なります。以下の概要では、各手法から得られる知見と、その前提条件や限界を分けて説明しています。

HTTPレスポンスの診断手順の比較
工具知見前提条件国境
デブツールズ個別の問い合わせと報告された時間を確認する適切な指標を含むブラウザリクエスト原因の自動分析は行われない
パフォーマンスAPIJavaScript を使用して既存のタイミング値を読み取る適切なエントリおよび必要に応じてOriginの承認部門横断的な完全なプロセスではない
サーバーログサーバー側で記録された時刻を分析する適切なログ形式とログへのアクセス測定範囲と単位を確認する必要がある
分散型トレース関連するサービス間の関連性を調査するトレースの計測と割り当て追加の運用および計装にかかる負担

応答が完了して初めて確定する指標については、通常の応答ヘッダーよりもログエントリの方が適している場合があります。たとえば、NGINX は次のようにログを記録します。 request_time そして upstream_response_time 秒単位で、ミリ秒単位の精度で測定されます。一方、サーバータイミングではミリ秒単位が使用されるため、秒単位の値は1,000倍する必要があります。比較を行う前に、各測定の開始時刻と終了時刻も確認してください。

時点では ストリーミング 通常のヘッダーを送信する際、レスポンスボディの総長がまだ確定していない場合があります。仕様では、サーバータイミングをHTTPトレーラーとして使用することも許可されています。しかし、これは万能な解決策ではありません。Fetch APIではトレーラーにアクセスできず、開発者ツールでの表示については、各ブラウザごとに個別に確認する必要があります。

より信頼性の高い比較を行うためには、記録された条件下で同種のクエリを繰り返し実行してください。例えば、エンドポイント、キャッシュの状態、およびシステムへの関連する変更点を記録しておきます。 単一のリクエストではなく複数の値を比較対象とし、目立つ差異についてはログやトレースを用いてさらに調査してください。そうすることで、どの観測結果が実際にどの測定によって裏付けられているかが明確になります。

ブラウザベースのテスト環境は、アプリケーションの設定を試す際に役立ちますが、実際の運用時のネットワーク経路やサーバーサービスを自動的に再現するわけではありません。これは、 ブラウザ上のWordPress Playground. 具体的なホスティングおよびバックエンドの設定に関する記述については、可能な限り本番環境に近い環境で追加の検証を行ってください。

出典および専門的な見解

調査状況:

調査時点:2026年11月13日。ブラウザでの表示や各機能の対応状況は異なる場合があります。例には独自の測定結果は含まれていません。

https://www.w3.org/TR/server-timing/

https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming/serverTiming

https://developer.chrome.com/docs/devtools/network?hl=en

https://developer.chrome.com/docs/devtools/performance/reference/

https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Timing-Allow-Origin

https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Server-Timing

https://docs.nginx.com/nginx/admin-guide/monitoring/logging/

現在の記事

AIが生成した回答用紙のイラスト。側面にはタブがあり、付属の指標を示す幾何学的なマークが記載されている。
Pleskウェブサーバ

Server-Timingヘッダー:ブラウザにおけるバックエンドの実行時間を理解する

「Server-Timing」ヘッダーは、独自に収集したバックエンドのメトリクスをブラウザのDevToolsに反映させます。測定範囲の確認方法、JavaScriptによる値の取得方法、そしてキャッシュやオリジンの影響を正しく把握する方法について学びましょう。

暗い背景の上に、重なり合い、入り組んだ測定間隔を描いたAI生成のイラスト
管理

ネットワークやフロントエンドとは別にPHPの実行時間を測定する

PHPのタイマー、ブラウザのタイミング、サーバーのタイミングは、リクエストの異なる段階を示します。これらを比較することで、その境界を把握し、データベース、ネットワーク、フロントエンドを的確に特定することができます。

3つの測定点を示した地球のイラスト(AI生成)と、繰り返し検査の結果
管理

Synthetic Monitoring:複数の地域における読み込み時間を自動測定

Synthetic Monitoringは、選択した地域から定期的にウェブサイトを監視します。これにより、比較可能なチェックを計画し、読み込み時間の指標を区別し、個々の測定結果を過度に解釈することなく、地域ごとの問題を特定することができます。