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

mongot 接続を確認します

このページのチュートリアルを使用して、mongot 配置がアクティブであり、MongoDB Community 配置に接続されていることを確認します。

MongoDB Community と MongoDB Search をインストールします。インストールのチュートリアルについては、MongoDB Community Edition のインストール手順を参照してください。

1

mongotインスタンスの状態を確認するには、インストール方法に応じて、ターミナルで次のいずれかのコマンドを実行します。

ps aux | grep '[m]ongot'

mongotがアクティブな場合、このコマンドは、構成ファイルへの参照とともにmongotプロセスを返します。

# standalone mongot container
docker ps --filter "name=<mongot-container-name>"
# atlas-local
docker ps --filter "ancestor=mongodb/mongodb-atlas-local"

mongot がアクティブな場合、このコマンドはアクティブなコンテナを返します。

2

mongot インスタンスの状態を確認するには、/health/ready エンドポイントを使用します。

mongot がライブであるかどうかを確認するには、/health エンドポイントとなる接続されたデバイスに対して curl を実行します。

注意

デフォルトの healthCheck アドレスは localhost:8080 です。ただし、mongot 構成ファイルの healthCheck.address オプションでアドレスを定義できます。

curl localhost:8080/health

エンドポイントは、応答として次のいずれかを返します。

  • {"status":"SERVING"}, mongot プロセスが実行中の場合。

  • {"status":"NOT_SERVING"}, mongot プロセスが実行中でない場合。

mongotがクエリに対して準備できているかどうかを確認するには、/ready エンドポイントに対して curlします。

curl localhost:8080/ready

エンドポイントは、応答として次のいずれかを返します。

  • {"status":"SERVING"}, mongot プロセスがクエリに対応できる状態にある場合。

  • {"status":"NOT_SERVING"}, mongot プロセスがクエリに対応できない場合。

3

mongot 構成ファイルで Prometheus メトリクス エンドポイントを有効にした場合は、curl/metrics エンドポイントを使用してプロセス レベルのメトリクスを取得します。

curl localhost:9946/metrics

注意

デフォルトの metrics アドレスは localhost:9946 です。別のアドレスを使用するには、mongot 構成ファイルで metrics.address オプションを設定します。

検索インデックスのレプリケーションの状態を表示するには、mongot_replication_mongodb_indexManagerState メトリクスをフィルターします。

curl -s localhost:9946/metrics | grep -E \
"^(# (HELP|TYPE) mongot_replication_mongodb_indexManagerState|mongot_replication_mongodb_indexManagerState)"
4

インデックスのマネジメントが有効になっていることを確認するには、いずれかのコレクションに対して検索インデックスマネジメントメソッドを実行する。

例えば、次のコマンドは、movies コレクションに検索インデックスが存在するかどうかを確認します。

db.movies.getSearchIndexes()

操作がエラーなく成功する場合、インデックスのマネジメントは機能します。

5

エンドツーエンド検索クエリを実行して、クエリパス全体が機能することを確認します。

例:検索インデックスを使用して test コレクションを作成します。

db.test.insertMany([
{ name: "alpha" },
{ name: "beta" },
{ name: "alphabet" }
])
db.test.createSearchIndex(
"verify-index",
{ mappings: { dynamic: true } }
)

MongoDB がインデックスをビルドしていることを確認します。

db.test.getSearchIndexes()

コマンドが次の応答を返す場合、インデックスはクエリに対して準備できています。

status: 'READY',
queryable: true,

次に、検索クエリを実行します。

db.test.aggregate([
{
$search: {
index: "verify-index",
text: { query: "alpha", path: "name" }
}
}
])

クエリが成功すると、mongodmongot が正しく構成されていることが確認されます。

mongotmongod の接続のトラブルシューティングについては、「 自己管理型配置の MongoDB Search のトラブルシューティング」を参照してください。