AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

Get Host API を介してレプリケーションの状態を読み取る

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 があります。パスは、 /api/public/v2.0の下の v 1.0と同じです。

新しい分野

tooStale ホストドキュメントではlastReplErrorとなります。

既存のエンドポイント

v 1.0は変更されていません。これには、Admin API のホストエンドポイントも含まれます。

  • デプロイメントでは、Ops Manager 8.0.28または9.0.2以降のバージョンが実行されている必要があります。

  • プロジェクトでは監視機能を有効にする必要があります。監視機能が無効になっている場合、Ops Manager は新しいフィールドを省略します。

  • リクエストのベースパスを/api/public/v1.0から/api/public/v2.0に変更してください。各リクエストのその他の部分は変更されません。

1

ホストの一覧を表示するには、 v 2.0 Get All Hostsを使用するか、既に知っているhostname:portを使用してください。

2
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET "https://<OpsManagerHost>:<Port>/api/public/v2.0/groups/{GROUP-ID}/hosts/byName/{HOSTNAME-PORT}?pretty=true"
3
{ "hostname": "node1.example.com", "port": 27017, "replicaSetName": "rs0", "replicaStateName": "RECOVERING", "tooStale": true, "lastReplError": "error RS102 too stale to catch up"}

この文書は簡潔にするために一部省略されています。Ops Managerは完全なホスト文書を返します。

名前
タイプ
説明

古すぎる

ブール値

メンバーがoplogウィンドウから遅れてしまい、レプリカセットからの同期も追いつけませんでした。メンバーには初期同期が必要です。

lastReplError

string

メンバーの最後のレプリケーションエラー、 rs.status()から。

以下の表は、Ops Managerが特定のシナリオにおいて新しいフィールドをどのように入力するかを示しています。

Scenario
動作

ホストは健康なレプリカセットメンバーです

tooStale falseです。 lastReplErrorは省略されています。

メンバーはoplogウィンドウの背後にいます

tooStale trueです。 lastReplError mongodのメッセージを伝達します。

ホストはレプリカセットのメンバーではありません

両方のフィールドが省略されています。

リクエストは av 1.0エンドポイントを使用します

両方のフィールドが省略されています。

すべてのホストの取得

各ホストは、レプリカセットの値ではなく、自身のメンバーの値を報告します。

どちらのフィールドも、応答に含まれる単一のホストについて記述しており、レプリカセット全体については記述していません。

次の表は、v 2.0 Get Host エンドポイントを使用する際に発生する一般的なエラーと症状について説明しています。

シンボリック
考えられる原因
解決法

404 av 2.0エンドポイントから

ベースパスが/api/public/v1.0であるか、ホストがプロジェクトに含まれていません。

tooStale およびlastReplErrorが欠落しています

ホストがレプリカセットのメンバーではないか、監視が無効になっているか、またはav 1.0エンドポイントを呼び出しました。

ホストがレプリカ セットに属していること、監視が有効になっていること、およびパスが v 2.0を使用していることを確認します。

lastReplError が欠落していますが、 tooStaleは存在します

メンバーはレプリケーションエラーを報告していません。

何もする必要はありません。

404 HOST_NOT_FOUND

HOST-ID または、 HOSTNAME-PORTプロジェクト内のホストと一致しません。

レプリケーションの状態をプログラムで読み取るには、 「レプリケーションの状態を持つホストを取得する」を参照してください。