REST API を使用した ESC の正常性のモニタリング
ESC の正常性を監視する REST API は次のとおりです。
GET to https://<esc_vm_ip>:8060/esc/health
(注) |
|
次に、エラー状態のヘルス API のモニタリングの応答を示します。
<?xml version="1.0" encoding="UTF-8" ?>
<esc_health_report>
<status_code>{error status code}</status_code>
<message>{error message}</message>
</esc_health_report>
<?xml version="1.0" encoding="UTF-8" ?>
<esc_health_report>
<status_code>2010</status_code>
<message>ESC service is being provided. ESC AA cluster one or mode node(s) not healthy</message>
<nodes>
<node>
<name>aa-esc-1.novalocal</name>
<status>HEALTHY</status>
<datacenter>dc1</datacenter>
<services>
<service>
<name>escmanager</name>
<status>running</status>
<is_expected>True</is_expected>
</service>
<service>
<name>elector</name>
<status>leader</status>
<is_expected>True</is_expected>
</service>
<service>
<name>drbd</name>
<status>master</status>
<is_expected>True</is_expected>
</service>
<service>
<name>pgsql</name>
<status>running</status>
<is_expected>True</is_expected>
</service>
...
</services>
</node>
<node>
<name>aa-esc-2.novalocal</name>
<status>HEALTHY</status>
<datacenter>dc1</datacenter>
<services>
<service>
<name>escmanager</name>
<status>running</status>
<is_expected>True</is_expected>
</service>
<service>
<name>elector</name>
<status>follower</status>
<is_expected>True</is_expected>
</service>
<service>
<name>drbd</name>
<status>backup</status>
<is_expected>True</is_expected>
</service>
<service>
<name>pgsql</name>
<status>stopped</status>
<is_expected>True</is_expected>
</service>
...
</services>
</node>
<node>
<name>aa-esc-3.novalocal</name>
<status>NOT_HEALTHY</status>
<datacenter>dc1</datacenter>
<services>
<service>
<name>escmanager</name>
<status>stopped</status>
<is_expected>False</is_expected>
</service>
<service>
<name>elector</name>
<status>follower</status>
<is_expected>True</is_expected>
</service>
<service>
<name>vimmanager</name>
<status>running</status>
<is_expected>True</is_expected>
</service>
...
</services>
</node>
</nodes>
</esc_health_report>
XML 応答と JSON 応答は、ヘルス API のモニタリングでもサポートされています。
API 応答が成功すると、 stage という追加のフィールドが導入されます。
<?xml version="1.0" encoding="UTF-8" ?>
<esc_health_report>
<status_code>{success status code}</status_code>
<stage>{Either INIT or READY}</stage>
<message>{success message}</message>
</esc_health_report>
stage フィールドには、INIT パラメータまたは READY パラメータが含まれています。
INIT:INIT パラメータは ESC が設定パラメータの設定や VIM コネクタの登録などの事前プロビジョニング要求を受け入れる初期段階のものです。
READY:ESC は、このパラメータを使用した展開、展開解除などのあらゆるプロビジョニング要求に対応できます。
ESC の正常性の状態が次のステータスコードとメッセージで示されます。2000 シリーズのステータスコードは、ESC が動作していることを意味します。5000 シリーズのステータスコードは、1 つ以上の ESC コンポーネントが稼働していないことを意味します。
(注) |
ESC のヘルス API は VIM のステータスを確認しません。これは、複数 VIM の展開が ESC リリース 3.0 で導入されたためです。 |
ステータス コード |
メッセージ |
||
---|---|---|---|
2000 |
ESC サービスが実行されています。(ESC services are running.) |
||
2010 |
ESC サービスが提供されています。(ESC services are being provided.)ESC AA クラスタの 1 つまたは複数のノードが正常ではありません。(ESC AA cluster one or more node(s) not healthy.) |
||
2020 |
ESC サービスが実行されています。(ESC services are running.)1 つ以上の VIM サービス(Keystone や Nova)に到達できません。(One or more VIM services (for example, keystone and nova) not reachable.)
|
||
2030 |
ESC サービスは実行されていますが、VIM クレデンシャルが指定されていません。(ESC services are running, but VIM credentials are not provided.)
|
||
2040 |
ESC サービスが実行されています。VIM が設定されており、ESC が VIM への接続を初期化しています。(ESC services running. VIM is configured, ESC initializing connection to VIM.) |
||
2100 |
ESC サービスは実行されていますが、ESC ハイアベイラビリティノードに到達できません。1 つ以上の VIM サービス(Nova など)に到達できません。(ESC services are running, but ESC High-Availability node is not reachable. One or more VIM services ( for example, nova ) are not reachable.)
|
||
5010 |
ESC サービス、ESC_MANAGER が実行されていません。(ESC service, ESC_MANAGER is not running.) |
||
5020 |
ESC サービス、CONFD が実行されていません。(ESC service, CONFD is not running.) |
||
5030 |
ESC サービス、MONA が実行されていません。(ESC service, MONA is not running.) |
||
5040 |
ESC サービス、VIM_MANAGER が実行されていません。(ESC service, VIM_MANAGER is not running.) |
||
5090 |
複数の ESC サービス(ConfD や Mona など)が実行されていません。(More than one ESC service (for example, confd and mona) are not running.) |
ステータス コード |
メッセージ |
---|---|
2000 |
ESC サービスが実行されています(アクティブ/アクティブセットアップ)。(ESC services are running (Active-Active setup).) |
2010 |
ESC サービスが提供されています。(ESC services are provided.)ESC アクティブ/アクティブクラスタの 1 つまたは複数のノードが正常ではありません。(In ESC Active/Active cluster one or more node(s) are not healthy.) |
5000 |
ESC サービスが提供されていません。ESC AA クラスタが正常ではありません(ESC services not being provided, ESC AA cluster not healthy) |
(注) |
ESC HA モードでは、DRBD セットアップでのみ ESC HA を参照します。ESC HA セットアップの詳細については、『Cisco Elastic Services Controller Install Guide』を参照してください。 |
次の表では、スタンドアロン ESC のステータスメッセージと、成功シナリオと障害シナリオの HA について説明します。ESC のスタンドアロンおよび HA のセットアップの詳細については、『Cisco Elastic Services Controller Install Guide』を参照してください。
Success |
Partial Success |
Failure |
|||||
---|---|---|---|---|---|---|---|
スタンドアロン Esc |
応答はヘルス API のモニタリングから収集され、ステータスコードは 2000 になります。 |
NA |
|
||||
HA の ESC(アクティブ/スタンバイ) |
応答はヘルス API のモニタリングから収集され、ステータスコードは 2000 になります。 |
応答はヘルス API のモニタリングから収集され、ステータスコードは 2010 になります。これは、ESC スタンバイノードが ESC HA の ESC マスターノードに接続できないことを示します。ただし、これはノースバウンドへの ESC サービスには影響しません。 |
|
||||
HA(アクティブ/アクティブ)のESC |
応答はヘルス API のモニタリングから収集され、ステータスコードは 2000 になります。 |
応答はヘルス API のモニタリングから収集され、ステータスコードは 2010 になります。この状態は、ESC サービスは提供されているが、ESC AA クラスタ内の 1 つまたは複数のノードが正常ではないことを示します。ただし、これはノースバウンドへの ESC サービスには影響しません。 |
|