ネットワーク・ロード・バランサ・ヘルス・チェック
ネットワーク・ロード・バランサ(NLB)バックエンド・セットのヘルス・チェックは、NLBバックエンド・サーバーの可用性を確認するテストです。 ヘルス・チェックは、リクエストまたは接続試行です。 NLBは、構成された時間間隔に基づいてヘルス・チェック・ポリシーを適用し、バックエンド・サーバー・セットをモニターします。 サーバーがヘルス・チェックに失敗すると、NLBは一時的にそのサーバーをバランシング・ローテーションから除外します。 後でサーバーが後続のヘルス・チェックを通過すると、NLBはバックエンド・サーバーをバランシング・ローテーションに戻します。
指定したバックエンド・セット・サーバーのヘルス・ステータスは、プライマリおよびスタンバイのネットワーク・ロード・バランサによってレポートされます。
NLBに関する一般的な情報については、「Oracle Private Cloud Appliance概要ガイド」を参照してください。
すべてのネットワーク・ロード・バランサのヘルス・チェッカ・ステータスの表示
ネットワーク・ロード・バランサ(NLB)バックエンド・セットのヘルス・ステータス・インジケータを表示して、ネットワーク・ロード・バランサとそのリソースの一般的なヘルスに関するレポートを作成できます。
NLBは、健全性検査ポリシーを使用して、NLBとそのコンポーネントの一般的な健全性を報告する健全性ステータス・インジケータを提供します。 ヘルス・ステータス・インジケータおよびサマリーは、NLB、バックエンド・セットおよびバックエンド・サーバーに表示されます。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。
-
ヘルス・チェッカ・ステータスを表示するNLBの名前をクリックします。
OCI CLIの使用
-
コマンドを実行するために必要な情報を収集します:
-
コンパートメントOCID (
oci iam compartment list --compartment-id-in-subtree true
)
-
-
network-load-balancer list
コマンドを実行します。このコマンドは、コンパートメント内のすべてのNLBのステータスをリストします。ノート:
オプションのパラメータについては、
--help
オプションを指定してコマンドを実行します。構文(1行に入力):
oci nlb network-load-balancer-health list --compartment-id compartment_OCID \ [OPTIONS]
[OPTIONS]は、次のとおりです:
- --all結果のすべてのページをフェッチします。 このオプションを指定する場合、--limitオプションは指定できません。
- --from-json [text] file://path-to/file構文を使用して、このコマンドへの入力をファイルからJSONドキュメントとして指定します。
- --limit [integer]リストのページ区切り。 ページ区切り「リスト」コールでの1ページ当たりの結果または返されるアイテムの最大数。
- --page [text]結果の取得を開始するページを表すページ・トークン。
- --page-size [integer]結果をフェッチする場合、コールごとにフェッチする結果の数。 --allまたは--limitとともに使用した場合にのみ有効で、それ以外の場合は無視されます。
- --sort-by [text]ソート基準となるフィールド。 指定できるソート順は1つのみです。 timeCreatedのデフォルトの順序は降順です。 displayNameのデフォルトの順序は昇順です。 値を指定しない場合、timeCreatedがデフォルトになります。 受け入れられる値は次のとおりです: displayName, timeCreated.
- --sort-order [text]使用するソート順。'asc' (昇順)または'desc' (降順)のいずれか。 受け入れられる値は次のとおりです: ASC, DESC.
例:
$ oci nlb network-load-balancer-health list --compartment-id ocid1.tenancy....â¦.â¦.â¦.uniqueID { "data": { "items": [ { "network-load-balancer-id": "ocid1.networkloadbalancer....â¦.â¦.â¦.uniqueID2", "status": "UNKNOWN" }, { "network-load-balancer-id": "ocid1.networkloadbalancer....â¦.â¦.â¦.uniqueID1", "status": "OK" } ] } }
$ oci nlb network-load-balancer-health list --compartment-id ocid1.tenancy....â¦.â¦.â¦.uniqueID \ --sort-order ASC { "data": { "items": [ { "network-load-balancer-id": "ocid1.networkloadbalancer....â¦.â¦.â¦.uniqueID1", "status": "OK" }, { "network-load-balancer-id": "ocid1.networkloadbalancer....â¦.â¦.â¦.uniqueID2", "status": "UNKNOWN" } ] } }
ネットワーク・ロード・バランサのヘルス・チェッカ・ステータスの表示
既存のネットワーク・ロード・バランサ(NLB)内のバックエンド・サーバーのヘルスのステータス(OK、警告、クリティカル、不明)を表示できます。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。
-
既存のロード・バランサ・バックエンド・セットのヘルス・パラメータを表示するNLBの名前をクリックします。
-
「リソース」で、「バックエンド・セット」をクリックします。
- バックエンド・セットの名前をクリックして、「OK」や「クリティカル」などのヘルス・チェックの詳細を表示します。
OCI CLIの使用
-
コマンドを実行するために必要な情報を収集します:
-
コンパートメントOCID (
oci iam compartment list --compartment-id-in-subtree true
) -
NLB OCID (
oci nlb network-load-balancer list --compartment-id compartment_OCID
)
-
-
network-load-balancer-health getコマンドを実行します。
NLB OCIDを使用して、指定したコンパートメント内のNLBの詳細をリストします。
ノート:
オプションのパラメータについては、
--help
オプションを指定してコマンドを実行します。構文(1行に入力):
$ oci nlb network-load-balancer-health get --network-load-balancer-id \ network-load-balancer_OCID
説明:
• network-load-balancer_OCIDは、バックエンド・セットに関連付けられたネットワーク・ロード・バランサのOCIDです。
例:
$ oci nlb network-load-balancer-health get --network-load-balancer-id \ ocid1.networkloadbalancer....â¦.â¦.â¦.uniqueID { "data": { "critical-state-backend-names": [], "status": "OK", "total-backend-count": 2, "unknown-state-backend-names": [], "warning-state-backend-names": [] } }
ネットワーク・ロード・バランサ・ヘルス・チェッカ・ポリシーの表示
ネットワーク・ロード・バランサ(NLB)によって使用されるヘルス・チェッカ・ポリシー・パラメータを表示して、バックエンド・セットのヘルスを確認できます。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。
-
ヒース・チェック・ポリシーを表示するNLBの名前をクリックします。
-
「リソース」で、「バックエンド・セット」をクリックします。
-
バックエンド・セットのヘルス・チェック・パラメータを表示するには、次を実行します:
- 「アクション」列(3つのドット)プルダウン・メニューの下の「詳細の表示」をクリックします。
- バックエンド・セットをクリックして、その詳細を確認します。
-
「バックエンド・セットの詳細」ページで、ヘルス・チェック・ポリシーを表示するバックエンド・セット名の下にある「バックエンド・セット構成」をクリックします。
OCI CLIの使用
-
コマンドを実行するために必要な情報を収集します:
-
コンパートメントOCID (
oci iam compartment list --compartment-id-in-subtree true
) -
NLB OCID (
oci nlb network-load-balancer list --compartment-id compartment_OCID
)
-
-
ヘルス・チェッカ
get
コマンドを実行し、health-checker
パラメータを表示します。NLB OCIDを使用して、指定したコンパートメントのバックエンド・セット・ヘルス・チェッカ・ポリシーの詳細をリストします。
ノート:
オプションのパラメータについては、
--help
オプションを指定してコマンドを実行します。構文(1行に入力):
oci nlb health-checker get --backend-set-name backend-set-name-text \ --network-load-balancer-id network-load-balancer_OCID
説明:
• backend-set-nameは、バックエンド・セットに固有の名前です。
• network-load-balancer_OCIDは、バックエンド・セットに関連付けられたロード・バランサのOCIDです。
例:
$ oci nlb health-checker get --backend-set-name BckEndSet \ --network-load-balancer-id ocid1.networkloadbalancer.. . .unique-id { "data": { "health-checker": { "interval-in-millis": 10000, "port": 22, "protocol": "TCP", "request-data": null, "response-body-regex": ".*", "response-data": null, "retries": 3, "return-code": 200, "timeout-in-millis": 3000, "url-path": "/" }, }, }
ネットワーク・ロード・バランサのヘルス・チェック・パラメータの編集
ネットワーク・ロード・バランサ(NLB)バックエンド・サーバー・セットのヘルス・チェック・プロパティ(ヘルス・チェック間隔など)を変更できます。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。
-
既存のバックエンド・セットのヘルス・チェック・パラメータを編集するNLBの名前をクリックします。
-
「リソース」で、「バックエンド・セット」をクリック
-
バックエンド・セットのヘルス・チェック・パラメータを編集するには:
- 「アクション」列(3つのドット)プルダウン・メニューの下の「編集」をクリックします。
- バックエンド・セットをクリックして詳細を表示し、「編集」をクリックして許容される変更を行います。
-
「保存」をクリックして、変更内容を保存します。
OCI CLIの使用
-
コマンドを実行するために必要な情報を収集します:
-
コンパートメントOCID (
oci iam compartment list --compartment-id-in-subtree true
) -
NLB OCID (
oci nlb network-load-balancer list --compartment-id compartment_OCID
)
-
-
nlb health-checker update
コマンドを実行します。ノート:
オプションのパラメータについては、
--help
オプションを指定してコマンドを実行します。構文(1行に入力):
oci nlb health-checker update --backend-set-name name-of-backend-set \ --interval-in-millis integer-in-millis --max-wait-seconds wait-in-seconds \ --network-load-balancer-id networkloadbalancer_OCID --port port-integer \ --protocol protocol-text --response-body-regex expression-text \ --retries retries-integer --return-code integer \ --timeout-in-millis integer-in-millis --url-path text \ --wait-for-state text --wait-interval-secondx integer
ノート:
「更新」コマンドは、作業リクエストIDを返します。 コマンド結果を表示するには、NLBバックエンド・セットのgetコマンドを使用します。説明:
- name-of-backend-setは、編集するヘルス・チェック・ポリシーに関連付けられたバックエンド・セットの名前です。 例: example_backend_set.
- networkloadbalancer_OCIDは、編集するバックエンド・セットのヘルス・ステータスに関連付けられたネットワーク・ロード・バランサのOCIDです。
オプション:
--from-json [text]は、file://path-to/file構文を使用して、ファイルからJSONドキュメントとしてこのコマンドへの入力を提供します。
--if-match [text]オプティミスティック同時実行性制御は、リソースのPUTまたはDELETEコールで、if-matchパラメータを、そのリソースの以前のGETまたはPOSTレスポンスからのetagの値に設定します。
--interval-in-millis [integer-in-millis]は、ヘルス・チェックの間隔(ミリ秒)です。 例: 10000 (10 seconds).
--max-wait-seconds [wait-in-seconds]は、作業リクエストが--wait-for-stateで定義された状態に達するまで待機する最大時間です。 デフォルトは1200秒です。
--port [port-integer]は、ヘルス・チェックを実行するバックエンド・サーバー・ポートです。 例: 22
--protocol [protocol-text]は、ヘルス・チェックで使用する必要があるプロトコルです。 例: TCP.
--response-body-regex [expression-text]は、バックエンド・サーバーからレスポンス本文を解析するための正規表現です。 例: ^((?!false).|\s)*$
--retries [retries-integer]は、バックエンド・サーバーが異常とみなされるまでに試行する再試行回数です。 サーバーを正常なヘルスにリカバリするときにもこの数が適用されます。 例: 3
--return-code [integer]は、正常なバックエンド・サーバーが戻す必要があるステータス・コードです。 例: 200
--timeout-in-millis [integer-in-millis]は、ヘルス・チェックへの応答を待機する最大時間(ミリ秒)です。 ヘルス・チェックは、このタイムアウト期間内に応答が返された場合にのみ成功します。 例:3000
--url-path [text]は、ヘルス・チェックを実行するパスです。 例: /healthcheck
--wait-for-state [text]は、リソースを非同期で作成、変更または削除し、作業リクエストを使用して操作の進行状況を追跡します。 アクションを実行してから、作業リクエストが特定の状態になるまで待機するには、このオプションを指定します。 受け入れられる値は次のとおりです: ACCEPTED、CANCELED、CANCELING、FAILED、IN_PROGRESS、SUCCEEDED
--wait-interval-seconds [integer]は、すべての--wait-interval-secondsをチェックして、作業リクエストが--wait-for-stateで定義された状態に達したかどうかを確認します。 デフォルトは30秒です。
10000ミリ秒(10秒)の内部でヘルス・チェッカを更新する例:
$ oci nlb health-checker update --backend-set-name PrivTCP_BackEndSet \ --interval-in-millis 10000 --load-balancer-id ocid1.loadbalancer....â¦.â¦.â¦.uniqueID { "opc-work-request-id": "ocid1.workrequest.....â¦.â¦.â¦.uniqueID" }
$ oci nlb backend-set get --backend-set-name PrivTCP_BackEndSet \ --network-load-balancer-id ocid1.loadbalancer.. . .unique-id { "data": { "backends": [ { "ip-address": "10.10.1.2", "is-backup": false, "is-drain": false, "is-offline": false, "name": "nlbserver1", "port": 22, "target-id": "ocid", "weight": 1 }, { "ip-address": "10.10.2.3", "is-backup": false, "is-drain": false, "is-offline": false, "name": "nlbserver4", "port": 22, "target-id": "ocid", "weight": 1 }, ], "health-checker": { "interval-in-millis": 10000, "port": 22, "protocol": "TCP", "request-data": null, "response-body-regex": ".*", "response-data": null, "retries": 3, "return-code": 200, "timeout-in-millis": 3000, "url-path": "/" }, "ip-version": "IPV4", "is-preserve-source": false, "name": "PrivTCP_BackEndSet", "policy": "THREE_TUPLE" }, }
ネットワーク・ロード・バランサ・バックエンド・セットのヘルスの表示
ネットワーク・ロード・バランサ(NLB)のバックエンド・セットのヘルス・ステータスを表示できます。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。
-
バックエンド・セットのヘルス・ステータスを表示するNLBの名前をクリックします。
-
「リソース」で、「バックエンド・セット」をクリック
-
バックエンド・セットをクリックして、NLBのバックエンド・セットのヘルス・ステータスを表示します。
OCI CLIの使用
-
コマンドを実行するために必要な情報を収集します:
-
コンパートメントOCID (
oci iam compartment list --compartment-id-in-subtree true
) -
NLB OCID (
oci nlb network-load-balancer list --compartment-id compartment_OCID
)
-
-
backend-set-health get
コマンドを実行します。ノート:
オプションのパラメータについては、
--help
オプションを指定してコマンドを実行します。構文(1行に入力):
oci nlb backend-set-health get --backend-set-name backend_set_name \ --network-load-balancer-id network-load-balancer_OCID [OPTIONS]
説明:
• backend-set-nameは、バックエンド・セットに固有の名前です。
• network-load-balancer_OCIDは、バックエンド・セットに関連付けられたネットワーク・ロード・バランサのOCIDです。
[OPTIONS]は、次のとおりです:
• --from-json [text] file://path-to/file構文を使用して、このコマンドへの入力をファイルからのJSONドキュメントとして指定します。
例:
$ oci nlb backend-set-health get --backend-set-name PubTCP_BackEndSet_1 \ --network-load-balancer-id ocid1.networkloadbalancer.. . .unique-id { "data": { "critical-state-backend-names": [], "status": "OK", "total-backend-count": 4, "unknown-state-backend-names": [], "warning-state-backend-names": [] }, }
ネットワーク・ロード・バランサ・バックエンド・サーバーのヘルスの表示
ネットワーク・ロード・バランサ(NLB)内のバックエンドのバックエンド・サーバー・ヘルス・ステータスを表示できます。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューを開きます。 「ネットワーキング」で、「ネットワーク・ロード・バランサ」をクリックします。
-
バックエンド・セットのヘルス・ステータスを表示するNLBの名前をクリックします。
-
「リソース」で、「バックエンド・セット」をクリック
-
バックエンド・セットをクリックして、NLBのバックエンドのバックエンド・ヘルス・ステータスを表示します。
OCI CLIの使用
-
コマンドを実行するために必要な情報を収集します:
-
コンパートメントOCID (
oci iam compartment list --compartment-id-in-subtree true
) -
NLB OCID (
oci nlb network-load-balancer list --compartment-id compartment_OCID
)
-
-
backend-health get
コマンドを実行します。ノート:
オプションのパラメータについては、
--help
オプションを指定してコマンドを実行します。構文(1行に入力):
oci nlb backend-health get --backend-name backend_name \ --backend-set-name backend_set_name \ --network-load-balancer-id network-load-balancer_OCID [OPTIONS]
説明:
• backend-nameは、バックエンド固有の名前(10.10.1.13:22など)です。
• backend-set-nameは、バックエンド・セットに固有の名前です。
• network-load-balancer_OCIDは、バックエンド・セットに関連付けられたネットワーク・ロード・バランサのOCIDです。
[OPTIONS]は、次のとおりです:
• --from-json [text] file://path-to/file構文を使用して、このコマンドへの入力をファイルからのJSONドキュメントとして指定します。
例:
$ oci nlb backend-health get --backend-name 10.10.1.13:22 \ --backend-set-name PubTCP_BackEndSet_1 \ --network-load-balancer-id ocid1.networkloadbalancer.. . .unique-id { "data": { "health-check-results": [ { "health-check-status": "OK", "timestamp": "2023-10-04T12:37:54.934773+00:00" }, { "health-check-status": "OK", "timestamp": "2023-10-04T12:37:54.934777+00:00" } ], "status": "OK" }