ウォームアップ要求を構成してパフォーマンスを改善する

ウォームアップ リクエストの目的は、新たに作成されたインスタンスにアプリのコードが読み込まれる過程でリクエストとレスポンスのレイテンシが生じないようにすることにあります。

App Engine は、作成されたばかりのインスタンスにアプリのコードを頻繁に読み込む必要があります。次の場合にインスタンスの読み込みが起こる可能性があります。

  • アプリの別のバージョンを再デプロイするとき。
  • リクエスト数が現在実行中のインスタンス セットの容量を超えたために、新しいインスタンスが作成されるとき。
  • 基盤となるインフラストラクチャや物理的なハードウェアのメンテナンスまたは修復が行われるとき。

アプリのコードを新しいインスタンスに読み込むと、読み込みリクエストが発生することがあります。読み込みリクエストのために、ユーザーのリクエスト レイテンシが増加する可能性がありますが、ウォームアップ リクエストを使用することによりこのレイテンシを回避できます。ウォームアップ リクエストは、実際のリクエストがインスタンスに到達するよりも先にアプリのコードを新しいインスタンスに読み込みます。

アプリケーションでウォームアップ リクエストが有効になっていると、App Engine は新しいインスタンスがアプリケーションで必要になるタイミングを検知し、ウォームアップ リクエストを開始して新しいインスタンスを初期化しようとします。しかし、この検知がいつもうまくいくとは限りません。アプリでウォームアップ リクエストが有効になっていても読み込みリクエストが発生するケースがあります。たとえば、アプリが通信を行っていない場合、このアプリに対する最初のリクエストは必ず読み込みリクエストであり、ウォームアップ リクエストではありません。

App Engine アプリケーションに対する他のリクエストと同様に、ウォームアップ リクエストもインスタンス時間を消費します。ウォームアップ リクエストが有効になっていると、多くの場合、インスタンス時間が増えることに気づかないものです。アプリケーションはウォームアップ リクエストを開始するだけで、読み込みリクエストを開始しないからです。しかし、ウォームアップ リクエストの途中で事前キャッシュ(pre-caching)など、別の処理も行うならインスタンス時間の消費量が増える可能性はあります。また、アイドル インスタンス数を最小に設定するとインスタンスの最初の開始時にウォームアップ リクエストが生じることも考えられますが、その後はインスタンスが引き続き利用できます。

ウォームアップ要求を有効にする

ウォームアップ リクエストは App Engine スケジューラによって使用されます。このスケジューラはユーザーが指定した構成に基づいてインスタンスの自動スケーリングを制御します。ウォームアップ リクエストを有効にすると、App Engine は GET/_ah/warmup リクエストを送信します。このリクエストのハンドラを実装すると、アプリケーション固有のタスク(アプリケーション データの事前キャッシュなど)を実行できます。

より多くのインスタンスが必要であると判断すると、スケジューラはインスタンスを起動します。ウォームアップ リクエストは、スケジューラがインスタンスの起動に使うため、有効になっていなくてもログに表示されることがあります。

ウォームアップ リクエストは必ず呼び出されるとは限りません。代わりに読み込みリクエストが送信されることがあります。たとえば、インスタンスが初めて起動されるインスタンスである場合や、トラフィックが急激に上昇する場合です。ただし、ウォームアップ リクエストが有効になっている場合、すでにウォームアップされているインスタンスにリクエストを送信する「ベスト エフォート型」のリクエストが試されます。

ウォームアップ リクエストが有効になっている場合、さらに多くのインスタンスが必要であると判断すると、スケジューラはインスタンスを起動します。ウォームアップ リクエストは、スケジューラがインスタンスの起動に使うため、有効になっていなくてもログに表示されることがあります。

ウォームアップ リクエストを有効にするには、app.yaml ファイルの inbound_services ディレクティブの下に warmup 要素を追加します。次に例を示します。

inbound_services:
- warmup

ハンドラを登録する

ハンドラを登録するには、ウォームアップ要求を処理するためのスクリプトを app.yaml ファイルで定義します。次に例を示します。

inbound_services:
- warmup

handlers:
- url: /_ah/warmup
  script: warmup.php
  login: admin

この例では、/_ah/warmup リクエストパスに対するウォームアップ リクエストをリッスンするハンドラを warmup.php ファイルに登録しています。

ハンドラを作成する

/_ah/warmup リクエストパスに応答するためにマッピングするハンドラ内に、実行する必要がある任意のロジックをビルドします。次の例では、前述の例の上にビルドしています。

<?php
  // warmup.php
  // Handle your warmup logic in the PHP handler script as needed
  // for your app.
  echo "Warmup successful";
?>

次のステップ

上の例では、使用するフレームワークを準備しています。次に、ウォームアップ リクエストのハンドラにどのようなロジックを含めるか決定します。アプリケーションで使用する値を memcache に追加することが必要になる場合もあります。たとえば、サイトの話題の記事の最新リストをビルドして保存しておくケースがあります。ウォームアップでリストをビルドし、必要なデータを memcache に保存しておくと、ユーザーからのリクエストを受信した時点でアプリケーションには必要なデータがすべて用意されていることになり、データを作成するためにクエリを実行する必要はありません。この結果、迅速なレスポンスを実現できます。次に関連トピックを示します。

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

PHP の App Engine スタンダード環境