Function Compute:関数インスタンスのヘルスチェックポリシーの設定

制限事項

web機能インスタンスのみがヘルスチェック機能をサポートしています。

ヘルスチェックの動作

インスタンススタートアップ

[成功検出のしきい値] および [最大障害] パラメーターの設定方法の詳細については、「Function Computeコンソールでヘルスチェックポリシーを設定する」をご参照ください。

シングルヘルスチェック

インスタンスがヘルスチェックに失敗した後の割り当て

ヘルスチェックポリシーの設定

このセクションでは、Function Computeコンソールでヘルスチェックポリシーを設定する方法について説明します。 Web functionを選択して作成され、RuntimeがNode.js 18の関数を例として使用します。

ステップ1: 関数を作成する

1. Function Computeコンソールにログインします。 左側のナビゲーションウィンドウで、[関数] をクリックします。

2. 上部のナビゲーションバーで、リージョンを選択します。 [関数] ページで、[関数の作成] をクリックします。

3. 関数の作成ページで、関数を作成する方法を選択し、次のパラメーターを設定し、作成をクリックします。

   この例では、Web Functionメソッドが選択されています。 次の表に、設定する必要があるパラメーターを示します。 他のパラメーターのデフォルト値を保持します。

   パラメーター	説明
   関数名	関数の名前を入力します。
   ランタイム	関数のランタイムを指定します。 この例では、Node.js 18が選択されています。

4. 関数設定ページで、[コード] タブをクリックします。 コードエディターで、関数のコードを編集します。 次に、コードをデプロイして関数を実行します。

   次の例では、のサンプルコードを示します。

   'use strict';
   
   // Constants
   const PORT = 9000;
   const HOST = '0.0.0.0';
   const REQUEST_ID_HEADER = 'x-fc-request-id'
   
   const express = require('express');
   const bodyParser = require('body-parser');
   const app = express();
   
   app.use(bodyParser.urlencoded({ extended: true }));
   app.use(bodyParser.json());
   app.use(bodyParser.raw());
   
   app.get('/readyz', (req, res) => {
     console.log(`receive health check`);
     res.status(200);
     console.log(`i am ready`);
     res.send('i am ready\n');
   });
   
   // invocation
   app.post('/invoke', (req, res) => {
     var rid = req.headers[REQUEST_ID_HEADER]
     console.log(`FC Invoke Start RequestId: ${rid}`)
     res.send('OK');
     console.log(`FC Invoke End RequestId: ${rid}`)
   });
   
   var server = app.listen(PORT, HOST);
   console.log(`Running on http://${HOST}:${PORT}`);
   
   server.timeout = 0; // never timeout
   server.keepAliveTimeout = 0; // keepalive, never timeout

   上記のコードでは、readyzは定義されたヘルスチェックポリシーのハンドラーで、/readyzパスでHTTP GETリクエストを処理するために使用されます。 ステップ2: 関数インスタンスのヘルスチェックポリシーの設定を完了した後、ヘルスチェックが定期的に実行されるように、このハンドラーを定期的に実行するように指定できます。

   Function Computeは、関数インスタンスが異常であると判断した場合、別の関数インスタンスの割り当てを試みます。 Function Computeが別のインスタンスの割り当てに失敗した場合、ヘルスチェックエラーが返されます。

手順2: 関数インスタンスのヘルスチェックポリシーの設定

1. Function Computeコンソールにログインします。 左側のナビゲーションウィンドウで、[関数] をクリックします。

2. 上部のナビゲーションバーで、リージョンを選択します。 [関数] ページで、管理する関数をクリックします。

3. 関数の詳細ページで、設定タブをクリックします。

4. 左側のナビゲーションウィンドウで、[ヘルスチェック] タブをクリックし、[変更] をクリックします。 [ヘルスチェック] ページで、ビジネス要件に基づいてパラメーターを設定し、[OK] をクリックします。 下表にパラメーターを示します。

   パラメーター	説明
   ヘルスチェック	ヘルスチェック機能を有効にするかどうかを指定します。 [有効化] を選択した場合、次のパラメーターを設定します。
   リクエストパス	ヘルスチェックのHTTP GETパス。 Function Computeは、ヘルスチェックのパスにHTTP GETリクエストを送信します。 値はスラッシュ (/) で始める必要があります。
   最初の検出の遅延	最初のヘルスチェックの前に待つ時間。
   検出間隔	HTTP GETリクエストが送信される間隔。
   タイムアウト期間	HTTP GETリクエストのタイムアウト期間。 タイムアウト期間が経過すると、リクエストは失敗したと見なされます。
   最大失敗	HTTP GETリクエスト失敗の許容最大数。 定期的なヘルスチェック中に指定された値に達すると、関数インスタンスはヘルスチェックに失敗したと見なされます。
   成功した検出のしきい値	HTTP GETリクエストの成功しきい値。 指定された値に達すると、関数インスタンスはヘルスチェックに合格したと見なされます。

手順3: ヘルスチェックの設定の確認

1. 関数の詳細ページで、[コード] タブをクリックし、[関数のテスト] をクリックして、関数が期待どおりに実行できるかどうかを確認します。

   ステップ1のサンプルコードを実行します。 OKが返された場合、関数インスタンスは正常と見なされます。

2. コード内のヘルスチェックパーツを次のコードに置き換え、[コードのデプロイ] をクリックします。 コードがデプロイされたら、もう一度 [Test Function] をクリックして、関数の実行結果を表示します。

   次のコードスニペットは、変更されたコードを示しています。

   app.get('/readyz', (req, res) => {
     console.log(`receive health check`);
     res.status(500);
     console.log(`i am not ready`);
     res.send('i am not ready\n');
   });

   コードを実行すると、関数インスタンスのヘルスチェック結果で500エラーコードが返されます。 関数インスタンスを再度実行すると、次のコードが返されます。

   {
       "RequestId": "1-65081d42-e4895cbc7d6252bda643****",
       "Code": "FunctionNotStarted",
       "Message": "The function http server cannot be started. check function health failed with status code: 500 "
   }

詳細情報