ウォームアップ リクエストを構成してパフォーマンスを改善する

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

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

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

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

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

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

ウォームアップ リクエストを有効化する

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

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

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

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

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

inbound_services:
- warmup

ハンドラを作成する

/_ah/warmup に送信されるリクエストを処理するハンドラを作成します。アプリで必要とされている任意のウォームアップ ロジックをハンドラで遂行してください。

たとえば、Express.js を使用している場合、ハンドラは次のようになります。

js
const express = require('express');
const app = express();

app.get('/_ah/warmup', (req, res) => {
    // Handle your warmup logic. Initiate db connection, etc.
});

// Rest of your application handlers.
app.get('/', handler);
app.listen(8080);

次のステップ

上の例では、使用するフレームワークを準備しています。次に、ウォームアップ リクエストのハンドラにどのようなロジックを含めるを決定します。

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

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

Node.js 用 App Engine スタンダード環境に関するドキュメント