このページでは、Linux 上または Docker コンテナ内で直接実行する自己管理型 mongot 配置で最も一般的な問題と、ステップバイステップの復旧手順について説明します。各シナリオでは、故障モードが既に識別されており、それを解決する手順が必要であることを前提としています。
注意
配置スコープ
このページは、Linux tarball インストールや Docker コンテナなど、直接実行する mongot 配置に適用されます。MongoDB Controllers for Kubernetes Operator を使用して mongot を配置する場合は、Kubernetes 固有のトラブルシューティングについては、MongoDB Controllers for Kubernetes Operator ドキュメントを参照してください。
始める前に
シナリオに取り組む前に、配置の現在の状態を確認してください。
メトリクスの異常が発生しているものの、原因がまだ不明な場合は、mongot のメトリクス参照のメトリクス定義と、mongot の推奨アラートのスレッショルドから開始します。
配置または構成の変更を最近完了した場合は、mongot 接続を確認する。から開始してください。
症状がどのシナリオにも一致しない場合は、「サポートの診断の取得」に記述されているようにアーティファクトを取得し、サポートケースを開いてください。
mongot 開始しない
スタート後、mongot プロセスが起動しません。
- 記号
プロセスはスタートアップ後数秒以内に終了します。
コンテナ内では、プロセスがループ内で再起動します。
"ready" ログメッセージは表示されません。
- 一般的な原因
優先順に、
構成ファイルの形式が不正であるか、必要なフィールドが見つかりません。
スタートアップ時に
mongodへの認証が失敗します。mongot構成済みのアドレスでmongodにアクセスできません。TLS 構成エラーが発生します。
構成されたポートはすでに使用されています。
データ パスは書き込み可能ではありません。
- 診断
最新のスタートアップ ログ行を確認します。エラー メッセージは、失敗しているサブシステムを識別します。
docker logs --tail 100 <container-id>journalctl -u mongot --no-pager | tail -n 200tail -n 200 /var/log/mongot/mongot.log次のパターンを探してください。
Failed to parse config file無効な YAML を示します。Exactly one authentication mechanism must be used (x509 or scram)syncSource接続に認証ブロックがないか、2つ以上定義されていることを示します。認証フィールドを単一のscramAuthまたはx509ブロックの下にネストします。mongotの認証と承認の構成を参照してください。Authentication failedまたはUnauthorizedは、認証情報または x.509 のトラストの問題を示します。Connection refusedまたはunable to connect to hostはホストまたはポートが間違っていること、またはmongodが実行されていないことを示します。SSL handshake failedCA トラストまたは証明書 SAN の不一を示します。Address already in use別のプロセスが同じポートにバインドされていることを示しています。Cannot write to <dataPath>は、権限またはパスの問題を示しています。
- 解決
設定: YAML を修正します。有効な設定について学ぶには、mongot の構成を参照してください。エラーが
Exactly one authentication mechanism must be used (x509 or scram)の場合、syncSource認証フィールドを 1 つのscramAuthまたはx509ブロックの下にネストします。参照:mongotの認証と承認の構成。認証: 必要なロールを持つユーザーが
mongod上に存在することを確認します。「mongotの認証と承認の構成 」を参照してください。到達可能性:
mongotホストからnc -zv <mongod-host> <mongod-port>を実行します。ファイアウォール、DNS、mongodbindIp設定を確認します。TLS:
mongotとmongodの両方が同じ認証局 (CA) を信頼していることを確認し、各側の証明書チェーンが信頼できる CA につながるようにします。また、証明書 SAN がmongotが使用するホスト名と一致していることを確認します。「 の TLS 暗号化を構成する。」を参照してください。mongot使用中のポート:
ss -lntpまたはlsof -i :<port>を使用して、衝突するプロセスを特定します。mongotポートを変更するか、他のプロセスを停止します。データ パス: ディレクトリが存在し、
mongotプロセス ユーザーが書き込み可能であることを確認します。必要に応じて所有権と許可を更新します。
接続エラーによるクエリの失敗
mongod が mongot にアクセスできないため、クエリが失敗します。
- 記号
$search、$searchMeta、または$vectorSearchクエリは、Error connecting to <host>:<port> :: Connection refusedのような接続エラーを返します。または、クエリは
Error connecting to Search Index Management serviceを返します。
- 一般的な原因
mongotmongodが接続しようとしているホストで実行されていません。mongotのmongodホストまたはポート設定が間違っており、mongotリスナーと一致しません。mongot実行中であるが、クラッシュしたか、再起動しています。TLS が不一しています。
mongodは TLS に設定されていますが、mongotは設定されていないか、または逆です。
- 診断
mongodホストからmongotへの接続をテストします。nc -zv <mongot-host> <mongot-port>mongotホストから、プロセスが実行され、リッスンしていることを確認してください:ps aux | grep '[m]ongot'ss -lntp | grep <mongot-port>一致するエラーと、構成された
mongotホストのmongodログを調査します。grep -E 'mongotHost|searchIndexManagementHostAndPort' \ /var/log/mongodb/mongod.log- 解決
mongotが実行されていない場合は、再起動します。起動できない場合は、mongot が起動しません。に従ってください。mongotホスト設定が間違っている場合は、mongodパラメータを修正してmongodを再起動します。TLSが一致しない場合は、両側のTLS構成を調整します。「 のTLS暗号化の構成」を参照してください。
mongot
mongot 再同期し続ける
インデックスは安定状態から繰り返し削除され、最初の同期を開始します。
- 記号
ログは
Initial sync startingの後に例外が繰り返されます。安定状態では、ログに
Exception requiring resync occurred during steady state replicationが表示されます。インデックスマネージャーの状態は
INITIAL_SYNCに戻ります。再同期ウィンドウ中に、検索で古い結果が返されます。
- 一般的な原因
mongodoplog がmongotが追いつく前にロールオーバーしました。通常、mongotが速度が遅いか停止しているか、oplog が小さすぎるためです。ネットワークの中断や短時間の
mongod再起動などの一時的な問題により、定常状態の例外が発生しました。1 回の発生は復旧可能ですが、繰り返し発生は復旧できません。ドキュメントマッピングの爆発により
mongotヒープが繰り返し填められ、メモリー不足エラーがトリガーされて再同期が行われます。インデックス データが破損しています。
インデックス、ダイナミックマッピング、または高価なフィールドの選択が多すぎると、レプリケーションラグが持続します。
- 診断
次のメトリクスを確認します。
mongot_replication_mongodb_indexManagerStateINITIAL_SYNCとSTEADY_STATEの間でサイクルします。mongot_index_stats_numLuceneMaxDocs循環しているか、停滞していいます。mongot_index_stats_indexing_replicationLagMs上昇し続けています。mongot_jvm_memory_used_bytesメモリの負荷が増えるとmongot_jvm_gc_pause_seconds_sumが増加します。
再同期に先立つエラーについては
mongotログを参照し、oplog window とヒープを確認します。grep -E 'SteadyStateException|CappedPositionLost|OutOfMemoryError' \ mongot.logmongoshで、mongodoplog サイズをdb.getReplicationInfo()で確認します。- 解決
oplog が
mongot適用レートに対して小さすぎる場合は、mongodoplog サイズを増やすか、mongotキャパシティーを増やすか、同時インデックスの数を減らすことでギャップを埋めます。安定状態の例外が繰り返される場合は、FTDC をキャプチャしてサポート ケースを開いてください。
ドキュメントマッピングの爆発の場合は、通常、任意のキーを持つドキュメントを取り込む
dynamic: trueマッピングを持つインデックスである問題のあるインデックスを検出します。静的マッピングに切り替えるか、フィールドセットを制限して、mongotを再起動してヒープ状態をクリアします。まれであるインデックスの破損の場合は、FTDC を取得した後、影響を受けたインデックスを削除して再作成します。データ パス下のファイルを手動で削除しないでください。
OutOfMemoryエラーまたはOSによってmongotが強制終了されました
mongot メモリが不足して終了します。
- 記号
mongot予期せず終了し、コンテナ再起動回数が増加します。ログは
OutOfMemoryError: Java heap spaceで終わります。これは JVM 側のメモリ不足エラーです。dmesgまたはjournalctlのシステム ログによると、OOM キラーによってプロセスが終了されました。これはホスト側のメモリ不足エラーです。
- 一般的な原因
ヒープは、ワークロードに対して小さすぎます。特に大規模な最初の同期またはマージ中に小さすぎます。
ドキュメント マッピングの爆発によりヒープが消費されます。「mongot の再同期が続く。を参照してください。
コンテナのメモリ上限が低すぎます。ヒープのサイズが正しく設定されている場合でも、JVM の非ヒープオーバーヘッドにより上限を超える可能性があります。
インデックスの数が多すぎる、コストの高い定義など、インデックスの定義が不良であると、メモリの負荷が増加します。
メモリリークが発生します。これはプレビュービルドではまれですが、発生する可能性があります。
- 診断
次のメトリクスを確認します。
mongot_jvm_memory_used_bytesメモリ集中型のクエリとインデックス定義によって増加します。mongot_jvm_gc_pause_seconds_sumガーベージ コレクションの一時停止に要した累積時間を表示します。machine_swap_bytes健全な配置ではほぼゼロになります。スワップ使用量は、メモリの圧力が重大であることを示します。
mongotログでメモリー不足のスタック トレースと構成済みのヒープ サイズを確認します。grep -E 'OutOfMemoryError|Java heap space' mongot.logps -ef | grep '[m]ongot' | grep -oE '\-Xmx[0-9a-zA-Z]+'コンテナの場合は、設定されたメモリリミットを確認します。
docker inspect <container> | grep -i memory- 解決
ホストにメモリのヘッドルームがある場合は、
-Xmxを増やします。コンテナでは、ヒープ以外のオーバーヘッドを収容するため、メモリの制限を
-Xmxよりも大きく設定します。開始点として、コンテナの制限を少なくとも-Xmxの値に 30% を加えた値に設定します。ヒープが十分なサイズであるにもかかわらずメモリが不足する場合は、爆発の原因となるインデックスの作成パターンを探してください。
mongotログにインデックスが識別されます。インデックスの数を減らすか、メモリの負荷の原因となっている場合は、コストの高いインデックス定義を簡素化します。
メモリー リークが疑われる場合は、FTDC とヒープ ダンプを取得してサポートに連絡してください。
最初の同期が遅いまたは停滞している
新しいインデックスは、最初の同期を完了するに時間がかかります。
- 記号
インデックスの状態は長時間
INITIAL_SYNCのままです。レプリケーション マネージャーが最初の同期を再試行する前に
INITIAL_SYNC_BACKOFFに入る場合があります。mongot_index_stats_numLuceneMaxDocsゆっくりとしか増えません。最初の同期の実行中は、インデックスはクエリできません。
- 一般的な原因
mongodソース ホストはプロビジョニングが不足しており、最初の同期を十分な速度でフィードできません。その他のディスク、CPU、またはメモリの負荷により、ビルドが低速化します。
大規模な初期バックフィルは、現在のハードウェアエンベロープを超えています。
- 診断
ドキュメントの増加については、
mongot_replication_mongodb_indexManagerStateとmongot_index_stats_numLuceneMaxDocsを監視します。最初の同期中は
mongot_index_stats_indexing_replicationLagMsを正規として扱わないでください。最初の同期中は、このメトリクスに有意なデータが入力されません。その代わりに、システムの健康状態メトリクスを確認して、システムに十分なリソースがあることを確認します。- 解決
ボトルネックである場合は、
mongodソースホストを増やします。システムのリソースが制約されている場合は、CPU またはメモリを追加します。
大規模な初期ビルドを再試行する前に、ディスクのヘッドルームを再度確認してください。
PENDING または BUILDING 状態で停滞しているインデックス
インデックスはPENDINGまたはBUILDING状態から進行しません。
- 記号
インデックスは、大きくないコレクションで
PENDINGまたはBUILDINGの状態で数分以上経過します。mongotログには失敗は表示されていませんが、進行がないことは表示されています。
- 一般的な原因
mongot同期の進行ができていません。「大規模なレプリケーションラグ」を参照してください。自動埋め込みインデックスの埋め込みエンドポイントとなる接続されたデバイスが失敗しています。
インデックスの作成エキゼキューター プールは、同時に作成される他のインデックスによって飽和しています。
mongot最近再起動され、インデックスが追いついています。定義が受け入れられているにもかかわらず、ディスクの負荷により新規ビルドまたはリビルドが一時停止されました。
- 診断
mongot_replication_mongodb_indexManagerStateとmongot_index_stats_numLuceneMaxDocsの進行状況を確認します。mongoshで、インデックスのステータスとエラーフィールドを確認します。db.<collection>.getSearchIndexes()インデックスの作成スループットが増加していることを確認します。
rate(mongot_index_stats_indexing_insert_total[5m])自動埋め込みインデックスの場合は、埋め込みの再試カウンターがゼロより大きいかどうかを確認します。
rate(mongot_indexing_steadyStateChangeStream_rescheduledEmbeddingGetMores_total[5m])rate(mongot_initialsync_queue_requeuedEmbeddingInitialSyncs_total[5m])- 解決
インデックス作成スループットが平坦な場合は、インデックス名と例外について
mongotログを確認してください。埋め込みの再試行回数が 0 より大きい場合は、埋め込みパスを修正します。MongoDB ベクトル検索 自動埋め込みの
mongotの構成を参照してください。エグゼキュータ プールが飽和している場合は、同時インデックス構築を減らすか、
mongotを増やします。ディスクがボトルネックとなっている場合は、ヘッドルームを追加するか、ビルドをより大きなノードに移動してください。
クエリで空の結果が返される
一致するドキュメントが存在するにもかかわらず、クエリでは結果が返されません。
- 記号
検索インデックスで見つかると予想されるドキュメントに対して
findOne()を実行できます。同じフィールドに対する
$searchクエリは、結果を返さないか、予想より少ない結果を返します。
- 一般的な原因
インデックスは、一致すると予想されるドキュメントの構築が完了していません。
レプリケーションラグとは、
mongotがまだドキュメントを受信していないことを意味します。インデックス定義には、検索するフィールドが含まれていません。
クエリ式が間違っています。たとえば、string としてインデックスされたフィールドに対する数値式などがあります。
特定のドキュメントでインデックスの作成に失敗しました。
- 診断
mongoshでインデックスの状態を確認し、インデックスがドキュメントを見ているかどうかを確認します。db.<collection>.getSearchIndexes()次に、
mongot_index_stats_indexing_replicationLagMsを確認して、レプリケーションラグをチェックします。- 解決
インデックスが準備完了状態になるまで待機します。
レプリケーションラグが解消するまで待ちます。
インデックス定義またはクエリを調整します。
特定のドキュメントでインデックスの作成に失敗した場合、
mongotログに失敗の原因が記載されます。それらのドキュメントを修正またはフィルターします。
CPU の飽和またはスロットリング
CPU の負荷が続くと、クエリとレプリケーションのパフォーマンスが低下します。
- 記号
CPUに持続的な負荷がかかると、クエリのレイテンシが上昇します。
クエリの処理とインデックスの作成がCPUを奪い合うため、レプリケーションラグが増大します。
重大な場合は、ヘルスチェックが失敗し、プロセスが再起動します。
- 一般的な原因
mongotホストは、現在のクエリとインデックスの作成作業の組み合わせに対してプロビジョニングが不足しています。同時に多くのインデックスの作成作業がクエリ実行と競合します。
ワークロードには、ロードシェッディングまたはキャパシティーの拡大が必要です。
- 診断
次のメトリクスを確認します。
mongot_command_searchCommandTotalLatency_seconds_maxmongot_index_stats_indexing_replicationLagMsホスト CPU と負荷メトリクスは、飽和状態になると急増します。
ホストが CPU スロットルされていることを示す明示的なログ メッセージはありません。
- 解決
mongotホストの CPU を増やします。利用可能な場合は、ロードシェッディングの実行によりロードを軽減します。
レプリケーションアクティビティがクエリと競合する場合は、インデックスの作成を簡素化します。
ディスクの負荷またはデータパスがほぼ満杯
mongot データパスの空き容量が少なくなっています。
- 記号
mongotデータ パス上の空き容量がゼロに近づいています。ディスク使用量が多い場合、既存のインデックスにレプリケーションラグが蓄積されます。
ディスクの負荷が重度な場合、新しいインデックスまたは再構築されたインデックスは
INITIAL_SYNCのままになる可能性があります。ディスク保護のためにレプリケーションが一時停止されている間も、クエリは引き続き成功します。
- 一般的な原因
ホストには、通常のインデックス作成の増加に十分な空き容量がありません。
新しいインデックスまたは再構築されたインデックスには、現在のディスクが提供できる一時的なヘッドルームよりも多くのヘッドルームが必要です。
- 診断
次のメトリクスを確認します。
mongot_system_disk_space_data_path_free_bytesデータディレクトリ内の空きバイトを報告します。mongot_system_disk_space_data_path_total_bytesデータディレクトリ内の合計バイト数を報告します。
ディスクのスレッショルに関連するレプリケーションの一時停止の動作に注意してください。ディスク使用量が約 90% を超えるとレプリケーションは停止し、使用量が約 85% を下回った後に再開します。新しいインデックスまたはリビルドの場合、ディスクの負荷が保護スレッショルを既に越えている場合は、定義は受け入れられますが、ビルドは停滞したままになることが予想されます。
- 解決
ホストまたはボリュームを安全に拡張できる場合は、ディスク キャパシティーを追加します。
操作上許容できる場合は、不要なインデックスを削除してスペースを解放します。
大型インデックスをビルドまたは再構築する前に、余計なヘッドルームを確保してください。再構築中は、予想される安定状態のフットプリントの約 125% を見込んでおきます。
ローカル インスタンスストア NVMe では、インプレースでサイズ変更できるとは限りません。ローカル インスタンスストアのキャパシティを超える場合は、通常、より大きなマシン クラスと再インデックスが必要になります。
EBS バックアップされたストレージを使用する場合、ライブリサイズはより実現的ですが、NVMe は
mongotのパフォーマンスにとって推奨されるガイダンスであり続けます。mongotのストレージ クラスの推奨事項を参照してください。
16 MB BSON 制限からのレプリケーションラグ
変更ストリーム イベントが 16 MB BSON 制限を超え、レプリケーションが停滞します。
- 記号
安定状態のレプリケーションエラーの後、インデックスが古くなるか、再構築が開始されます。
mongotログには、getMore中にchange stream payload exceeding 16MB BSON limit、BSONObjectTooLarge、またはエラーコード10334が表示されます。保存されたドキュメントは 16 MB より小さく表示される場合がありますが、失敗は発生します。
- 一般的な原因
変更ストリーム イベントにはドキュメントと追加の変更ストリーム メタデータの両方が含まれているため、16 MB を超えます。
既に大きなドキュメントに大きな更新を行うと、変更ストリームのペイロードは、保存されているドキュメントのサイズだけではなく、より大きくなります。
- 診断
次のメトリクスを確認します。
mongot_changestream_numSplitEvents_total16 MB のペイロードサイズを超えるイベントをカウントします。mongot_index_stats_indexing_replicationLagMs特定のインデックスのレプリケーションラグを報告します。
mongotログで次の文字列を検索します。change stream payload exceeding 16MB BSON limitBSONObjectTooLargeExecutor error during getMorecode 10334
ドキュメント サイズのチェックで最大のドキュメントが16 MB 未満である場合でも、このシナリオを除外しないでください。変更イベントには、ドキュメント自体に加えてメタデータが含まれます。
- 解決
ドキュメントのサイズを小さくし、可能な限り既に大きなドキュメントへの大規模な更新を避けます。
可能な場合は、既存の大規模なドキュメントに大規模な更新を適用するのではなく、ドキュメントを置き換えます。
ほとんどの書き込みが更新である場合は、更新クエリを見直して、変更ストリーム イベント メタデータのサイズを小さくしてください。
ワークロードを修正した後、再構築が完了するまで待ちます。ワークロードパスワードなしが変わらない場合、インデックスは同じ失敗に再び襲われる可能性があります。
ワークロードを調整した後も問題が再発する場合は、ログを取得し、事故の詳細とともにエスカレートします。
大規模なレプリケーションラグ
レプリケーションラグは時間とともに着実に増加します。
- 記号
レプリケーションラグは着実に増加し、何時間もしくは何日もに達する可能性があります。
mongotメモリーの制約を受けるか、または実行を続けるためにメモリー不足が繰り返し発生します。ホストはクエリを引き続き実行できますが、レプリケーション作業と大規模なインデックスのフットプリントにより、クエリのパフォーマンスが低下する可能性があります。
- 一般的な原因
インデックスの数が大きいと、レプリケーションとインデックスの作成のオーバーヘッドが増加します。
dynamic: trueを広範囲で使用すると、フィールド数とインデックスサイズが増加し、メモリーの負荷が増えます。メモリー不足イベントが繰り返し発生すると、遅延が悪化し、メトリクスがぎこちになったり不完全になったりします。
ボトルネックはソースデータベースにあります。CPU とキャッシュの圧力が高いプロビジョニング不足の
mongodセカンダリでは、変更ストリームイベントが十分な速度で発行されない可能性があります。
- 診断
次のメトリクスを確認します。
mongot_index_stats_indexing_replicationLagMs特定のインデックスのレプリケーションラグを報告します。mongot_indexing_steadyStateChangeStream_getMoresScheduledスケジュールされたgetMore操作を報告します。mongot_replication_mongodb_indexManagerStateインデックスが進行していないことを特定します。mongot_jvm_memory_used_bytesまた、ホスト CPU とロードメトリクスにリソースの負荷が表示されています。
インデックスの総数をカウントし、多くが
dynamic: trueに依存しているか、または不要な高カーディナリティフィールドをインデックスしているかを検討します。- 解決
ノードのメモリが不足したり、メモリに制約がある場合は、まず
mongotCPUとメモリを増やします。インデックスの合計数を減らします。インデックスの数が非常に多い場合、変更ストリームの負荷を制御しない限り、検索ノードを追加すると負荷パターンが悪化する可能性があります。
必要ない場所では、ダイナミック スキーマ マッピングをオフにします。
dynamic: falseを使用し、クエリに必要なサブフィールのみを明示的にマップします。インデックス付きフィールドの数を減らします。特に、タイムスタンプやユーザーID などの高濃度フィールドです。また、ファセットに使用されていないディープファセットマッピングを削除します。
mongodセカンダリがボトルネックである場合は、コアデータベースを増やして変更ストリームのスループットを向上させます。
TLS ハンドシェイクの失敗
mongot と mongod の間の TLS ハンドシェイクが失敗します。
- 記号
mongotログにはSSL handshake failed、Certificate verification failed、bad certificateが表示されます。mongodログには、mongotに接続しようとすると同様のエラーが表示されます。
- 一般的な原因
CA の不一致: 両端が同じ CA を信頼していません。
認証 SAN には使用中のホスト名が含まれていません。
証明書の有効期限が切れています。
TLS モードの不一: 一方のサイドで TLS が必要であり、もう一方では無効になっています。
サイファー スイートまたは TLS バージョンの不一致。これはまれです。
- 診断
各サイドが提供する証明書を調査し、CA に対してチェーンを確認します。
openssl s_client -connect <mongot-host>:<mongot-port> -showcertsopenssl s_client -connect <mongod-host>:<mongod-port> -showcertsopenssl verify -CAfile <ca-bundle> <cert-file>openssl x509 -in <cert-file> -text -noout- 解決
正しい CA を両方のエンドポイントとなる接続されたデバイスに配布します。
正しい SAN リストで証明書を再発行します。
期限切れた証明書を更新します。
両側の TLS モードを調整します。「
mongotの TLS 暗号化の構成」を参照してください。
インデックスが Lucene ドキュメント制限に達します
パーティション分割されていない単一の検索インデックスがLuceneの最大ドキュメント数を超えたため、新しいドキュメントをインデックスできなくなりました。
このシナリオは、LinuxまたはDockerコンテナで直接実行するmongot配置に適用されます。MongoDB Controllers for Kubernetes 演算子を使用してmongotを配置する場合は、Kubernetes固有のトラブルシューティングについて、MongoDB Controllers for Kubernetes 演算子のドキュメントを参照してください。
パーティション数を変更する前に、次の点を確認してください。
お使いの
mongotバージョンでは、既存の検索インデックスのnumPartitionsを増やすことができます。置換インデックスの構築中も、既存のインデックスを保持するのに十分な空き容量があります。両方のインデックス世代の一時ストレージを計画してください。
影響を受けたインデックスについて、ベースライン クエリ レイテンシおよびレプリケーション ヘルスを記録しました。
現在のインデックス定義とターゲットの
numPartitions値は把握しています。
インデックスが制限に近づいているものの、まだ正常にインデックスの作成が行われている場合は、インデックスが制限に達する前に手順を開始してください。インデックスがすでに制限に達している場合は、置換インデックスの構築が完了するまで、既存のインデックスが古いままになる可能性があることに注意してください。
- 記号
インデックスは、Luceneのドキュメント数の制限に近づくと、それ以上の進捗を停止します。
ログには
java.lang.IllegalArgumentException: number of documents in the index cannot exceed 2147483519が表示されます。mongot_index_stats_numLuceneMaxDocs上限に近づくか、上限に達した後に進行が停止します。インデックス マネージャーは、失敗状態を報告します。
検索クエリは引き続き結果を返しますが、新しく挿入または更新されたドキュメントはインデックスに反映されません。
- 一般的な原因
パーティション分割されていない単一のインデックスが、Luceneの最大ドキュメント数を超えました。
Lucene は新しいインデックスを受け入れ、ビルドするを開始しますが、ビルドするが完了する前に同じ制限に達し、ビルドは完了しませんでした。
インデックスのパーティション数が、想定されるドキュメント量に対して少なすぎました。
パーティショニングが計画される前にインデックスが制限に達したため、既存のインデックスが古くなる前に置換ビルドするを完了する時間が不足しました。
- 診断
mongoshからインデックスのステータスを確認します。db.<collection>.getSearchIndexes()影響を受けるインデックスの
mongot_index_stats_numLuceneMaxDocsを検討してください。mongotログで次の string を検索します:java.lang.IllegalArgumentException: number of documents in the index cannot exceed 2147483519インデックスマネージャーの状態を確認し、インデックスが
INITIAL_SYNC、STEADY_STATE、または失敗状態のいずれであるかを確認します。mongotデータパスの空き容量を確認してください。パーティショニング操作は置換インデックスをビルドするものであり、一時的に定常状態のインデックスよりも大幅に多くのストレージを必要とする場合があります。変更前に、クエリのレイテンシとレプリケーションラグを検討してください。パーティション化されたインデックスはクエリのファンアウトを引き起こし、検索パフォーマンスに影響を与える可能性があります。特に、ファセット、ソート、またはパーティション間で作業を調整するその他の操作を使用するワークロードでは顕著です。
- 解決
インデックスをパーティション分割して各パーティションがLuceneのドキュメント数制限を下回るようにし、適切な
numPartitions値でインデックスを再構築します。重要
numPartitionsを増やすと、非同期インデックスの再構築が開始されます。インデックス定義を更新しても、新しいパーティション化されたインデックスがすぐにクエリ可能になるわけではありません。パーティション数を選択します。パーティションごとの予測ドキュメント数がLuceneの制限を十分に下回るようなパーティション数を選択してください。将来の成長、まだパージされていない削除済みのドキュメント、再構築の期間、および利用可能なディスクキャパシティーを考慮してください。
計画のガイドラインとして、インデックスが Lucene ドキュメント数の上限である
2147483519ドキュメントに達するずっと前に、パーティショニングの評価を開始します。置き換えをビルドする前に既存のインデックスが古くなってしまう可能性があるため、限界に近いインデックスは緊急に対処する必要があります。注意
パーティションの数を増やすとインデックスのキャパシティーは増加しますが、クエリのレイテンシも増加する可能性があります。変更の前後に、代表的な本番環境のクエリをベンチマークしてください。
インデックス定義を更新します。既存のインデックス定義とより高い
numPartitions値を使用して、updateSearchIndexコマンドを再発行します。インデックス定義の残りの部分は保持します。次の例では、インデックスを1つのパーティションから4つに増やします。
db.runCommand({ updateSearchIndex: "myCollection", name: "mySearchIndex", definition: { mappings: { dynamic: true }, numPartitions: 4 }})このコマンドは定義を更新し、置換ビルドするを開始します。ビルドすることはバックグラウンドで非同期に実行されます。
置換ビルドをモニターします。置換ビルドするが完了するまでインデックスをモニターします。
db.<collection>.getSearchIndexes()でインデックスの状態を確認します。INITIAL_SYNCまたはBUILDINGの間、ドキュメント数が増加し続けていることを確認します。mongot_index_stats_numLuceneMaxDocsをモニターします。mongotデータパスのディスク使用量をモニターします。CPU、メモリ、ストレージのパフォーマンス、およびレプリケーションラグをモニターします。
既存のインデックスが本番トラフィックに勤める間のクエリレイテンシをモニターします。
大規模な置換ビルドするには、かなりの時間がかかる場合があります。最初の同期が進行中の間、新しいインデックスはクエリできません。
受け入れられた
updateSearchIndexコマンドを、インデックスがすでにパーティション分割されていることの証明として扱わないでください。インデックスの状態を確認し、置換ビルドが完了するのを待ちます。
置換インデックスの準備ができたら、クエリのレイテンシを測定します。パーティショニングでは、複数のパーティション間で作業を調整するためにmongotが必要になる場合があり、ファセットを多用するクエリ、ソートされたクエリ、範囲やワイルドカードの述語とソートを組み合わせたクエリなど、一部のワークロードでレイテンシが増加する可能性があります。すべてのワークロードに対して単一のレイテンシ見積もりを使用しないでください。変更の前後に、p50、p95、p99のレイテンシなど、アプリケーションにとって重要なクエリを測定します。
自動埋め込みの失敗
自動埋め込みインデックスは埋め込みエンドポイントに到達できません。
- 記号
Automated Embedding インデックスは
PENDINGまたはBUILDINGにとどまります。mongotログには、埋め込みエンドポイントとなる接続されたデバイスに対するエラーが表示されます。埋め込み再試行カウンタ
mongot_indexing_steadyStateChangeStream_rescheduledEmbeddingGetMores_totalまたはmongot_initialsync_queue_requeuedEmbeddingInitialSyncs_totalがゼロより大きいです。これらのカウンタを間接的な指標として使用し、埋め込みエンドポイントからの実際の HTTP エラーについてはログを確認してください。
- 一般的な原因
モデル API キーが無効です。または有効期限が切れています。
ネットワークが埋め込みエンドポイントに接続できません。
埋め込みプロバイダーはリクエストのレート制限を行っています。
埋め込みプロバイダーで停止時が発生しています。
- 診断
mongotホストから埋め込みエンドポイントへの接続をテストし、ログを確認します。grep -E 'voyage|embedding' mongot.log- 解決
モデル API キーを置き換えて
mongotを再起動します。埋め込みエンドポイントへのオープンネットワークイーグレス。
プロバイダーがリクエストのレート制限を行っている場合は、制限を引き上げるか、インデックスの作成の同時実行数を減らします。
プロバイダーに停止が発生した場合は、Voyage AI ステータス をモニターし、エンドポイントの切り替えを検討してください。
全体の埋め込み構成モデルについては、MongoDB ベクトル検索の自動埋め込みの
mongotを構成するを参照してください。
持続的な IOPS やページフォールトなどのストレージシグナル
持続的なストレージ IOPS またはページフォルトは、ストレージのボトルネックを示します。ローカル NVMe で実行する場合は、まずメモリヘッドルームを確認してください。SAN、クラウドの多目的 SSD、SATA SSD などのその他のストレージ クラスで実行する場合、ストレージ クラスが根本的な原因である可能性が高く、移行が必要です。詳細については、「mongot のストレージ クラスの推奨事項」を参照してください。
明確な原因なしに性能が低下します
最近の配置変更なしでパフォーマンスが劣化する。
- 記号
配置の変更が明らかでないのに、クエリのレイテンシが上昇しました。
CPU またはメモリの使用量が増加しました。
- 一般的な原因
ワークロードが変更され、より多くまたはより大きなクエリが増えました。
新しいインデックスでリソースが消費されるようになりました。
ドキュメント マッピングの暴発によりヒープが消費されます。
ストレージの劣化。たとえば、ノイジーネイバー、RAID の再構築、またはクラウドプロバイダーの問題など。
JVM の更新後、ガーベージ コレクションのチューニングに回帰が発生しました。
- 診断
- クエリのレイテンシ、ヒープ、エクゼキューター キュー、ストレージ IOPS などの症状によってメトリクスをピボットします。メトリクスの定義としきい値については、mongot のメトリクス参照 および mongot の推奨アラート を参照してください。
- 解決
- 解決策は根本原因によって異なります。選択肢には、拡大、キャパシティー計画、またはインデックスの検討があります。これには、未使用インデックスの削除やマッピングの改善などが含まれます。
サポートの診断をキャプチャする
問題をローカルで解決できない場合は、サポート ケースを開く前に次の情報を取得します。
mongot問題の発生時間帯とその 1 時間前を含むログ。同じウィンドウのmongodログを転送します。影響を受ける
mongotインスタンスの FTDC。「mongot ログと FTDC」を参照してください。問題の時間内のメトリクスのダッシュボード スナップショット。
mongotおよびmongodのバージョン。最近の配置、構成の変更、またはトラフィック パターンなど、変更された内容。
オンデマンドで再現できる場合は、問題を再現する手順。