Ops Manager API を使用すると、レプリカ セット メンバーが同期に追いつけないほど遅延しているかどうかを判断できます。また、そのメンバーの最後のレプリケーション エラーを読み取ることもできます。
Ops Manager はホスト ドキュメントにtooStaleとlastReplError 2 つのフィールドを追加し、3 つの Get Host エンドポイントの新しいバージョンv 2.0からそれらを返します。v 1.0エンドポイントは変更されておらず、新しいフィールドは返されません。
これらのエンドポイントを呼び出すには、 Project Read Onlyロールが必要です。
新機能
Item | 詳細 |
|---|---|
新しいエンドポイント | v 2.0バージョンには、 Get One Host by ID 、 Get One Host by Hostname and Port 、 Get All Hosts があります。パスは、 |
新しい分野 |
|
既存のエンドポイント | v 1.0は変更されていません。これには、Admin API のホストエンドポイントも含まれます。 |
始める前に
デプロイメントでは、Ops Manager 8.0.28または9.0.2以降のバージョンが実行されている必要があります。
プロジェクトでは監視機能を有効にする必要があります。監視機能が無効になっている場合、Ops Manager は新しいフィールドを省略します。
リクエストのベースパスを
/api/public/v1.0から/api/public/v2.0に変更してください。各リクエストのその他の部分は変更されません。
メンバーのレプリケーション状態を確認する
ホストを見つけてください。
ホストの一覧を表示するには、 v 2.0 Get All Hostsを使用するか、既に知っているhostname:portを使用してください。
新しいフィールド
名前 | タイプ | 説明 |
|---|---|---|
古すぎる | ブール値 | メンバーがoplogウィンドウから遅れてしまい、レプリカセットからの同期も追いつけませんでした。メンバーには初期同期が必要です。 |
lastReplError | string | メンバーの最後のレプリケーションエラー、 |
現場の挙動
以下の表は、Ops Managerが特定のシナリオにおいて新しいフィールドをどのように入力するかを示しています。
Scenario | 動作 |
|---|---|
ホストは健康なレプリカセットメンバーです |
|
メンバーはoplogウィンドウの背後にいます |
|
ホストはレプリカセットのメンバーではありません | 両方のフィールドが省略されています。 |
リクエストは av 1.0エンドポイントを使用します | 両方のフィールドが省略されています。 |
すべてのホストの取得 | 各ホストは、レプリカセットの値ではなく、自身のメンバーの値を報告します。 |
どちらのフィールドも、応答に含まれる単一のホストについて記述しており、レプリカセット全体については記述していません。
トラブルシューティング
次の表は、v 2.0 Get Host エンドポイントを使用する際に発生する一般的なエラーと症状について説明しています。
シンボリック | 考えられる原因 | 解決法 |
|---|---|---|
| ベースパスが |
|
| ホストがレプリカセットのメンバーではないか、監視が無効になっているか、またはav 1.0エンドポイントを呼び出しました。 | ホストがレプリカ セットに属していること、監視が有効になっていること、およびパスが v 2.0を使用していることを確認します。 |
| メンバーはレプリケーションエラーを報告していません。 | 何もする必要はありません。 |
|
|
APIの使用
レプリケーションの状態をプログラムで読み取るには、 「レプリケーションの状態を持つホストを取得する」を参照してください。