このドキュメントでは、SHA モニターの基本的な概念について説明します。これは、NSX 4.2 のシステム健全性エージェント (SHA) フレームワークで導入されたコンポーネントです。
SHA は、NSX の分散システム健全性エージェントです。このフレームワークは、ESXi ホスト、ベアメタル サーバ、NSX Edge、NSX Manager アプライアンスなど、さまざまな NSX コンポーネントの統計情報(メトリック)を監視します。SHA は、コンポーネント統計情報を監視および分析し、異常をアラートし、特定の条件が満たされたときに修正アクションをトリガします。
NSX 4.2 より前のバージョンでは、コンポーネント統計情報(メトリック)の収集を制御するために、NSX ユーザーは 2 段階のプロセスに従う必要がありました。まず、統計情報と SHA プラグイン間のマッピングを決定する必要がありました。つまり、どの SHA プラグインがどの統計情報を制御するかを判断し、次に SHA プラグイン プロファイルを使用して統計情報の収集を制御する必要がありました。SHA プラグイン プロファイルは、主にコードにアクセスでき、どの SHA プラグイン プロファイルをどの統計情報に合わせて調整する必要があるかを判断できる開発者を対象としています。
SHA フレームワークにモニター コンポーネントが導入されたことで、プロセスが簡素化されました。
- モニター
-
モニターは、システムの健全性に関するさまざまな統計情報(メトリック)を監視し、対応するアクションを実行する SHA フレームワークのコンポーネントです。たとえば、ユーザーがシステムの健全性を表示するための統計情報を宛先にエクスポートし、ユーザーに通知するアラームをトリガし、オフライン分析のために統計情報をファイルにダンプします。以前の NSX リリースで導入された SHA プラグインは、モニターによって置き換えられます。モニターは統計の詳細な説明を提供し、各統計の目的と、必要に応じてモニターを制御する方法をユーザーが把握できるようにします。
たとえば、
esx-obsrv-stats-monitor
には、ESXi ホスト トランスポート ノードから収集されるすべての可観測性統計情報の説明が含まれています。現在、モニターは単一の宛先 (NSX Manager) への統計情報のエクスポートをサポートしています。
- モニター プロファイル
-
モニター プロファイルは、一連のプロパティを構成してモニターを制御するのに役立ちます。
たとえば、モニター プロファイルの一部の構成プロパティは次のとおりです。
- enable
- check_interval
- applied_to_group_paths
ここには、いくつかの構成プロパティのみが表示されます。モニター プロファイル内のすべての構成プロパティについては、次の『NSX API ガイド』の SHA モニター プロファイルのスキーマを参照してください。
GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/<monitor-id>/profiles/<profile-id>
モニターおよびモニター プロファイルには、NSX API でのみアクセスできます。現在、これらのコンポーネントは NSX Manager ユーザー インターフェイスでは公開されていません。
すべてのモニター ID のリストを取得するには、次の API を使用します。
GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors
特定のモニターのすべてのプロファイルのリストを取得するには、次の API を使用します。
GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/<monitor-id>/profiles
注: マルチテナント NSX 環境では、プロジェクトおよび NSX VPC のユーザーは、モニターおよび監視プロファイル API を使用できません。これらの API は現在、デフォルト領域のユーザーのみが使用できます。各モニターには、システムが作成したデフォルト プロファイルがあります。たとえば、
esx-obsrv-stats-monitor
のデフォルト プロファイルは、このモニターが実行されているシステム内のすべてのホスト トランスポート ノードに適用されます。デフォルト プロファイルの構成を更新すると、変更はすべてのノードに影響します。デフォルト プロファイルは削除できません。ユーザー定義(カスタム)プロファイルを作成して、ホスト トランスポート ノードの特定のグループのデフォルト プロファイルを上書きできます。ホスト トランスポート ノードのモニターに複数のプロファイルが適用されている場合、最後に適用されたプロファイルは他のプロファイルを上書きします。デフォルトのプロファイルの優先順位は最も低くなります。
モニターのデフォルト プロファイルまたはカスタム プロファイルのどちらを構成しているかに関係なく、プロファイル内の特定のプロパティは編集できません。
次はその例です。esx-obsrv-stats-monitor
のデフォルト プロファイルは、システムが作成したデフォルト グループに適用されます。このグループには、システム内のすべてのホスト トランスポート ノードが含まれます。デフォルト プロファイルの applied_to_group_paths プロパティは編集できません。- プロファイルの enable プロパティを false に設定して、
esx-obsrv-alarms-monitor
を無効にすることはできません。このモニターはシステム内のアラームを報告し、常に有効になります。
モニターのタイプ
SHA フレームワークには、2 つの主なタイプのモニターが含まれています。
- メトリック エクスポータ モニター
-
これらのモニターは、メトリック(統計情報)を宛先(NSX Manager など)にエクスポートするために使用されます。たとえば、
esx-obsrv-stats-monitor
です。メトリック エクスポータ モニターの場合、システムは 1 つのユーザー定義(カスタム)プロファイルのみをサポートします。
- 標準モニター
-
これらのモニターは、NSX Manager へのアラームのレポート、ファイルへの統計情報のダンプなど、メトリックのエクスポートを除くその他のタスクを実行するために使用されます。たとえば、
です。esx-obsrv-alarms-monitor
,esx-obsrv-segment-stats-file-dump-monitor
標準モニターの場合、作成できるユーザー定義(カスタム)プロファイルの数に制限はありません。
モニターは、それが制御する統計情報(メトリック)の高レベルのカテゴリを定義します。モニター内の統計情報は、複数のサブカテゴリに分類されます。サブモニターは、個々のサブカテゴリを制御するように定義されます。デフォルトでは、親モニター用に定義された構成は、親モニターのすべてのサブモニターに適用されます。必要に応じて、サブモニターの構成を編集できます。
次はその例です。
esx-obsrv-stats-monitor
は、メトリック エクスポータ タイプのモニターです。これには、esx-obsrv-datapath-traffic-stats-monitor
および esx-obsrv-datapath-infra-stats-monitor
と呼ばれるメトリック エクスポータ タイプの 2 つのサブモニターが含まれています。
複数のサブモニターを持つモニターで統計情報を分類する利点は、すべてのサブモニターを親モニターと一緒に制御できることです。個々のサブモニターのプロパティを構成するために、個別の API 呼び出しを実行する必要はありません。